Listings APIListings API
Iniciar sesión

Fotos

Añade, lista, elimina y marca como favoritas las fotos de una ubicación mediante client.photos.

Todos los métodos de fotos se encuentran en client.photos. Todos los métodos reciben un location_id excepto upload_status, y location_id acepta IDs numéricos o codificados en base64; consulta IDs de ubicación.

Las fotos se adjuntan mediante una URL pública en lugar de subirse como datos de formulario multipart: tú alojas la imagen, la plataforma la obtiene y el procesamiento continúa en segundo plano. Los tipos de foto son LOGO, COVER y ADDITIONAL.

photos.list

Obtén los archivos multimedia adjuntos a una ubicación, tanto los marcados con estrella como los que no lo están.

Python
client.photos.list(location_id: str | int) -> list[APIObject]
Python
photos = client.photos.list(16808)for photo in photos:  print(photo.id, photo.categoryName, photo.starred)

Devuelve la lista mediaFilesOfLocation. Cada elemento tiene id, url, thumbnailUrl, categoryName, categoryId, fileType, starred y viewsCount. id es el valor que pasas a remove y star. Consulta Obtener fotos de una ubicación.

photos.add

Adjunta una o más fotos a una ubicación. Cada elemento de photos necesita una clave photo que contenga una URL pública de imagen y una clave type.

Python
client.photos.add(    location_id: str | int,    photos: list[dict[str, Any]],) -> APIObject
ClaveTipoDescripción
photostrURL pública de la imagen que se va a obtener.
typestrLOGO, COVER o ADDITIONAL.
Python
result = client.photos.add(16808, [  {"photo": "https://cdn.example.com/acme-logo.png", "type": "LOGO"},  {"photo": "https://cdn.example.com/acme-storefront.jpg", "type": "ADDITIONAL"},])for photo in result.photos:  print(photo.id, photo.type)

Devuelve el objeto addLocationPhotos con success, photos, request y errors. Cada entrada de photos contiene id, databaseId, url, thumbnailUrl, type y starred. Consulta Subir fotos a una ubicación.

photos.remove

Desvincula fotos de una ubicación mediante sus IDs de archivo multimedia.

Python
client.photos.remove(    location_id: str | int,    photo_ids: list[str],) -> APIObject
Python
result = client.photos.remove(16808, ["TWVkaWFGaWxlOjU4Nzg5MzE="])print(result.removedCount)

Devuelve el objeto removeLocationPhotos con removedCount y errors. Consulta Quitar fotos de una ubicación.

photos.star

Marca fotos con estrella o quítales la estrella para que las plataformas de publicación compatibles las coloquen primero. Pasa starred=False para quitar la estrella. Se pueden marcar con estrella un máximo de 4 fotos por cuenta.

Python
client.photos.star(    location_id: str | int,    media_ids: list[str],    *,    starred: bool = True,) -> APIObject

El parámetro de Python se llama media_ids y contiene los mismos valores de id de los archivos multimedia que devuelve photos.list. El SDK los envía en el campo photoIds de la solicitud, por lo que nunca tienes que construir ese campo tú mismo.

Python
# Star two photosclient.photos.star(16808, ["TWVkaWFGaWxlOjU4Nzg5MzI=", "TWVkaWFGaWxlOjU4Nzg5MzM="]) # Unstar oneresult = client.photos.star(16808, ["TWVkaWFGaWxlOjU4Nzg5MzI="], starred=False)for photo in result.photos:  print(photo.id, photo.starred)

Devuelve el objeto starUnstarLocationPhotos con success, photos y error. Consulta Marcar con estrella fotos de una ubicación.

photos.upload_status

Comprueba el progreso de una carga masiva de fotos. Consulta este método periódicamente cuando hayas añadido muchas fotos a la vez y necesites resultados por imagen.

Python
client.photos.upload_status(request_id: str) -> APIObject
Python
status = client.photos.upload_status("e6c2d9d9-9a18-4015-88cf-9a4e19a6f49a")print(status.to_dict())

Consulta Comprobar el estado de una carga masiva de fotos para ver los campos de estado y error de cada foto, incluidos los motivos de rechazo que pueden devolverse para una foto.

Consulta también