使用场景
Google Maps Booking API 提供了两种方法 以编程方式检索各个商家的状态 各种集成或 本地生活服务广告 广告资源。
Merchant Status API 的使用场景：
- 改进现有客户关系管理工具，以展示您的 了解其广告资源在 Google 上的展示方式。
- 创建一个信息中心来跟踪商品目录状态和匹配状态 。
- 以编程方式检索 并更正任何不正确的信息，以提高数据质量。
商家状态包含哪些内容
通过 MerchantStatus 包含以下信息：
- 商家商品目录状态：同时适用于预订商家和/或加入等候名单的商家。
- 商家匹配状态：包含匹配的商家信息的详细信息
- 对于 Google 本地生活服务广告）匹配的商家服务提供商： 包括客户 ID 和服务类别。
- 用于展示商家如何在 Google 上展示的网址。
查询单个商家状态
您可以使用 inventory.partners.merchants.getStatus:
GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/{merchantId}/status
下面是一个 Python 代码示例（查看更多语言的示例 此处）：
from google.auth.transport.requests import AuthorizedSession
from google.oauth2 import service_account
credentials = service_account.Credentials.from_service_account_file(
'./your_key.json')
scoped_credentials = credentials.with_scopes(
['https://www.googleapis.com/auth/mapsbooking'])
authed_session = AuthorizedSession(scoped_credentials)
response = authed_session.get('https://partnerdev-mapsbooking.googleapis.com' +
'/v1alpha/inventory/partners/123456789/merchants/001/status')
示例 MerchantStatus 响应如下所示：
{
"name": "partners/123456789/merchants/001/status",
"merchantName": "Foo Bar Restaurant",
"inputGeoInfo": {
"unstructured_address": "123 Foo Bar Street, Mountain View"
},
"processingStatus": "COMPLETED",
"bookingStatus": {
"hasValidFutureInventory": true
},
"waitlistStatus": {
"hasValidWaitlistService": true
}
"geoMatch": {
"name": "Foo Bar Restaurant",
"formattedAddress": "123 Foo Bar St, Mountain View, CA 94043",
"placeId": "ChIAAAAAAAAABBBBBBBB"
},
"directUrls": [
{
"type": "BOOKING",
"url": "https://reserve-partnerdev.sandbox.google.com/maps/reserve/v/dine/m/Nwaaaaa"
},
{
"type": "WAITLIST",
"url": "https://reserve-partnerdev.sandbox.google.com/maps/reserve/v/wait/c/iDbbbbb"
}
]
}
批量检索商家状态
您可以检索所有商家或一组商家的状态 来满足特定广告资源/匹配条件 inventory.partners.merchants.status.list.例如，您可以将 此调用来获取所有不匹配的具有未来日期的有效预订的商家 广告资源：
GET https://mapsbooking.googleapis.com/v1alpha/inventory/partners/{partnerId}/merchants/status?pageSize=50&bookingInventoryStatusRestrict=HAS_VALID_FUTURE_INVENTORY&geoMatchRestrict=GEO_UNMATCHED
响应示例如下所示：
{
"merchantStatuses": [
{
"name": "partners/123456789/merchants/002/status",
"merchantName": "Bar Foo Restaurant",
"inputGeoInfo": {
"unstructured_address": "234 Bar Foo Street, Mountain View"
},
"processingStatus": "COMPLETED",
"bookingStatus": {
"hasValidFutureInventory": true
},
"waitlistStatus": {},
},
...
{
"name": "partners/123456789/merchants/080/status",
"merchantName": "Baz Restaurant",
"inputGeoInfo": {
"unstructured_address": "345 Baz Street, Mountain View"
},
"processingStatus": "COMPLETED",
"bookingStatus": {
"hasValidFutureInventory": true
},
"waitlistStatus": {
"hasValidWaitlistService": true
},
},
],
"nextPageToken": "AAABBBB"
}
此回答将包含 50
MerchantStatus，
merchant_id。该响应还包含一个页面令牌（如果该令牌是
而不是最后一页）查询下一页。
请注意：所有广告的过滤条件都应保持一致 页面。
最佳做法
由于商家状态在大多数情况下不会经常变化， 建议定期（如每隔几秒）缓存检索到的结果 通过新查询检索这些查询。操作中心可能会限制 每秒收到的请求数过高。