Listings APIListings API
Oturum aç

İşletme kayıtları

Premium, sesli ve yinelenen dizin işletme kayıtlarını client.listings aracılığıyla yönetin.

Tüm işletme kaydı yöntemleri client.listings altında yer alır. location_id alan yöntemler sayısal veya base64 ile kodlanmış kimlikleri kabul eder; bkz. Konum kimlikleri.

listings.premium

Bir konumun premium dizinlerdeki (Google, Yelp, Facebook vb.) işletme kayıtlarını alın.

Python
client.listings.premium(location_id: str | int) -> list[APIObject]
Python
listings = client.listings.premium(16808)for listing in listings:  site = listing.get("site", "N/A")  status = listing.get("syncStatus", "N/A")  print(f"{site}: {status}")

Yaygın syncStatus değerleri: SYNCED, PENDING, NOT_SYNCED, ERROR.

listings.voice

Sesli asistanlardaki (Google Assistant, Alexa, Siri) işletme kayıtlarını alın.

Python
client.listings.voice(location_id: str | int) -> list[APIObject]
Python
voice = client.listings.voice(16808)print(f"{len(voice)} voice assistant listings")

listings.duplicates

Tek bir konumun yinelenen işletme kayıtlarını alın.

Python
client.listings.duplicates(location_id: str | int) -> list[APIObject]
Python
dupes = client.listings.duplicates(16808)print(f"Found {len(dupes)} duplicate listings")

listings.all_duplicates

İsteğe bağlı etiket filtresiyle tüm konumlardaki yinelenen işletme kayıtlarını alın.

Python
client.listings.all_duplicates(    *,    tag: str | None = None,    page: int | None = None,) -> APIObject
ParametreTürAçıklama
tagstrToplu sonuçları tek bir etiketle sınırlandırın. Anahtarın erişebildiği tüm konumları kapsamak için bu parametreyi belirtmeyin.
pageint1'den başlayan sayfa numarası.
Python
rollup = client.listings.all_duplicates(page=1)print(rollup.to_dict()) # Scope to one tagrollup = client.listings.all_duplicates(tag="northeast", page=1)

İki bağımsız değişken de isteğe bağlıdır. Bunları belirtmediğinizde varsayılan değerler status: POTENTIAL ve tag: all olur; dolayısıyla bağımsız değişken olmadan yapılan çağrı, hesabın açık durumdaki olası yinelenen kayıtlarını döndürür. Dönen veri, ofset tabanlı bir sayfadır: records[] ve totalRecords / totalPages içeren pageInfo.

listings.mark_duplicate

Bir konumun işletme kaydı öğelerini yinelenen olarak işaretleyin.

Python
client.listings.mark_duplicate(    location_id: str | int,    listing_item_ids: list[str],) -> APIObject
Python
result = client.listings.mark_duplicate(  location_id=16808,  listing_item_ids=["item-uuid-1", "item-uuid-2"],)print(result.to_dict())

listings.mark_not_duplicate

İşletme kaydı öğelerinin yinelenme durumunu temizleyin.

Python
client.listings.mark_not_duplicate(    location_id: str | int,    listing_item_ids: list[str],) -> APIObject
Python
client.listings.mark_not_duplicate(16808, ["item-uuid-1"])

listings.connect

Bir konumu bağlı bir hesaptaki işletme kaydıyla ilişkilendirin.

Python
client.listings.connect(    location_id: str | int,    connected_account_listing_id: str,    connected_account_id: str,) -> APIObject
Python
result = client.listings.connect(  location_id=16808,  connected_account_listing_id="ca-listing-uuid",  connected_account_id="ca-uuid",)

listings.disconnect

Bir konumun Google veya Facebook işletme kaydıyla bağlantısını kesin.

Python
client.listings.disconnect(    location_id: str | int,    site: str,) -> APIObject

site büyük/küçük harfe duyarlı değildir; SDK, göndermeden önce bunu büyük harfe dönüştürür.

Python
client.listings.disconnect(16808, site="google")client.listings.disconnect(16808, site="facebook")

listings.create_gmb

Mevcut bir Listings API konumu için Google Business Profile işletme kaydı oluşturun.

Python
client.listings.create_gmb(    location_id: str | int,    connected_account_id: str,    *,    folder_id: str | None = None,) -> APIObject
Python
result = client.listings.create_gmb(  location_id=16808,  connected_account_id="ca-uuid",)

Ayrıca bakın