تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.locations.verifications.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
سرد عمليات إثبات ملكية موقع جغرافي، مرتبة حسب وقت الإنشاء
طلب HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/verifications
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
اسم المورد للموقع الجغرافي الذي تنتمي إليه طلبات إثبات الملكية
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
عدد عمليات إثبات الملكية المطلوب تضمينها في كل صفحة وفي حال تركها بدون ضبط، يمكنك عرض الكل.
|
pageToken |
string
في حالة تحديد هذا الخيار، يتم عرض الصفحة التالية من عمليات التحقق.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ على Verifys.ListVerifys
| تمثيل JSON |
{
"verifications": [
{
object (Verification)
}
],
"nextPageToken": string
} |
| الحقول |
verifications[] |
object (Verification)
قائمة عمليات إثبات الملكية
|
nextPageToken |
string
إذا تجاوز عدد عمليات إثبات الملكية حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من عملية إثبات الهوية في مكالمة لاحقة. إذا لم يتوفّر المزيد من السمات، لن يكون هذا الحقل متوفّرًا في الردّ.
|
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.managehttps://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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)."]]
