Method: categories.list

Gibt eine Liste mit Unternehmenskategorien zurück Die Suche entspricht dem Kategorienamen, aber nicht der Kategorie-ID.

Bei der Suche wird nur nach dem ersten Namen einer Kategorie gesucht (d. h. bei „Essen“ kann „Gericht“ zurückgegeben werden, aber nicht „Fast-Food-Restaurant“).

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
regionCode

string

Erforderlich. Der Ländercode nach ISO 3166-1 alpha-2.
languageCode

string

Erforderlich. Der BCP-47-Sprachcode.
filter

string

Optional. Filterstring des Nutzers Das einzige unterstützte Feld ist displayName. Beispiel: filter=displayName=foo.
pageSize

integer

Optional. Die Anzahl der Kategorien, die pro Seite abgerufen werden sollen. Die Standardeinstellung ist 100, die Mindestanzahl ist 1 und die maximale Seitengröße beträgt 100.
pageToken

string

Optional. Falls angegeben, wird die nächste Seite mit Kategorien abgerufen.
view

enum (CategoryView)

Erforderlich. Gibt an, welche Teile der Kategorieressource in der Antwort zurückgegeben werden sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für BusinessCategories.ListCategories.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "categories": [
    {
      object (Category)
    }
  ],
  "nextPageToken": string
}
Felder
categories[]

object (Category)

Die übereinstimmenden Kategorien basierend auf den angeforderten Parametern.
nextPageToken

string

Wenn die Anzahl der Kategorien die angeforderte Seitengröße überschreitet, wird dieses Feld mit einem Token gefüllt, um bei einem nachfolgenden Aufruf von categories.list die nächste Seite mit Kategorien abzurufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.