GoogleLocations API を使用すると、ビジネス プロフィールでビジネスが申請されているかどうかを事前に確認できます。ビジネスが申請されている場合は、そのビジネスへのアクセス権をすぐにリクエストできます。また、一括オーナー確認済みのアカウントを管理する場合は、事前に一致する候補をより正確に選択することで、ビジネス情報の重複を避けることができます。
API エンドポイントが返す URL で、ビジネスがすでに申請されているかどうかが示されます。すでに申請されている場合は、同じ URL を使ってアクセス権のリクエスト プロセスを開始できます。
次の図は、ビジネスのオーナー権限を取得するためのプロセスを示しています。
次の手順では GoogleLocations API を使用できます。
- 販売者から位置情報を収集します。
-
googleLocations.searchエンドポイントを呼び出します。通話の本文に位置情報を含めます。または、Google 検索や Google マップでユーザーが入力するのと同じように、クエリ文字列でクエリを指定することもできます。（新宿のスターバックス、東京都港区六本木 6 丁目）API から、一致候補となるビジネスと各ビジネスの情報（
locationName、address など）のリストが返されます。 - ご自身のビジネスに一致するものを選択します。一致するものがない場合は、
accounts.locations.createを呼び出してステップ 5 に進みます。 -
レスポンスの
requestAdminRightsUrlの状態に応じて、次のいずれかを行います。requestAdminRightsUrlが存在する場合は、そのリスティングのオーナー権限を他のユーザーが所有しています。 ビジネス プロフィールの既存のビジネス情報へのアクセス権とオーナー権限をリクエストするため、その URL を販売者に伝えます。requestAdminRightsUrlが存在しない場合は、accounts.locations.createを呼び出して、後で確認される新しいリスティングを作成します。
- 新しいリスティングを作成した場合は、オーナー確認用の API を利用して、リスティングのオーナー確認プロセスを開始します。詳しくは、オーナー確認の管理をご覧ください。