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

Rimuovi foto da una sede

Scollega uno o più file multimediali da una sede tramite i rispettivi ID.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Corpo

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

Richiesta di esempio

Corpo pronto da incollare. Sostituisci gli ID e i valori segnaposto con i tuoi.

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

Risposte

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.

Scollega file multimediali da una sede. Identifica i file da rimuovere tramite photoIds (gli ID restituiti dagli endpoint get-photos o di caricamento). Il valore di removedCount nella risposta indica quanti file sono stati effettivamente scollegati, consentendoti di individuare gli ID di file già rimossi.

Caso d'uso: rimuovere immagini obsolete della facciata. Dopo una ristrutturazione, elenca le foto della sede, seleziona le immagini aggiuntive obsolete e passa i rispettivi ID in photoIds per rimuoverle dalle piattaforme di pubblicazione con una sola chiamata.

Caso d'uso: annullare un caricamento collettivo errato. Se un'importazione automatizzata ha associato i contenuti sbagliati, raccogli gli ID dei file multimediali errati dalla risposta al caricamento e rimuovili immediatamente, quindi carica nuovamente i file corretti.

Aspetti da tenere presenti.

  • Solo le foto della categoria ADDITIONAL possono essere rimosse tramite l'API. Le immagini LOGO e COVER non possono essere eliminate qui; sostituiscile invece tramite l'endpoint di caricamento.
  • La rimozione di un file multimediale lo scollega dalla sede; non elimina necessariamente il file dalla libreria multimediale dell'account.
  • Un valore di removedCount pari a 0 con errors: null significa che nessuno degli ID forniti era associato a quella sede.
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