Method: categories.list

業種のリストを返します。検索ではカテゴリ名は一致しますが、カテゴリ ID とは一致しません。

HTTP リクエスト

GET https://mybusiness.googleapis.com/v4/categories

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

クエリ パラメータ

パラメータ
regionCode

string

ISO 3166-1 alpha-2 の国コード。

languageCode

string

言語の BCP 47 コード。利用できない言語は、デフォルトで英語に設定されます。

searchTerm

string

ユーザーからのフィルタ文字列(省略可)。

pageSize

integer

1 ページあたりで取得するカテゴリの数です。デフォルトは 100 で、最小値は 1、最大ページサイズは 100 です。

pageToken

string

指定すると、カテゴリの次のページが取得されます。

view

enum (CategoryView)

省略可。レスポンスで Category リソースに返すパートを指定します。

リクエスト本文

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

レスポンスの本文

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

JSON 表現
{
  "categories": [
    {
      object (Category)
    }
  ],
  "totalCategoryCount": integer,
  "nextPageToken": string
}
フィールド
categories[]

object (Category)

カテゴリ。カテゴリは基本的なビューです。ServiceType 情報は含まれません。

totalCategoryCount

integer

リクエスト パラメータのカテゴリの合計数。

nextPageToken

string

カテゴリの数がリクエストしたページサイズを超えた場合、このフィールドには、後続の categories.list の呼び出しでカテゴリの次のページを取得するためのトークンが入力されます。

認可スコープ

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

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

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