指定したビジネス プロフィール アカウントにおすすめされたすべてのGoogleLocation
のリストを表示します。最適化案は個人アカウントとビジネス グループに対してのみ提供されます。他のすべてのアカウント タイプをリクエストするとエラーになります。ビジネス グループの最適化案は、そのグループ内のビジネスに基づいて表示されます。
個人アカウントに関する推奨事項は、ユーザーがビジネス プロフィールでアクセス権を持っているすべてのビジネス情報(ビジネス グループを通じてアクセスできるビジネス情報を含む)に基づいており、このユーザーに対して生成されるすべての推奨事項のスーパーセットです。
HTTP リクエスト
GET https://mybusiness.googleapis.com/v4/{name=accounts/*}:recommendGoogleLocations
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
name |
おすすめの Google ビジネスを取得するアカウント リソースの名前。 |
クエリ パラメータ
パラメータ | |
---|---|
pageSize |
1 ページあたりで取得するビジネス情報の数。デフォルトは 25 で、最小値は 1、最大ページサイズは 100 です。 |
pageToken |
指定すると、ビジネスの次のページが取得されます。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
GoogleLocations.ListRecommendedGoogleLocations に対するレスポンス メッセージです。
また、前回このビジネス プロフィール アカウントにおすすめされた後で、他のビジネス プロフィール ユーザーが申請したビジネス情報も含まれます。
JSON 表現 | |
---|---|
{
"googleLocations": [
{
object ( |
フィールド | |
---|---|
googleLocations[] |
ビジネス プロフィール アカウントに推奨されるビジネス拠点。それぞれがマップに存在する |
totalSize |
このビジネス プロフィール アカウントで推奨されるビジネス拠点の合計数です。ページ分けは考慮されません。 |
nextPageToken |
ページ分けの際に、次のページで取得できるビジネス情報がある場合、このフィールドには、後続の呼び出しでビジネスの次のページを取得するためのトークンが入力されます。取得するビジネスがそれ以上ない場合、このフィールドはレスポンスに含められません。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
詳細については、OAuth 2.0 の概要をご覧ください。