商家資訊
透過 client.listings 管理付費、語音及重複的目錄商家資訊。
所有商家資訊方法都位於 client.listings 下。接受 location_id 的方法可使用數字或 base64 編碼的 ID，請參閱地點 ID。
listings.premium
取得地點的進階目錄商家資訊（Google、Yelp、Facebook 等）。
client.listings.premium(location_id: str | int) -> list[APIObject]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}")常見的 syncStatus 值：SYNCED、PENDING、NOT_SYNCED、ERROR。
listings.voice
取得語音助理商家資訊（Google Assistant、Alexa、Siri）。
client.listings.voice(location_id: str | int) -> list[APIObject]voice = client.listings.voice(16808)print(f"{len(voice)} voice assistant listings")listings.duplicates
取得單一地點的重複商家資訊。
client.listings.duplicates(location_id: str | int) -> list[APIObject]dupes = client.listings.duplicates(16808)print(f"Found {len(dupes)} duplicate listings")listings.all_duplicates
取得所有地點的重複商家資訊，可選擇依標籤篩選。
client.listings.all_duplicates( *, tag: str | None = None, page: int | None = None,) -> APIObjectrollup = client.listings.all_duplicates(page=1)print(rollup.to_dict()) # Scope to one tagrollup = client.listings.all_duplicates(tag="northeast", page=1)這 2 個引數都不是必填。省略時，預設值為 status: POTENTIAL 和 tag: all，因此不帶引數的呼叫會回傳帳戶中尚未處理的疑似重複商家資訊。回傳內容是一頁以位移量分頁的資料：records[] 加上含有 totalRecords／totalPages 的 pageInfo。
listings.mark_duplicate
將地點的商家資訊項目標記為重複。
client.listings.mark_duplicate( location_id: str | int, listing_item_ids: list[str],) -> APIObjectresult = client.listings.mark_duplicate( location_id=16808, listing_item_ids=["item-uuid-1", "item-uuid-2"],)print(result.to_dict())listings.mark_not_duplicate
清除商家資訊項目的重複狀態。
client.listings.mark_not_duplicate( location_id: str | int, listing_item_ids: list[str],) -> APIObjectclient.listings.mark_not_duplicate(16808, ["item-uuid-1"])listings.connect
將地點連結至已連接帳戶中的商家資訊。
client.listings.connect( location_id: str | int, connected_account_listing_id: str, connected_account_id: str,) -> APIObjectresult = client.listings.connect( location_id=16808, connected_account_listing_id="ca-listing-uuid", connected_account_id="ca-uuid",)listings.disconnect
中斷地點與其 Google 或 Facebook 商家資訊的連結。
client.listings.disconnect( location_id: str | int, site: str,) -> APIObjectsite 不區分大小寫；SDK 會在傳送前將其轉為大寫。
client.listings.disconnect(16808, site="google")client.listings.disconnect(16808, site="facebook")listings.create_gmb
為現有的 Listings API 地點建立 Google Business Profile 商家資訊。
client.listings.create_gmb( location_id: str | int, connected_account_id: str, *, folder_id: str | None = None,) -> APIObjectresult = client.listings.create_gmb( location_id=16808, connected_account_id="ca-uuid",)