Method: accounts.listRecommendGoogleLocations

指定したビジネス プロフィール アカウントにおすすめされたすべてのGoogleLocationのリストを表示します。最適化案は個人アカウントとビジネス グループに対してのみ提供されます。他のすべてのアカウント タイプをリクエストするとエラーになります。ビジネス グループの最適化案は、そのグループ内のビジネスに基づいて表示されます。

個人アカウントに関する推奨事項は、ユーザーがビジネス プロフィールでアクセス権を持っているすべてのビジネス情報(ビジネス グループを通じてアクセスできるビジネス情報を含む)に基づいており、このユーザーに対して生成されるすべての推奨事項のスーパーセットです。

HTTP リクエスト

GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

おすすめの Google ビジネスを取得するアカウント リソースの名前。

クエリ パラメータ

パラメータ
pageSize

integer

1 ページあたりで取得するビジネス情報の数。デフォルトは 25 で、最小値は 1、最大ページサイズは 100 です。

pageToken

string

指定すると、ビジネスの次のページが取得されます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

GoogleLocations.ListRecommendedGoogleLocations に対するレスポンス メッセージです。

また、前回このビジネス プロフィール アカウントにおすすめされた後で、他のビジネス プロフィール ユーザーが申請したビジネス情報も含まれます。

JSON 表現
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
フィールド
googleLocations[]

object (GoogleLocation)

ビジネス プロフィール アカウントに推奨されるビジネス拠点。それぞれがマップに存在する GoogleLocation を表します。ビジネス情報は、ビジネス プロフィール アカウントとの関連性が高い順に並べられます。

totalSize

integer

このビジネス プロフィール アカウントで推奨されるビジネス拠点の合計数です。ページ分けは考慮されません。

nextPageToken

string

ページ分けの際に、次のページで取得できるビジネス情報がある場合、このフィールドには、後続の呼び出しでビジネスの次のページを取得するためのトークンが入力されます。取得するビジネスがそれ以上ない場合、このフィールドはレスポンスに含められません。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

詳細については、OAuth 2.0 の概要をご覧ください。