Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.locations.verifications.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تأییدیه‌های یک مکان را که بر اساس زمان ایجاد مرتب شده‌اند فهرست کنید.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/verifications
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string نام منبع مکانی که درخواست های تأیید به آن تعلق دارد. |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer در هر صفحه چه تعداد تأییدیه باید لحاظ شود. اگر تنظیم نشد، همه را برگردانید. |
pageToken | string اگر مشخص شده باشد، صفحه بعدی تأیید را برمی‌گرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای Verifications.ListVerifications.
| نمایندگی JSON |
|---|
{
"verifications": [
{
object (Verification)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
verifications[] | object ( Verification ) لیست تاییدیه ها |
nextPageToken | string اگر تعداد تأییدها از اندازه صفحه درخواستی بیشتر شود، این فیلد با یک نشانه پر می شود تا در تماس بعدی صفحه بعدی تأیید را واکشی کند. اگر هیچ ویژگی دیگری وجود نداشته باشد، این فیلد در پاسخ وجود نخواهد داشت. |
محدوده مجوز
به یکی از حوزه های 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\u003eLists location verifications, ordered by creation time, using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of verifications and a token for retrieving subsequent pages, if applicable.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, such as \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes retrieving location verifications via a `GET` request to `https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/verifications`. Key actions include: specifying the `parent` path parameter for the location and using optional `pageSize` and `pageToken` query parameters for pagination. The request body must be empty. The response contains a list of `verifications` and an optional `nextPageToken` for further pages. Authorization requires OAuth scopes `plus.business.manage` or `business.manage`.\n"],null,["# Method: accounts.locations.verifications.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListVerificationsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nList verifications of a location, ordered by create time.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/verifications`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------|\n| `parent` | `string` Resource name of the location that verification requests belong to. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many verification to include per page. If not set, return all. |\n| `pageToken` | `string` If specified, returns the next page of verifications. |\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 Verifications.ListVerifications.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"verifications\": [ { object (/my-business/reference/rest/v4/accounts.locations.verifications#Verification) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `verifications[]` | `object (`[Verification](/my-business/reference/rest/v4/accounts.locations.verifications#Verification)`)` List of the verifications. |\n| `nextPageToken` | `string` If the number of verifications exceeded the requested page size, this field will be populated with a token to fetch the next page of verification on a subsequent call. If there are no more attributes, this field will not be present in the response. |\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)."]]
