/api/v4/posts/{postId}حذف منشور
يحذف حملة منشورات على وسائل التواصل الاجتماعي نهائيًا ويزيلها من كل منصة نُشرت عليها.
المعلمات
المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| postId | string | مطلوب | Base64-encoded social post ID to delete (the `id` from a posts list or the create response). |
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| clientMutationId | string | اختياري | Optional client-supplied token returned unchanged in the response, for correlating the request. |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "clientMutationId": "delete-44122-req-1"}الاستجابات
200Post deleted. `socialPostId` returns the deleted post's ID.
{ "data": { "deleteSocialPost": { "success": true, "socialPostId": "U29jaWFsUG9zdDo0NDEyMg==" } }}401Unauthenticated, missing or invalid API key.
يحذف حملة المنشورات المحددة. هذا الإجراء نهائي: يُزال المنشور من Listings API ويُلغى نشره على كل منصة وصل إليها (Google وFacebook). يؤدي حذف منشور ظاهر حاليًا إلى إزالته من ملفات التعريف المتصلة؛ ولا يمكن التراجع عن ذلك.
حالة استخدام: سحب إعلان خاطئ. إذا نُشر إعلان يتضمن ساعات عمل خاطئة، فاحذفه باستخدام DELETE /posts/{postId} (باستخدام id من قائمة المنشورات)، وتأكد من success: true، ثم انشر إعلانًا مصححًا باستخدام POST /posts. لإزالة حملة من جميع المتاجر دفعة واحدة، احذف الحملة الجماعية باستخدام معرّفها الجماعي بدلًا من ذلك.
ملاحظات.
- جسم الطلب اختياري. أرسل
clientMutationIdفقط إذا أردت إرجاع القيمة دون تغيير لربط الطلب باستجابته؛ ويتضمن مقتطف الشيفرة المُولَّد هذه القيمة على سبيل المثال. - قد يُظهر المنشور الذي انتهت فترة نشره المجدولة بالفعل
status: EXPIREDولا يعود ظاهرًا على كل منصة، لكن حذفه يظل يزيله من Listings API. - يؤدي حذف منشور محذوف بالفعل أو غير معروف إلى إرجاع استجابة خطأ (
{"data":null,"errors":[...]}) بدلًا منsuccess: true.
عملية كتابة: لم تُنفَّذ على الحساب الفعلي. أُنشئ الطلب والاستجابة المعروضان استنادًا إلى مخطط API.
curl -X DELETE 'https://listingsapi.com/api/v4/posts/<postId>' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "clientMutationId": "delete-44122-req-1" }'