Method: accounts.listRecommendGoogleLocations

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

個人アカウント向けの最適化案は、ユーザーがビジネス プロフィールでアクセスできるすべてのビジネス情報（地域グループを通じてアクセスできるビジネス情報を含む）に基づいており、ユーザー向けに生成されるすべての最適化案のスーパーセットです。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
name

string

推奨される Google ビジネスを取得するアカウント リソースの名前。

クエリ パラメータ

パラメータ
pageSize

integer

ページあたりで取得するビジネス情報の数です。デフォルトは 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 の概要をご覧ください。