Method: accounts.locations.list

指定したアカウントのビジネスを一覧表示します。

HTTP リクエスト

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*}/locations

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

パスパラメータ

パラメータ
parent

string

ビジネスを取得するアカウントの名前です。Account が AccountType 個人用の場合、そのアカウントが直接所有しているビジネス情報のみが返されます。それ以外の場合は、アカウントからアクセスできるすべてのビジネス情報が、直接的または間接的に返されます。

クエリ パラメータ

パラメータ
pageSize

integer

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

string

指定すると、次の page 個のビジネスが取得されます。以前の locations.list の呼び出しによって、リクエストしたページサイズを超える場所があったときにページトークンが返されます。
filter

string

返されるビジネスを制限するフィルタ。レスポンスには、フィルタに一致するエントリのみが含まれます。filter が空の場合、制約が適用され、リクエストされたアカウントのすべてのビジネス情報（ページ分けあり）が取得されます。

有効なフィールドと使用例について詳しくは、位置情報の使用に関するガイドをご覧ください。
languageCode
(deprecated)

string

表示位置のプロパティを取得する言語の BCP 47 コード。この言語を使用できない場合は、その場所の言語で提供されます。どちらも使用できない場合は、英語で提供されます。

非推奨です。2020 年 8 月 15 日以降、このフィールドは適用されなくなります。代わりに、場所の言語が常に使用されます。
orderBy

string

リクエストの並べ替え順序。複数のフィールドは、SQL 構文に従ってカンマで区切る必要があります。デフォルトの並べ替え順は昇順です。降順を指定するには、末尾に「desc"追加する必要があります。orderBy で有効なフィールドは locationName と storeCode です。例: "locationName, storeCode desc"または「locationName」または「storeCode desc」

リクエスト本文

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

レスポンスの本文

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

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

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

object (Location)

ロケーション。
nextPageToken

string

ビジネスの数がリクエストしたページサイズを超えた場合、このフィールドには、後続の locations.list の呼び出しでビジネスの次のページを取得するためのトークンが入力されます。それ以上店舗がない場合、このフィールドはレスポンスに含まれません。
totalSize

integer

ページ分けに関係なく、リスト内のビジネスのおおよその数。

認可スコープ

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

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

詳しくは、OAuth 2.0 の概要をご覧ください。