Fotos

Über client.photos können Sie Standortfotos hinzufügen, auflisten, entfernen und mit einem Stern markieren.

Alle Fotomethoden befinden sich unter client.photos. Jede Methode außer upload_status nimmt location_id entgegen, und location_id akzeptiert numerische oder base64-kodierte IDs, siehe Standort-IDs.

Fotos werden über eine öffentliche URL angehängt und nicht als Multipart-Formulardaten hochgeladen: Sie hosten das Bild, die Plattform ruft es ab, und die Verarbeitung wird im Hintergrund fortgesetzt. Die Fototypen sind LOGO, COVER und ADDITIONAL.

`photos.list`

Rufen Sie die einem Standort zugeordneten Mediendateien ab, sowohl mit als auch ohne Sternmarkierung.

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)

Gibt die Liste mediaFilesOfLocation zurück. Jedes Element enthält id, url, thumbnailUrl, categoryName, categoryId, fileType, starred und viewsCount. Den Wert von id übergeben Sie an remove und star. Siehe Fotos für einen Standort abrufen.

`photos.add`

Hängen Sie ein oder mehrere Fotos an einen Standort an. Jedes Element in photos benötigt einen Schlüssel photo mit einer öffentlichen Bild-URL und einen Schlüssel type.

Python

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

Schlüssel	Typ	Beschreibung
`photo`	`str`	Öffentliche URL des abzurufenden Bildes.
`type`	`str`	`LOGO`, `COVER` oder `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)

Gibt das Objekt addLocationPhotos mit success, photos, request und errors zurück. Jeder Eintrag in photos enthält id, databaseId, url, thumbnailUrl, type und starred. Siehe Fotos zu einem Standort hochladen.

`photos.remove`

Entfernen Sie anhand der Medien-IDs die Zuordnung von Fotos zu einem Standort.

Python

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

Python

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

Gibt das Objekt removeLocationPhotos mit removedCount und errors zurück. Siehe Fotos von einem Standort entfernen.

`photos.star`

Markieren Sie Fotos mit einem Stern oder entfernen Sie die Sternmarkierung, damit unterstützte Plattformen die markierten Fotos zuerst anzeigen. Übergeben Sie starred=False, um die Sternmarkierung zu entfernen. Pro Konto können maximal 4 Fotos mit einem Stern markiert werden.

Python

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

Der Python-Parameter heißt media_ids und enthält dieselben Medien-id-Werte, die photos.list zurückgibt. Das SDK überträgt sie im Feld photoIds, sodass Sie dieses Feld nie selbst erstellen müssen.

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)

Gibt das Objekt starUnstarLocationPhotos mit success, photos und error zurück. Siehe Standortfotos mit einem Stern markieren.

`photos.upload_status`

Prüfen Sie den Fortschritt eines Sammeluploads von Fotos. Fragen Sie diese Methode regelmäßig ab, wenn Sie viele Fotos auf einmal hinzugefügt haben und Ergebnisse für jedes einzelne Bild benötigen.

Python

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

Python

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

Unter Status eines Sammeluploads von Fotos prüfen finden Sie die Status- und Fehlerfelder für jedes Foto, einschließlich der möglichen Ablehnungsgründe.

Siehe auch

Standortfotos hochladen: die vollständige Anleitung für Fotos, einschließlich Größenbeschränkungen
Standorte: Erstellen und aktualisieren Sie die Standorte, an die Sie Fotos anhängen
Beiträge: Hängen Sie mit media_url ein einzelnes Bild an einen Beitrag an