Foto

Tambahkan, tampilkan daftar, hapus, dan beri bintang pada foto lokasi melalui client.photos.

Semua metode foto berada di client.photos. Setiap metode menerima location_id kecuali upload_status, dan location_id menerima ID numerik atau ID yang dikodekan dengan base64, lihat ID lokasi.

Foto dilampirkan melalui URL publik, bukan diunggah sebagai data formulir multipart: Anda menyediakan gambar di server, platform mengambilnya, lalu pemrosesan berlanjut di latar belakang. Jenis foto adalah LOGO, COVER, dan ADDITIONAL.

`photos.list`

Ambil file media yang dilampirkan ke suatu lokasi, baik yang diberi bintang maupun yang tidak.

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)

Mengembalikan daftar mediaFilesOfLocation. Setiap item memiliki id, url, thumbnailUrl, categoryName, categoryId, fileType, starred, dan viewsCount. id adalah nilai yang Anda teruskan ke remove dan star. Lihat Ambil foto untuk suatu lokasi.

`photos.add`

Lampirkan satu atau beberapa foto ke suatu lokasi. Setiap item dalam photos memerlukan kunci photo yang berisi URL gambar publik dan kunci type.

Python

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

Kunci	Tipe	Deskripsi
`photo`	`str`	URL publik gambar yang akan diambil.
`type`	`str`	`LOGO`, `COVER`, atau `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)

Mengembalikan objek addLocationPhotos dengan success, photos, request, dan errors. Setiap entri dalam photos memuat id, databaseId, url, thumbnailUrl, type, dan starred. Lihat Unggah foto ke suatu lokasi.

`photos.remove`

Lepaskan foto dari suatu lokasi berdasarkan ID medianya.

Python

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

Python

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

Mengembalikan objek removeLocationPhotos dengan removedCount dan errors. Lihat Hapus foto dari suatu lokasi.

`photos.star`

Beri atau hapus tanda bintang pada foto agar platform publikasi yang mendukungnya menempatkan foto berbintang di urutan pertama. Teruskan starred=False untuk menghapus tanda bintang. Maksimal 4 foto dapat diberi bintang per akun.

Python

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

Parameter Python bernama media_ids, dan berisi nilai id media yang sama dengan yang dikembalikan oleh photos.list. SDK mengirimkannya sebagai field photoIds melalui jaringan, sehingga Anda tidak perlu membuat field tersebut sendiri.

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)

Mengembalikan objek starUnstarLocationPhotos dengan success, photos, dan error. Lihat Beri bintang pada foto lokasi.

`photos.upload_status`

Periksa progres unggahan foto massal. Panggil metode ini secara berkala saat Anda menambahkan banyak foto sekaligus dan memerlukan hasil untuk setiap gambar.

Python

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

Python

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

Lihat Periksa status unggahan foto massal untuk field status dan kesalahan per foto, termasuk alasan penolakan yang dapat dikembalikan untuk suatu foto.

Lihat juga

Unggah foto lokasi: panduan foto dari awal hingga akhir, termasuk batas ukuran
Lokasi: buat dan perbarui lokasi tempat Anda melampirkan foto
Postingan: lampirkan satu gambar ke postingan dengan media_url