よくある質問

GBP API とは何ですか?

Business Profile API は、ビジネス プロフィール アカウントとビジネスデータを管理するためのアプリケーションを作成できる、デベロッパー向けのプログラミング インターフェースです。販売者または販売担当者は、この API を使用して、Google にビジネスデータをどのように表示するか、ビジネスデータを共同管理する権限を誰に付与するかを管理できます。また、写真、投稿、クチコミなど、ユーザーが作成したデータも API で管理することが可能です。

Business Profile API では、ビジネス プロフィールの管理画面に備わっているほとんどの機能に加え、Business Profile API 専用の追加機能を利用できます。Google による変更は、ビジネス プロフィールの管理画面と同様に Business Profile API にも適用されます。

GBP API にアクセスできるのは誰ですか?

GBP API は一般公開されていません。使用するには、GBP API へのアクセス権をリクエストする必要があります。GBP API にアクセスするビジネス上の法的な理由を明示できる個人または企業は、アクセスを承認されます。ビジネスとしての合法性を明示するために、以下の 2 点を行うことをおすすめします。

  • ビジネス ドメインに関連付けられているビジネス用のメールアドレスを使用する
  • ビジネスのウェブサイトが更新および公開されていることを確認する

GBP API へのアクセス権を持つユーザーは Google ビジネス プロフィールのすべてのデータにクエリを実行できますか?

いいえ。GBP API へのアクセス権を付与されている場合でも、Google ビジネス プロフィールのデータにクエリを実行するには、その特定の Google ビジネス プロフィールへのアクセス権が必要です。

GBP API ユーザーに関連するポリシーは何ですか?

パートナーは、Google ビジネス プロフィールに関するポリシーのほか、API に関するすべてのポリシー利用規約を遵守する必要があります。

GBP API にアクセスするにはどうすればよいですか?

最初のクライアント アプリケーションを作成するには、事前に以下の手順を完了しておく必要があります。

  1. Google アカウントを取得する
  2. ビジネス プロフィールを使ってみる
  3. Google API Console でプロジェクトを作成する
  4. API へのアクセスをリクエストする: リクエストの審査は、通常は 14 日以内に完了します。

GBP API 内の特定の API にアクセスするにはどうすればよいですか?

ビジネス プロフィールに関連付けられた以下 8 個の API を Google API Console で有効にする必要があります。

  • Google My Business API 4.9(以下の重要な機能の API 呼び出しを含む):
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • My Business Lodging API
  • My Business Place Actions API
  • My Business Notifications API
  • My Business Verifications API
  • My Business Business Information API
  • My Business Q&A API
  • Business Profile Performance API

アクセス権のリクエスト申請が承認されると、8 つの API すべてに対するデフォルトの標準割り当てが付与されます。

GBP API へのアクセス権はどのような仕組みになっていますか?

GBP API へのアクセス権は、Google Cloud プロジェクト単位で付与されます。ユーザー A がプロジェクト # - 12345678 向けに Google Business Profile API へのアクセス権を申請した場合は、プロジェクト # - 12345678 にアクセス権が付与されます。そのため、この Google Cloud プロジェクトへのアクセス権を持つユーザー A を含むすべてのユーザーは、Google Business Profile API を呼び出すことができます。パートナーは、不正使用を防ぐために、アクセスの必要性に応じて Google Cloud プロジェクトへのアクセス権を管理する必要があります。

API と機能例の概要は確認できますか?

以下の表は、さまざまな API とその機能をまとめたものです。

API リファレンス ドキュメント 機能の例
Account Management API ドキュメント
  • ビジネスへのアクセス権を管理します。
  • 指定した親の下に、指定した名前とタイプでアカウントを作成します。
  • 認証されたユーザーのすべてのアカウントの一覧を取得します。
  • 指定したアカウントについて、承認待ちとなっている招待の一覧を取得します。
  • ユーザーが所有するアカウントから別のアカウントにビジネスを移動します。
  • 指定したビジネスに関する更新情報を管理者に通知します。
Business Information API ドキュメント
  • Business Information API を使用すると、プロフィールのライフサイクルを管理し、GBP のビジネス情報を追加、管理できます。
  • 販売者は、Google ビジネス プロフィールを取得、作成、更新、削除できます。
  • 販売者は、プロフィールの属性を取得、更新できます。
  • 販売者は、プロフィールのカテゴリやチェーンを取得、検索できます。
Lodging API ドキュメント
  • Google に登録されたビジネスの宿泊関連のデータ(施設の設備やポリシーなど)を管理できます。この API はホテルなどの宿泊サービスを提供するビジネスを対象としています。Lodging API を使用すると、デベロッパーは、Google ビジネス プロフィールの宿泊施設の属性を更新できます。
Place Actions API ドキュメント
  • ビジネスの位置情報アクション リンクを管理できます。
  • 面会などの予約、席の予約、料理のデリバリーの注文などの操作を行うようにユーザーをリダイレクトします。
Notifications API ドキュメント
  • 指定したアカウントの通知設定を管理できます。
Verifications API ドキュメント
  • ビジネスのオーナー確認プロセスを開始します。
  • 特定の言語のビジネスで使用できるすべてのオーナー確認の方法を表します。
Q&A API ドキュメント
  • ビジネスに関する質問と回答を管理できます。
Business Profile Performance API ドキュメント
  • 販売者は、Google で表示されたビジネス リスティングに関するパフォーマンス分析情報を入手できます。
  • 分析情報には、ビジネスのインプレッション数、ルート検索数、通話クリック数、ウェブサイトへの誘導数、予約数、料理の注文数、メニューの操作回数などが含まれます。
Media API ドキュメント
  • API を使用するデベロッパーは、ビジネス プロフィール用の写真や動画をアップロードできます。
Reviews API ドキュメント
  • 販売者は、ビジネス プロフィールでクチコミを受け付け、クチコミに返信できます。
Local Posts API ドキュメント
  • 販売者は、ローカル投稿を取得、作成、更新できます。
FoodMenus API ドキュメント
  • 販売者は、ビジネス プロフィールのフードメニューを取得、作成、更新できます。

利用可能なデータやデータへのアクセス方法についてご不明な点がある場合は、こちらのフォームをご利用ください。

GBP API を使用するためには、パートナーはアカウントの構成をどのように設定すればよいですか?

ビジネスのリスティング管理を行うパートナー事業者の場合:

GBP API パートナーによるビジネス リスティングの管理を承認するには、どうすればよいですか?

ビジネスがパートナー事業者にアクセスを付与するには、以下の 2 つの方法があります。

  • OAuth の設定: 販売者やビジネスに代わって、パートナー事業者のプラットフォームで販売者の認証情報を使って Google ビジネス プロフィール データを編集し、それにアクセスする方法については、このガイドを参照してください。
  • オーナーまたは管理者のアクセス: GBP のプライマリ オーナーである販売者によって、パートナー事業者が Google ビジネス プロフィールの管理者として追加された場合、そのパートナー事業者は、販売者の認証情報を使用することなく、GBP API を使って GBP データを編集し、それにアクセスすることができます。

    注: パートナー事業者が自身を GBP に追加する場合は、オーナーとしてではなく、管理者として追加することを強くおすすめします。

ビジネス拠点が 10 か所以上ある場合に一括確認する方法はありますか?

はい。10 件以上のプロフィールについて一括確認をリクエストできます。オーナー確認後、一般に公開されているチェーン店は、他のビジネス拠点と同じように Business Profile API で管理できるようになります。ただし、一部例外もあります。たとえば、サイト管理者は他とは扱いが異なり、自分自身をフランチャイズ店に追加できます。

各種 API の割り当てにはどのような上限がありますか?

標準的な割り当ての上限については、使用量上限にまとめられています。 上限を引き上げる必要がある場合は、Standard Quota Request を送信してください。

どれくらいの割り当てをリクエストできますか?

割り当ては上限付きのリソースです。GBP API サポートチームは、これまでの割り当ての使用状況を確認して、割り当ての引き上げリクエストの適格性を判断します。割り当ての平均的な使用量が現在の割り当て上限の 70% 未満である場合、割り当て上限の追加の引き上げは拒否される可能性があります。

GBP API パートナーは本番環境用にテスト アカウントを作成することはできますか?

いいえ。GBP の管理画面や API を使って本番環境で偽の GBP リスティングを作成し、そのテストを実施するための直接的な方法はありません。

作成された偽のリスティングのほとんどは Google の管理メンバーによって報告され、停止されます。 クライアントのビジネス用に作成されたビジネス リスティングを使用し、(ビジネス名、住所、業種など、リスティングの主な情報は変更しないという条件のもとで)営業時間外に操作するか、自社の本部用のリスティングを作成することをおすすめします。リスティングのオーナー確認や、本番環境のリスティングを必要とするその他のアクションに対する API レスポンスをテストする場合は、モック API のレスポンス を使用できます。