Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: categories.batchGet
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فهرستی از دسته‌های کسب‌وکار را برای زبان ارائه‌شده و شناسه‌های GConcept برمی‌گرداند.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/categories:batchGet
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
languageCode | string مورد نیاز. کد زبان BCP 47 که نام دسته ها باید به آن بازگردانده شوند. |
categoryIds[] | string مورد نیاز. حداقل یک نام باید تنظیم شود. شناسه‌های GConcept که نام‌های دسته‌بندی بومی‌سازی شده برای آنها باید بازگردانده شوند. |
regionCode | string اختیاری. کد کشور ISO 3166-1 آلفا-2 برای استنباط زبان غیر استاندارد استفاده می شود. |
view | enum ( CategoryView ) مورد نیاز. مشخص می کند که کدام بخش از منبع Category باید در پاسخ بازگردانده شود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای BusinessCategories.BatchGetBusinessCategories.
| نمایندگی JSON |
|---|
{
"categories": [
{
object (Category)
}
]
} |
| فیلدها |
|---|
categories[] | object ( Category ) دسته‌هایی که با شناسه‌های GConcept ارائه شده در درخواست مطابقت دارند. آنها به همان ترتیب شناسه های دسته در درخواست قرار نمی گیرند. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/plus.business.manage -
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
