ユースケース
Google Maps Booking API では、2 つのメソッドを使用できます。 個々の販売者のステータスをプログラマティックに取得して、 さまざまな統合や ローカル サービス広告 できます。
Merchant Status API のユースケース:
- 既存の顧客管理ツールを強化して 顧客に広告枠が公開される仕組み
- 在庫ステータスと照合ステータスを追跡するダッシュボードを 提供します
- 予約可能なお客様の予約可能なステータスをプログラマティックに取得し、 誤った情報があれば修正し、データ品質を改善します。
販売者ステータスの内容
「 MerchantStatus には、次の情報が含まれています。
- 販売者の在庫ステータス: 予約と順番待ちリストの両方の販売者に適用されます。
- 販売者の照合ステータス: 一致したビジネス リスティングの詳細が表示されます。
- 対象 Google ローカル サービス広告のみ）で一致した販売者サービス プロバイダ: お客様 ID とサービスカテゴリが含まれます
- Google で販売者がどのように表示されるのかを示す URL。
1 つの販売者のステータスを検索する
特定の販売者のステータスは、 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。レスポンスにはページトークンも含まれます（
（最後のページではない）を選択して、次のページをクエリします。
注: フィルタリング条件はすべてのサービスで一貫している必要があります。 できます。
ベスト プラクティス
販売者のステータスは頻繁に変更されないため、 取得した結果を定期的に（たとえば、 新しいクエリを介して取得します。アクション センターがユーザーのアクションをスロットリングし、 1 秒あたりのリクエスト数が極端に多いと判断された場合に、これらのクエリをクエリできます。