Listings APIListings API
Oturum aç
POST/api/v4/locations/photos/remove

Bir konumdan fotoğrafları kaldırma

Medya kimliklerini kullanarak bir veya daha fazla medya dosyasının bir konumla ilişkisini kaldırır.

API anahtarı gerektirir. Başlık biçimi ve anahtar yenileme için Kimlik doğrulama bölümüne bakın.

Parametreler

Gövde

AdTürZorunluAçıklama
input.locationIdstringzorunluThe location's Base64-encoded Relay ID the photos belong to.
input.photoIdsarray of stringszorunluMedia file IDs to detach from the location (as returned by the get-photos or upload endpoints).

Örnek istek

Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.

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

Yanıtlar

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.

Medyanın bir konumla ilişkisini kaldırır. Kaldırılacak dosyaları photoIds ile belirtin (get-photos veya yükleme uç noktalarının döndürdüğü kimlikler). Yanıttaki removedCount, kaç dosyanın ilişkisinin gerçekten kaldırıldığını bildirir; böylece zaten kaldırılmış olan kimlikleri tespit edebilirsiniz.

Kullanım senaryosu: güncelliğini yitirmiş mağaza cephesi görsellerini kaldırma. Bir tadilattan sonra konumun fotoğraflarını listeleyin, güncelliğini yitirmiş ek görselleri seçin ve bunları tek bir çağrıyla yayın platformlarından kaldırmak için kimliklerini photoIds içinde iletin.

Kullanım senaryosu: hatalı bir toplu yüklemeyi geri alma. Otomatik bir içe aktarma işlemi yanlış medya dosyalarını ilişkilendirdiyse yükleme yanıtından bu dosyaların medya kimliklerini toplayıp bunları hemen kaldırın, ardından doğru dosyaları yeniden yükleyin.

Dikkat edilmesi gerekenler.

  • API aracılığıyla yalnızca ADDITIONAL kategorisindeki fotoğraflar kaldırılabilir. LOGO ve COVER görselleri buradan silinemez; bunun yerine yükleme uç noktası aracılığıyla bunları değiştirin.
  • Medyayı kaldırmak, medyanın konumla ilişkisini kaldırır; dosyayı hesabın medya kitaplığından tamamen silmesi gerekmez.
  • errors: null ile birlikte removedCount değerinin 0 olması, sağlanan kimliklerin hiçbirinin o konumla ilişkili olmadığı anlamına gelir.
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