Listings APIListings API
Masuk
POST/api/v4/locations/photos/remove

Hapus foto dari lokasi

Melepaskan satu atau beberapa file media dari lokasi berdasarkan ID medianya.

Memerlukan kunci API. Lihat Autentikasi untuk format header dan rotasi kunci.

Parameter

Body

NamaTipeWajibDeskripsi
input.locationIdstringwajibThe location's Base64-encoded Relay ID the photos belong to.
input.photoIdsarray of stringswajibMedia file IDs to detach from the location (as returned by the get-photos or upload endpoints).

Contoh permintaan

Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "photoIds": [      "TWVkaWFGaWxlOjU4Nzg5MzI="    ]  }}

Respons

200Photos removed. `removedCount` reports how many media files were detached.
Response
{  "data": {    "removeLocationPhotos": {      "clientMutationId": null,      "removedCount": 1,      "errors": null    }  }}
401Unauthenticated, missing or invalid API key.

Melepaskan media dari lokasi. Tentukan file yang akan dihapus menggunakan photoIds (ID yang dikembalikan oleh endpoint get-photos atau upload). removedCount dalam respons memberi tahu Anda berapa banyak file yang benar-benar dilepaskan, sehingga Anda dapat mendeteksi ID yang sudah tidak ada.

Kasus penggunaan: hapus gambar tampak depan toko yang sudah usang. Setelah renovasi, ambil daftar foto lokasi, pilih gambar tambahan yang sudah usang, lalu sertakan ID-nya dalam photoIds untuk menghapusnya dari berbagai platform publikasi dalam satu panggilan.

Kasus penggunaan: batalkan unggahan massal yang keliru. Jika impor otomatis melampirkan aset yang salah, kumpulkan ID media yang bermasalah dari respons unggahan dan segera hapus media tersebut, lalu unggah ulang file yang benar.

Hal yang perlu diperhatikan.

  • Hanya foto dalam kategori ADDITIONAL yang dapat dihapus melalui API. Gambar LOGO dan COVER tidak dapat dihapus di sini; sebagai gantinya, ganti gambar tersebut melalui endpoint upload.
  • Menghapus media akan melepaskannya dari lokasi; tindakan ini tidak selalu menghapus file tersebut dari pustaka media akun.
  • removedCount yang bernilai 0 dengan errors: null berarti tidak ada media dengan ID yang diberikan yang terlampir pada lokasi tersebut.
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="      ]    }  }'
Run in playground