Foto

Aggiungi, elenca, rimuovi e contrassegna come preferite le foto delle sedi tramite client.photos.

Tutti i metodi per le foto si trovano in client.photos. Ogni metodo richiede un location_id tranne upload_status, e location_id accetta ID numerici o codificati in base64; vedi ID delle sedi.

Le foto vengono allegate tramite URL pubblico anziché caricate come dati di un modulo multipart: tu ospiti l'immagine, la piattaforma la recupera e l'elaborazione prosegue in background. I tipi di foto sono LOGO, COVER e ADDITIONAL.

`photos.list`

Recupera i file multimediali allegati a una sede, sia quelli contrassegnati come preferiti sia gli altri.

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)

Restituisce l'elenco mediaFilesOfLocation. Ogni elemento contiene id, url, thumbnailUrl, categoryName, categoryId, fileType, starred e viewsCount. id è il valore da passare a remove e star. Vedi Recuperare le foto di una sede.

`photos.add`

Allega una o più foto a una sede. Ogni elemento in photos deve contenere una chiave photo con un URL pubblico dell'immagine e una chiave type.

Python

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

Chiave	Tipo	Descrizione
`photo`	`str`	URL pubblico dell'immagine da recuperare.
`type`	`str`	`LOGO`, `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)

Restituisce l'oggetto addLocationPhotos con success, photos, request e errors. Ogni voce in photos contiene id, databaseId, url, thumbnailUrl, type e starred. Vedi Caricare foto su una sede.

`photos.remove`

Scollega le foto da una sede tramite i rispettivi ID multimediali.

Python

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

Python

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

Restituisce l'oggetto removeLocationPhotos con removedCount e errors. Vedi Rimuovere foto da una sede.

`photos.star`

Contrassegna le foto come preferite o rimuovi il contrassegno affinché le piattaforme di pubblicazione che supportano questa funzione mostrino per prime le foto preferite. Passa starred=False per rimuovere il contrassegno. Puoi contrassegnare come preferite al massimo 4 foto per account.

Python

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

Il parametro Python si chiama media_ids e contiene gli stessi valori id dei file multimediali restituiti da photos.list. L'SDK li invia nel campo photoIds della richiesta, quindi non devi mai creare questo campo manualmente.

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)

Restituisce l'oggetto starUnstarLocationPhotos con success, photos e error. Vedi Contrassegnare le foto di una sede come preferite.

`photos.upload_status`

Controlla l'avanzamento di un caricamento collettivo di foto. Interroga periodicamente questo metodo quando hai aggiunto molte foto contemporaneamente e ti servono i risultati per ciascuna immagine.

Python

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

Python

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

Vedi Controllare lo stato del caricamento collettivo di foto per i campi relativi allo stato e agli errori di ciascuna foto, inclusi i possibili motivi di rifiuto.

Vedi anche

Caricare foto delle sedi: la guida completa alle foto, inclusi i limiti di dimensione
Sedi: crea e aggiorna le sedi a cui alleghi le foto
Post: allega una singola immagine a un post con media_url