商家信息

通过 client.listings 管理高级、语音和重复的目录商家信息。

所有商家信息方法都位于 client.listings 下。接受 location_id 的方法支持数字 ID 或 base64 编码的 ID，参见地点 ID。

`listings.premium`

获取某个地点在高级目录（Google、Yelp、Facebook 等）中的商家信息。

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}")

常见的 syncStatus 值：SYNCED、PENDING、NOT_SYNCED、ERROR。

`listings.voice`

获取语音助手（Google Assistant、Alexa、Siri）中的商家信息。

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`

获取单个地点的重复商家信息。

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`

获取所有地点的重复商家信息，可按标签筛选。

Python

client.listings.all_duplicates(    *,    tag: str | None = None,    page: int | None = None,) -> APIObject

参数	类型	说明
`tag`	`str`	将汇总范围限定为一个标签。省略此参数可涵盖该密钥有权查看的所有地点。
`page`	`int`	从 1 开始的页码。

Python

rollup = 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`

将某个地点的商家信息条目标记为重复项。

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`

清除商家信息条目的重复状态。

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`

将地点关联到已连接账户中的商家信息。

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`

断开地点与其 Google 或 Facebook 商家信息的关联。

Python

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

site 不区分大小写；SDK 会在发送前将其转换为大写。

Python

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

`listings.create_gmb`

为现有的 Listings API 地点创建 Google Business Profile 商家信息。

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",)

另请参阅

地点：地点 ID 和生命周期
用例：商家信息审核操作指南（用例 6）