Method: categories.list

Zwraca listę kategorii działalności. Wyszukiwanie zwróci nazwę kategorii, ale nie jej identyfikator.

Wyszukiwanie pasuje tylko do nazwy kategorii (np. hasło „jedzenie” może zwrócić hasło „Gastronomia”, ale nie „Restauracja typu fast food”).

Żądanie HTTP

GET https://mybusinessbusinessinformation.googleapis.com/v1/categories

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
regionCode

string

Wymagane. Kod kraju zgodny ze standardem ISO 3166-1 alfa-2.

languageCode

string

Wymagane. Kod języka BCP 47.

filter

string

Opcjonalnie: Filtruj ciąg znaków od użytkownika. Jedyne obsługiwane pole to displayName. Na przykład: filter=displayName=foo.

pageSize

integer

Opcjonalnie: Liczba kategorii do pobrania na stronę. Wartość domyślna to 100, minimum to 1, a maksymalny rozmiar strony to 100.

pageToken

string

Opcjonalnie: Jeśli określisz parametr, zostanie pobrana następna strona kategorii.

view

enum (CategoryView)

Wymagane. Określa, które części zasobu Category powinny zostać zwrócone w odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat z odpowiedzią na temat kategorii BusinessCategory.ListCategory.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "categories": [
    {
      object (Category)
    }
  ],
  "nextPageToken": string
}
Pola
categories[]

object (Category)

Kategorie dopasowania na podstawie żądanych parametrów.

nextPageToken

string

Jeśli liczba kategorii przekroczyła żądany rozmiar strony, pole to zostanie zapełnione tokenem umożliwiającym pobranie następnej strony kategorii przy kolejnym wywołaniu funkcji categories.list.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.