Interfejs
Google Business Performance API udostępnia
NOWĄ metodę interfejsu API, która umożliwia pobieranie wielu parametrów „DailyMetrics” w jednym żądaniu API.
Zapoznaj się z
harmonogramem wycofywania i instrukcjami, jak przejść z metody raportu API w wersji 4 na interfejs Google Business Profile Performance API.
Method: categories.batchGet
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zwraca listę kategorii biznesowych dla podanego języka i identyfikatorów GConcept.
Żądanie HTTP
GET https://mybusiness.googleapis.com/v4/categories:batchGet
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
| Parametry |
languageCode |
string
Wymagane. Kod języka BCP 47, w którym powinny być zwracane nazwy kategorii.
|
categoryIds[] |
string
Wymagane. Musisz ustawić co najmniej jedną nazwę. Identyfikatory GConcept, dla których zlokalizowane nazwy kategorii powinny zostać zwrócone.
|
regionCode |
string
Opcjonalnie: Kod kraju zgodny ze standardem ISO 3166-1 alfa-2 używany do wnioskowania o języku niestandardowym.
|
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
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Komunikat odpowiedzi na temat kategorii BusinessCategory.BatchGetBusinessCategory.
| Zapis JSON |
{
"categories": [
{
object (Category)
}
]
} |
| Pola |
categories[] |
object (Category)
Kategorie pasujące do identyfikatorów GConcept podanych w żądaniu. Nie będą one pojawiały się w tej samej kolejności co identyfikatory kategorii w żądaniu.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eReturns localized business category names for specified GConcept IDs and language.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing GConcept IDs and language code as query parameters in a GET request.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of categories matching the provided GConcept IDs.\u003c/p\u003e\n"],["\u003cp\u003eRequires \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 for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: categories.batchGet\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.BatchGetBusinessCategoriesResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of business categories for the provided language and GConcept ids.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/categories:batchGet`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `languageCode` | `string` Required. The BCP 47 code of language that the category names should be returned in. |\n| `categoryIds[]` | `string` Required. At least one name must be set. The GConcept ids the localized category names should be returned for. |\n| `regionCode` | `string` Optional. The ISO 3166-1 alpha-2 country code used to infer non-standard language. |\n| `view` | `enum (`[CategoryView](/my-business/reference/rest/v4/CategoryView)`)` Required. 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:\nResponse message for BusinessCategories.BatchGetBusinessCategories.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------|---|\n| ``` { \"categories\": [ { object (/my-business/reference/rest/v4/categories#Category) } ] } ``` |\n\n| Fields ||\n|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `categories[]` | `object (`[Category](/my-business/reference/rest/v4/categories#Category)`)` Categories that match the GConcept ids provided in the request. They will not come in the same order as category ids in the request. |\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)."]]
