Fotos

Adicione, liste, remova e marque com estrela fotos de locais via client.photos.

Todos os métodos de fotos estão em client.photos. Todos os métodos recebem um location_id, exceto upload_status, e location_id aceita IDs numéricos ou codificados em base64; consulte IDs de locais.

As fotos são anexadas por URL pública, em vez de serem enviadas como dados de formulário multipart: você hospeda a imagem, a plataforma a busca e o processamento continua em segundo plano. Os tipos de foto são LOGO, COVER e ADDITIONAL.

`photos.list`

Obtenha os arquivos de mídia anexados a um local, com e sem estrela.

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)

Retorna a lista mediaFilesOfLocation. Cada item tem id, url, thumbnailUrl, categoryName, categoryId, fileType, starred e viewsCount. id é o valor que você passa para remove e star. Consulte Obter fotos de um local.

`photos.add`

Anexe uma ou mais fotos a um local. Cada item em photos precisa de uma chave photo que contenha uma URL pública de imagem e de uma chave type.

Python

client.photos.add(    location_id: str | int,    photos: list[dict[str, Any]],) -> APIObject

Chave	Tipo	Descrição
`photo`	`str`	URL pública da imagem a ser buscada.
`type`	`str`	`LOGO`, `COVER` ou `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)

Retorna o objeto addLocationPhotos com success, photos, request e errors. Cada entrada em photos contém id, databaseId, url, thumbnailUrl, type e starred. Consulte Enviar fotos para um local.

`photos.remove`

Desvincule fotos de um local pelos respectivos IDs de mídia.

Python

client.photos.remove(    location_id: str | int,    photo_ids: list[str],) -> APIObject

Python

result = client.photos.remove(16808, ["TWVkaWFGaWxlOjU4Nzg5MzE="])print(result.removedCount)

Retorna o objeto removeLocationPhotos com removedCount e errors. Consulte Remover fotos de um local.

`photos.star`

Marque fotos com estrela ou remova a estrela para que as plataformas de publicação compatíveis exibam primeiro as fotos marcadas. Passe starred=False para remover a estrela. No máximo 4 fotos podem ser marcadas com estrela por conta.

Python

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

O parâmetro em Python se chama media_ids e contém os mesmos valores de id de mídia retornados por photos.list. O SDK os envia no campo photoIds da requisição, portanto você nunca precisa montar esse campo.

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)

Retorna o objeto starUnstarLocationPhotos com success, photos e error. Consulte Marcar fotos de um local com estrela.

`photos.upload_status`

Verifique o andamento de um envio de fotos em lote. Consulte este método periodicamente quando você tiver adicionado muitas fotos de uma vez e precisar dos resultados por imagem.

Python

client.photos.upload_status(request_id: str) -> APIObject

Python

status = client.photos.upload_status("e6c2d9d9-9a18-4015-88cf-9a4e19a6f49a")print(status.to_dict())

Consulte Verificar o status do envio de fotos em lote para ver os campos de status e erro por foto, incluindo os motivos de rejeição que podem ser retornados para uma foto.

Veja também

Enviar fotos de um local: o guia completo de fotos, incluindo limites de tamanho
Locais: crie e atualize os locais aos quais você anexa fotos
Publicações: anexe uma única imagem a uma publicação com media_url