Listings APIListings API
Oturum aç

Fotoğraflar

client.photos aracılığıyla konum fotoğraflarını ekleyin, listeleyin, kaldırın ve yıldızla işaretleyin.

Tüm fotoğraf metotları client.photos altında yer alır. upload_status dışındaki tüm metotlar location_id alır ve location_id sayısal veya base64 ile kodlanmış kimlikleri kabul eder; bkz. Konum kimlikleri.

Fotoğraflar, multipart form verisi olarak yüklenmek yerine herkese açık bir URL aracılığıyla eklenir: görseli siz barındırırsınız, platform görseli alır ve işleme arka planda devam eder. Fotoğraf türleri LOGO, COVER ve ADDITIONAL şeklindedir.

photos.list

Bir konuma eklenmiş yıldızlı ve yıldızsız medya dosyalarını alı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)

mediaFilesOfLocation listesini döndürür. Her öğe id, url, thumbnailUrl, categoryName, categoryId, fileType, starred ve viewsCount içerir. remove ve star metotlarına ilettiğiniz değer id değeridir. Bkz. Bir konumun fotoğraflarını alma.

photos.add

Bir konuma bir veya daha fazla fotoğraf ekleyin. photos içindeki her öğede, herkese açık bir görsel URL'si içeren bir photo anahtarı ve bir type anahtarı bulunmalıdır.

Python
client.photos.add(    location_id: str | int,    photos: list[dict[str, Any]],) -> APIObject
AnahtarTürAçıklama
photostrAlınacak görselin herkese açık URL'si.
typestrLOGO, COVER veya 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)

success, photos, request ve errors içeren addLocationPhotos nesnesini döndürür. photos içindeki her kayıt id, databaseId, url, thumbnailUrl, type ve starred içerir. Bkz. Bir konuma fotoğraf yükleme.

photos.remove

Fotoğrafları medya kimliklerini kullanarak bir konumdan kaldırın.

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

removedCount ve errors içeren removeLocationPhotos nesnesini döndürür. Bkz. Bir konumdan fotoğraf kaldırma.

photos.star

Bu özelliği destekleyen yayın platformlarının fotoğrafları ilk sıraya yerleştirmesi için fotoğraflara yıldız ekleyin veya yıldızlarını kaldırın. Yıldızı kaldırmak için starred=False iletin. Hesap başına en fazla 4 fotoğrafa yıldız eklenebilir.

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

Python parametresinin adı media_ids şeklindedir ve photos.list tarafından döndürülen aynı medya id değerlerini içerir. SDK bu değerleri ağ üzerinden photoIds alanı olarak gönderir, bu nedenle bu alanı hiçbir zaman kendiniz oluşturmanız gerekmez.

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)

success, photos ve error içeren starUnstarLocationPhotos nesnesini döndürür. Bkz. Konum fotoğraflarına yıldız ekleme.

photos.upload_status

Toplu fotoğraf yükleme işleminin ilerlemesini kontrol edin. Aynı anda çok sayıda fotoğraf eklediğinizde ve her görselin sonucuna ihtiyaç duyduğunuzda bu metodu düzenli aralıklarla çağırın.

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

Bir fotoğraf için döndürülebilecek reddedilme nedenleri de dahil olmak üzere, fotoğraf başına durum ve hata alanları için bkz. Toplu fotoğraf yükleme durumunu kontrol etme.

Ayrıca bkz.