POST
/api/v4/locations/photos/removeإزالة الصور من موقع
يفصل ملف وسائط واحدًا أو أكثر عن موقع باستخدام معرّفات الوسائط الخاصة بها.
المعلمات
النص الأساسي
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
| input.locationId | string | مطلوب | The location's Base64-encoded Relay ID the photos belong to. |
| input.photoIds | array of strings | مطلوب | Media file IDs to detach from the location (as returned by the get-photos or upload endpoints). |
مثال على الطلب
نص جاهز للصق. استبدل المعرّفات والقيم النموذجية بقيمك.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "photoIds": [ "TWVkaWFGaWxlOjU4Nzg5MzI=" ] }}الاستجابات
200Photos removed. `removedCount` reports how many media files were detached.
{ "data": { "removeLocationPhotos": { "clientMutationId": null, "removedCount": 1, "errors": null } }}401Unauthenticated, missing or invalid API key.
يفصل الوسائط عن موقع. حدّد الملفات المراد إزالتها باستخدام photoIds (المعرّفات التي تُرجعها نقاط نهاية جلب الصور أو رفعها). يخبرك removedCount في الاستجابة بعدد الملفات التي فُصلت فعليًا، مما يتيح لك اكتشاف المعرّفات التي كانت قد أُزيلت بالفعل.
حالة استخدام: إزالة صور واجهة المتجر القديمة. بعد التجديد، اعرض قائمة بصور الموقع، واختر الصور الإضافية القديمة، ومرّر معرّفاتها في photoIds لإزالتها من منصات النشر باستدعاء واحد.
حالة استخدام: التراجع عن عملية رفع جماعي خاطئة. إذا أرفقت عملية استيراد آلية ملفات غير صحيحة، فاجمع معرّفات الوسائط المعنية من استجابة الرفع وأزلها فورًا، ثم أعد رفع الملفات الصحيحة.
تنبيهات.
- لا يمكن إزالة سوى الصور من الفئة
ADDITIONALعبر API. لا يمكن حذف صورLOGOوCOVERهنا؛ استبدلها عبر نقطة نهاية الرفع بدلًا من ذلك. - تؤدي إزالة الوسائط إلى فصلها عن الموقع؛ ولا تؤدي بالضرورة إلى حذف الملف نهائيًا من مكتبة وسائط الحساب.
- إذا كانت قيمة
removedCountهي0معerrors: null، فهذا يعني أن أيًا من المعرّفات المقدّمة لم يكن مرتبطًا بذلك الموقع.
Request
curl -X POST 'https://listingsapi.com/api/v4/locations/photos/remove' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "photoIds": [ "TWVkaWFGaWxlOjU4Nzg5MzI=" ] } }'