Google My Business API

Google My Business API は、Google でビジネス情報を管理するためのインターフェースを提供します。

サービス: mybusiness.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストを行う際に次の情報を使用します。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械可読仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスでは、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することがあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://mybusiness.googleapis.com

REST リソース: v4.accounts

Methods
create
(deprecated)		 POST /v4/accounts
指定された親の下に、指定された名前とタイプでアカウントを作成します。
deleteNotifications
(deprecated)		 DELETE /v4/{name=accounts/*/notifications}
アカウントの Pub/Sub 通知設定を消去します。
generateAccountNumber
(deprecated)		 POST /v4/{name=accounts/*}:generateAccountNumber
このアカウントのアカウント番号を生成します。
get
(deprecated)		 GET /v4/{name=accounts/*}
指定されたアカウントを取得します。
getNotifications
(deprecated)		 GET /v4/{name=accounts/*/notifications}
アカウントの Pub/Sub 通知設定を返します。
list
(deprecated)		 GET /v4/accounts
認証されたユーザーのすべてのアカウントを一覧表示します。
listRecommendGoogleLocations GET /v4/{name=accounts/*}:recommendGoogleLocations
指定したビジネス プロフィール アカウントにおすすめされたすべての GoogleLocation を一覧表示します。
update
(deprecated)		 PUT /v4/{name=accounts/*}
指定したビジネス アカウントを更新します。
updateNotifications
(deprecated)		 PUT /v4/{name=accounts/*/notifications}

アカウントの Pub/Sub 通知設定を設定して、Pub/Sub 通知を送信するトピックをビジネス プロフィールに指定します。

  • アカウントで管理しているビジネスに関する新しいクチコミです。

REST リソース: v4.accounts.admins

Methods
create
(deprecated)		 POST /v4/{parent=accounts/*}/admins
指定したユーザーを、指定したアカウントの管理者に招待します。
delete
(deprecated)		 DELETE /v4/{name=accounts/*/admins/*}
指定したアカウントから指定した管理者を削除します。
list
(deprecated)		 GET /v4/{parent=accounts/*}/admins
指定したアカウントの管理者を一覧表示します。
patch
(deprecated)		 PATCH /v4/{name=accounts/*/admins/*}
指定したアカウント管理者の管理者を更新します。

REST リソース: v4.accounts.invitations

Methods
accept
(deprecated)		 POST /v4/{name=accounts/*/invitations/*}:accept
指定した招待を承諾します。
decline
(deprecated)		 POST /v4/{name=accounts/*/invitations/*}:decline
指定した招待を辞退します。
list
(deprecated)		 GET /v4/{parent=accounts/*}/invitations
指定したアカウントで保留中の招待を一覧表示します。

REST リソース: v4.accounts.locations

Methods
associate POST /v4/{name=accounts/*/locations/*}:associate
ビジネスをプレイス ID に関連付けます。
batchGet POST /v4/{name=accounts/*}/locations:batchGet
指定されたアカウント内の指定されたビジネスすべてを取得します。
batchGetReviews POST /v4/{name=accounts/*}/locations:batchGetReviews
指定されたすべてのビジネスに関して、ページ分けされたクチコミのリストを返します。
clearAssociation POST /v4/{name=accounts/*/locations/*}:clearAssociation
ビジネスとそのプレイス ID の関連付けを解除します。
create POST /v4/{parent=accounts/*}/locations
指定されたアカウントによって所有される新しい location を作成して返します。
delete DELETE /v4/{name=accounts/*/locations/*}
ビジネスを削除します。
fetchVerificationOptions POST /v4/{name=accounts/*/locations/*}:fetchVerificationOptions
特定の言語で、ビジネスに対して有効なすべてのオーナー確認オプションを報告します。
findMatches POST /v4/{name=accounts/*/locations/*}:findMatches
指定されたビジネスに一致する可能性のあるすべてのビジネスを検索します。
get GET /v4/{name=accounts/*/locations/*}
指定されたビジネスを取得します。
getFoodMenus GET /v4/{name=accounts/*/locations/*/foodMenus}
特定の場所のフードメニューを返します。
getGoogleUpdated GET /v4/{name=accounts/*/locations/*}:googleUpdated
指定したビジネスの Google によって更新されたバージョンを取得します。
getHealthProviderAttributes GET /v4/{name=accounts/*/locations/*/healthProviderAttributes}
特定の場所の医療従事者の属性を返します。
getServiceList GET /v4/{name=accounts/*/locations/*/serviceList}
ビジネスの指定されたサービスリストを取得します。
list GET /v4/{parent=accounts/*}/locations
指定したアカウントのビジネスを一覧表示します。
patch PATCH /v4/{name=accounts/*/locations/*}
指定したビジネスを更新します。
reportInsights POST /v4/{name=accounts/*}/locations:reportInsights
1 つ以上の指標に関する分析情報を含むレポートを返します。
transfer
(deprecated)		 POST /v4/{name=accounts/*/locations/*}:transfer
ユーザーが所有するアカウントから、同じユーザーが管理する別のアカウントにビジネスを移動します。
updateFoodMenus PATCH /v4/{foodMenus.name=accounts/*/locations/*/foodMenus}
特定の場所のフードメニューを更新します。
updateHealthProviderAttributes PATCH /v4/{healthProviderAttributes.name=accounts/*/locations/*/healthProviderAttributes}
特定の場所の医療機関の属性を更新します。
updateServiceList PATCH /v4/{serviceList.name=accounts/*/locations/*/serviceList}
ビジネスの指定されたサービスリストを更新します。
verify POST /v4/{name=accounts/*/locations/*}:verify
ビジネスのオーナー確認プロセスを開始します。

REST リソース: v4.accounts.locations.admins

Methods
create
(deprecated)		 POST /v4/{parent=accounts/*/locations/*}/admins
指定したユーザーを、指定したビジネスの管理者として招待します。
delete
(deprecated)		 DELETE /v4/{name=accounts/*/locations/*/admins/*}
指定したビジネスの管理者として指定した Admin を削除します。
list
(deprecated)		 GET /v4/{parent=accounts/*/locations/*}/admins
指定したビジネスのすべての管理者を一覧表示します。
patch
(deprecated)		 PATCH /v4/{name=accounts/*/locations/*/admins/*}
指定したビジネス管理者の Admin を更新します。

REST リソース: v4.accounts.locations.followers

Methods
getMetadata GET /v4/{name=accounts/*/locations/*/followers/metadata}
ビジネス情報のフォロワー設定を取得します。

REST リソース: v4.accounts.locations.insuranceNetworks

Methods
list GET /v4/{parent=accounts/*/locations/*}/insuranceNetworks
Google がサポートするすべての保険ネットワークのリストを返します。

REST リソース: v4.accounts.locations.localPosts

Methods
create POST /v4/{parent=accounts/*/locations/*}/localPosts
指定したビジネスに関連付けられた新しいローカル投稿を作成して返します。
delete DELETE /v4/{name=accounts/*/locations/*/localPosts/*}
ローカル投稿を削除します。
get GET /v4/{name=accounts/*/locations/*/localPosts/*}
指定されたローカル投稿を取得します。
list GET /v4/{parent=accounts/*/locations/*}/localPosts
ビジネスに関連付けられているローカル投稿のリストを返します。
patch PATCH /v4/{name=accounts/*/locations/*/localPosts/*}
指定したローカル投稿を更新し、更新されたローカル投稿を返します。
reportInsights POST /v4/{name=accounts/*/locations/*}/localPosts:reportInsights
1 つのリスティングに関連付けられた一連のローカル投稿の分析情報を返します。

REST リソース: v4.accounts.locations.media

Methods
create POST /v4/{parent=accounts/*/locations/*}/media
ビジネスの新しいメディア アイテムを作成します。
delete DELETE /v4/{name=accounts/*/locations/*/media/*}
指定されたメディア アイテムを削除します。
get GET /v4/{name=accounts/*/locations/*/media/*}
リクエストされたメディア アイテムのメタデータを返します。
list GET /v4/{parent=accounts/*/locations/*}/media
ビジネスに関連付けられているメディア アイテムのリストを返します。
patch PATCH /v4/{name=accounts/*/locations/*/media/*}
指定したメディア アイテムのメタデータを更新します。
startUpload POST /v4/{parent=accounts/*/locations/*}/media:startUpload
メディア アイテムをアップロードするための MediaItemDataRef を生成します。

REST リソース: v4.accounts.locations.media.customers

Methods
get GET /v4/{name=accounts/*/locations/*/media/customers/*}
リクエストされた顧客のメディア アイテムのメタデータを返します。
list GET /v4/{parent=accounts/*/locations/*}/media/customers
顧客から提供されたビジネスに関連付けられているメディア アイテムのリストを返します。

REST リソース: v4.accounts.locations.questions

Methods
create POST /v4/{parent=accounts/*/locations/*}/questions
指定したビジネスに質問を追加します。
delete DELETE /v4/{name=accounts/*/locations/*/questions/*}
現在のユーザーが書いた特定の質問を削除します。
list GET /v4/{parent=accounts/*/locations/*}/questions
指定したビジネスに関する質問とその回答の一部を、ページ分けされたリストで返します。
patch PATCH /v4/{name=accounts/*/locations/*/questions/*}
現在のユーザーが書いた特定の質問を更新します。

REST リソース: v4.accounts.locations.questions.answers

Methods
delete DELETE /v4/{parent=accounts/*/locations/*/questions/*}/answers:delete
質問に対して現在のユーザーが書いた回答を削除します。
list GET /v4/{parent=accounts/*/locations/*/questions/*}/answers
指定された質問に対する回答を、ページ分けされたリストで返します。
upsert POST /v4/{parent=accounts/*/locations/*/questions/*}/answers:upsert
指定した質問に対して回答を作成するか、ユーザーが書いた既存の回答を更新します。

REST リソース: v4.accounts.locations.reviews

Methods
deleteReply DELETE /v4/{name=accounts/*/locations/*/reviews/*}/reply
指定したクチコミへの返信を削除します。
get GET /v4/{name=accounts/*/locations/*/reviews/*}
指定されたクチコミを返します。
list GET /v4/{parent=accounts/*/locations/*}/reviews
指定されたビジネスに対するクチコミのページ分けされたリストを返します。
updateReply PUT /v4/{name=accounts/*/locations/*/reviews/*}/reply
指定したクチコミへの返信を更新します。

REST リソース: v4.accounts.locations.verifications

Methods
complete POST /v4/{name=accounts/*/locations/*/verifications/*}:complete
PENDING のオーナー確認を完了します。
list GET /v4/{parent=accounts/*/locations/*}/verifications
ビジネスのオーナー確認を、作成時間順に一覧表示します。

REST リソース: v4.attributes

Methods
list GET /v4/attributes
指定されたメインカテゴリと国のビジネスで使用可能な属性のリストを返します。

REST リソース: v4.categories

Methods
batchGet GET /v4/categories:batchGet
指定された言語と GConcept ID に対応するビジネス カテゴリのリストを返します。
list GET /v4/categories
業種のリストを返します。

REST リソース: v4.chains

Methods
get GET /v4/{name=chains/*}
指定されたチェーンを取得します。
search GET /v4/chains:search
チェーン名に基づいてチェーンを検索します。

REST リソース: v4.googleLocations

Methods
report POST /v4/{name=googleLocations/*}:report
GoogleLocation を報告します。
search POST /v4/googleLocations:search
指定したリクエストに一致する可能性のあるすべてのビジネスを検索します。

サービス: mybusiness.googleapis.com

このサービスを呼び出すには、Google が提供するクライアント ライブラリを使用することをおすすめします。アプリケーションで独自のライブラリを使用してこのサービスを呼び出す必要がある場合は、API リクエストを行う際に次の情報を使用します。

ディスカバリ ドキュメント

ディスカバリ ドキュメントは、REST API を記述して使用するための機械可読仕様です。クライアント ライブラリ、IDE プラグイン、Google API と連携するその他のツールのビルドに使用されます。1 つのサービスで複数のディスカバリ ドキュメントを提供できます。このサービスでは、次のディスカバリ ドキュメントが用意されています。

サービス エンドポイント

サービス エンドポイントは、API サービスのネットワーク アドレスを指定するベース URL です。1 つのサービスに複数のサービス エンドポイントが存在することがあります。このサービスには次のサービス エンドポイントがあり、以下のすべての URI がこのサービス エンドポイントに関連しています。

  • https://mybusiness.googleapis.com

REST リソース: v1.media

Methods
upload POST /v1/media/{resourceName=**}
POST /upload/v1/media/{resourceName=**}
メディアをアップロードします。