Für die Google Business Performance API gibt es eine NEUE API-Methode, mit der sich mehrere „DailyMetrics“-Objekte in einer einzelnen Anfrage abrufen lassen. Sehen Sie sich den Zeitplan für die Einstellung und die Anleitung für die Migration von der reportInsights API-Methode Version 4 zur Google Business Profile Performance API an.
Der BCP 47-Sprachcode. Ist die Sprache nicht verfügbar, wird standardmäßig Englisch verwendet.
searchTerm
string
Optionaler Filterstring des Nutzers.
pageSize
integer
Die Anzahl der Kategorien, die pro Seite abgerufen werden sollen. Die Standardeinstellung ist 100, die Mindestanzahl ist 1 und die maximale Seitengröße 100.
pageToken
string
Wenn angegeben, wird die nächste Seite mit Kategorien abgerufen.
Die Kategorien. Die Kategorien werden in der BASIS-Ansicht angezeigt. Sie enthalten keine ServiceType-Informationen.
totalCategoryCount
integer
Die Gesamtzahl der Kategorien für die Anfrageparameter.
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 Kategorieseite abzurufen.
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eReturns a list of business categories, matching the front of the category name with the search term.\u003c/p\u003e\n"],["\u003cp\u003eSends an HTTP GET request to \u003ccode\u003ehttps://mybusiness.googleapis.com/v4/categories\u003c/code\u003e with optional parameters for filtering and pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of categories, the total category count, and a token for fetching subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines retrieving a list of business categories via a `GET` request to `https://mybusiness.googleapis.com/v4/categories`. Requests can be filtered using query parameters like `regionCode`, `languageCode`, `searchTerm`, `pageSize`, `pageToken`, and `view`. The request body must be empty. The successful response contains an array of `categories`, `totalCategoryCount`, and optionally `nextPageToken`. Authorization requires either `plus.business.manage` or `business.manage` OAuth scopes. Category name searches only match the start of names.\n"],null,["# Method: categories.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListBusinessCategoriesResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of business categories. Search will match the category name but not the category ID.\n\n\u003cbr /\u003e\n\n| **Note:** Search only matches the front of a category name (that is, 'food' may return 'Food Court' but not 'Fast Food Restaurant').\n\n\u003cbr /\u003e\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/categories`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `regionCode` | `string` The ISO 3166-1 alpha-2 country code. |\n| `languageCode` | `string` The BCP 47 code of language. If the language is not available, it will default to English. |\n| `searchTerm` | `string` Optional filter string from user. |\n| `pageSize` | `integer` How many categories to fetch per page. Default is 100, minimum is 1, and maximum page size is 100. |\n| `pageToken` | `string` If specified, the next page of categories will be fetched. |\n| `view` | `enum (`[CategoryView](/my-business/reference/rest/v4/CategoryView)`)` Optional. Specifies which parts to the Category resource should be returned in the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"categories\": [ { object (/my-business/reference/rest/v4/categories#Category) } ], \"totalCategoryCount\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `categories[]` | `object (`[Category](/my-business/reference/rest/v4/categories#Category)`)` The categories. Categories are BASIC view. They don't contain any ServiceType information. |\n| `totalCategoryCount` | `integer` The total number of categories for the request parameters. |\n| `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`. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
