تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.verifications.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
سرد عمليات إثبات ملكية موقع جغرافي، مرتبة حسب وقت الإنشاء
طلب HTTP
GET https://mybusinessverifications.googleapis.com/v1/{parent=locations/*}/verifications
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. اسم المورد للموقع الجغرافي الذي تنتمي إليه طلبات إثبات الملكية
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
عدد عمليات إثبات الملكية المطلوب تضمينها في كل صفحة الحد الأدنى هو 1، والحد الأقصى التلقائي والأقصى لحجم الصفحة هو 100.
|
pageToken |
string
في حالة تحديد هذا الخيار، يتم عرض الصفحة التالية من عمليات التحقق.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة ردّ على Verifys.ListVerifys
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"verifications": [
{
object (Verification)
}
],
"nextPageToken": string
} |
| الحقول |
verifications[] |
object (Verification)
قائمة عمليات إثبات الملكية
|
nextPageToken |
string
إذا تجاوز عدد عمليات إثبات الملكية حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من عملية إثبات الهوية في مكالمة لاحقة. إذا لم يتوفّر المزيد من السمات، لن يكون هذا الحقل متوفّرًا في الردّ.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://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\u003eThis document outlines how to list verifications for a specific location using the Google My Business Verifications API.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve a list of verifications, ordered by creation time, by sending a GET request to the specified endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe request allows for pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will contain a list of verifications and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: 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://mybusinessverifications.googleapis.com/v1/{parent=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` Required. 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. Minimum is 1, and the default and maximum page size is 100. |\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\nResponse message for Verifications.ListVerifications.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"verifications\": [ { object (/my-business/reference/verifications/rest/v1/Verification) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `verifications[]` | `object (`[Verification](/my-business/reference/verifications/rest/v1/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 the following OAuth scope:\n\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)."]]
