GoogleLocations API を使用すると、ビジネス プロフィールでビジネスが申請されているかどうかを事前に確認できます。ビジネスが申請されている場合は、そのビジネスへのアクセス権をすぐにリクエストできます。また、一括確認を行うアカウントを管理している場合は、事前に一致候補を的確に選び、ビジネス情報が重複する事態を回避できます。
API エンドポイントが返す URL で、ビジネスがすでに申請されているかどうかが示されます。すでに申請されている場合は、同じ URL を使ってアクセス権のリクエスト プロセスを開始できます。
次の図は、ビジネスのオーナー権限を取得するためのプロセスを示しています。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/locations1.png?authuser=3&hl=ja)
GoogleLocations
API を使用する手順は次のとおりです。
- 販売者のビジネス情報を収集します。
-
googleLocations.search
エンドポイントを呼び出します。この呼び出しの本文にビジネス情報を含めます。またはクエリ文字列(Google 検索や Google マップでユーザーが入力するような文字列)を含めることもできます(「新宿のスターバックス」など)。API から、一致候補となるビジネスと各ビジネスの情報(
locationName
、address など)のリストが返されます。 - ご自身のビジネスに一致するものを選択します。一致するものがない場合は、
accounts.locations.create
を呼び出してステップ 5 に進みます。 -
レスポンスの
requestAdminRightsUrl
の状態に応じて、次のいずれかを行います。requestAdminRightsUrl
が存在する場合は、そのリスティングのオーナー権限を他のユーザーが所有しています。 ビジネス プロフィールの既存のビジネス情報へのアクセス権とオーナー権限をリクエストするため、その URL を販売者に伝えます。requestAdminRightsUrl
が存在しない場合はaccounts.locations.create
を呼び出して新しいリスティングを作成します。新しいリスティングのオーナー確認は後で行います。
- 新しいリスティングを作成した場合は、オーナー確認用の API を利用して、リスティングのオーナー確認プロセスを開始できます。詳しくは、オーナー確認の管理をご覧ください。