よくある質問

GBP の API とは

Business Profile API は、ビジネス プロフィール アカウントとビジネス情報を管理するためのアプリケーションを作成できるプログラミング インターフェースです。販売者またはその代理人は、この API を使用して、Google でのデータの表示方法を管理したり、データを共同管理するユーザーを管理したりできます。写真、投稿、クチコミなど、ユーザーが作成したデータも API で管理できます。

Business Profile API は、ビジネス プロフィールのユーザー インターフェースとほぼ同じ機能に加え、API 固有の機能を備えています。API のユーザーも、ユーザー インターフェースのユーザーと同様に、Google による更新が行われることを期待できます。

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

GBP の API は一般公開されていません。ユーザーが GBP API を使用するには、その API へのアクセスをリクエストする必要があります。GBP API にアクセスする法的なビジネス上の理由を実証できる個人または企業であれば、アクセスが承認されます。企業としての合法性を示すための推奨事項は次のとおりです。

  • ビジネスのドメインに関連付けられた有効なビジネス用メールアドレスを使用してください。
  • ビジネスのウェブサイトが最新の状態で公開されていることを確認します。

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 ビジネス プロフィールのデータを編集する方法については、こちらのガイド をご覧ください。
  • オーナーまたは管理者のアクセス権: 販売者が Google ビジネス プロフィールの管理者として、サードパーティ パートナーが GBP のプライマリ オーナーとして追加されている場合、そのサードパーティ パートナーは販売者の認証情報を使用して GBP API を使用して GBP のデータを編集し、アクセスする必要はありません。

    注: サードパーティ パートナーは、自身を GBP のオーナーとして追加せず、管理者として追加することを強くおすすめします。

ビジネスの拠点が 10 か所以上ある場合、一括でオーナー確認を行う方法はありますか?

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

各種 API の割り当て上限

標準の割り当て上限は、使用量上限に記載されています。上限を引き上げる必要がある場合は、標準の割り当てリクエストを送信してください。

リクエストできる割り当てはどれくらいですか?

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

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

いいえ。残念ながら、GBP の UI または API を使って本番環境で偽の GBP 掲載情報を直接作成してテストする方法はありません。

偽造リスティングのほとんどは、Google のモデレーションによって報告され、停止されています。クライアント リスティングを使用して営業時間外に作業を行うか(リスティングの主要な情報(名前、住所、カテゴリなど)は変更しない場合)、または本社のリスティングを作成します。API レスポンスをテストして、リスティングの確認など、本番環境のリスティングを必要とするアクションをテストする場合は、モック API レスポンスを使用できます。