Method: categories.list

  • Returns a list of business categories, matching the front of the category name with the search term.

  • Sends an HTTP GET request to https://mybusiness.googleapis.com/v4/categories with optional parameters for filtering and pagination.

  • The response includes an array of categories, the total category count, and a token for fetching subsequent pages if available.

  • Requires authorization with either https://www.googleapis.com/auth/plus.business.manage or https://www.googleapis.com/auth/business.manage scope.

Returns a list of business categories. Search will match the category name but not the category ID.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
regionCode

string

The ISO 3166-1 alpha-2 country code.
languageCode

string

The BCP 47 code of language. If the language is not available, it will default to English.
searchTerm

string

Optional filter string from user.
pageSize

integer

How many categories to fetch per page. Default is 100, minimum is 1, and maximum page size is 100.
pageToken

string

If specified, the next page of categories will be fetched.
view

enum (CategoryView)

Optional. Specifies which parts to the Category resource should be returned in the response.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "categories": [
    {
      object (Category)
    }
  ],
  "totalCategoryCount": integer,
  "nextPageToken": string
}
Fields
categories[]

object (Category)

The categories. Categories are BASIC view. They don't contain any ServiceType information.
totalCategoryCount

integer

The total number of categories for the request parameters.
nextPageToken

string

If the number of categories exceeded the requested page size, this field will be populated with a token to fetch the next page of categories on a subsequent call to categories.list.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.