/api/v4/locations/photos/removeEliminar fotos de una ubicación
Desvincula uno o varios archivos multimedia de una ubicación mediante sus IDs.
Parámetros
Cuerpo
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| input.locationId | string | obligatorio | The location's Base64-encoded Relay ID the photos belong to. |
| input.photoIds | array of strings | obligatorio | Media file IDs to detach from the location (as returned by the get-photos or upload endpoints). |
Solicitud de ejemplo
Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "photoIds": [ "TWVkaWFGaWxlOjU4Nzg5MzI=" ] }}Respuestas
200Photos removed. `removedCount` reports how many media files were detached.
{ "data": { "removeLocationPhotos": { "clientMutationId": null, "removedCount": 1, "errors": null } }}401Unauthenticated, missing or invalid API key.
Desvincula archivos multimedia de una ubicación. Identifica los archivos que quieres eliminar mediante photoIds (los IDs devueltos por los endpoints get-photos o de carga). El campo removedCount de la respuesta indica cuántos archivos se han desvinculado realmente, lo que te permite detectar IDs que ya no estaban vinculados.
Caso de uso: retirar imágenes desactualizadas de la fachada. Después de una remodelación, enumera las fotos de la ubicación, selecciona las imágenes adicionales desactualizadas y pasa sus IDs en photoIds para retirarlas de las plataformas de publicación en una sola llamada.
Caso de uso: deshacer una carga masiva incorrecta. Si una importación automatizada vinculó los recursos equivocados, recopila los IDs de los archivos multimedia incorrectos de la respuesta de carga y elimínalos de inmediato; después, vuelve a cargar los archivos correctos.
Aspectos que debes tener en cuenta.
- Solo se pueden eliminar mediante la API las fotos de la categoría
ADDITIONAL. Las imágenes de las categoríasLOGOyCOVERno se pueden eliminar aquí; sustitúyelas mediante el endpoint de carga. - Eliminar un archivo multimedia lo desvincula de la ubicación; no necesariamente lo elimina de la biblioteca multimedia de la cuenta.
- Un valor de
0enremovedCountjunto conerrors: nullsignifica que ninguno de los IDs proporcionados estaba vinculado a esa ubicación.
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=" ] } }'