تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.verifications.complete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُكمل عملية إثبات الهوية من خلال PENDING.
وهو ضروري فقط لطرق إثبات الملكية التي لا تستخدم AUTO. يصبح طلب إثبات الملكية AUTO على الفور VERIFIED بعد الإنشاء.
طلب HTTP
POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*/verifications/*}:complete
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم المورد لإكمال عملية التحقّق
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"pin": string
} |
| الحقول |
pin |
string
مطلوب. رمز رقم التعريف الشخصي الذي استلمه التاجر لإكمال عملية إثبات الملكية.
|
نص الاستجابة
رسالة ردّ على Verifys.CompleteVerifyAction
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
verification |
object (Verification)
اكتملت عملية إثبات الهوية.
|
نطاقات الأذونات
يجب توفير نطاق 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 explains how to complete a pending verification for a business using the Google My Business Verifications API.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves sending a POST request to a specific endpoint with the verification's resource name and a PIN code.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a JSON object containing the PIN received by the merchant.\u003c/p\u003e\n"],["\u003cp\u003eA successful response will contain the completed verification details in the response body.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: locations.verifications.complete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CompleteVerificationResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nCompletes a `PENDING` verification.\n\nIt is only necessary for non `AUTO` verification methods. `AUTO` verification request is instantly `VERIFIED` upon creation.\n\n### HTTP request\n\n`POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*/verifications/*}:complete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the verification to complete. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------|\n| ``` { \"pin\": string } ``` |\n\n| Fields ||\n|-------|------------------------------------------------------------------------------------|\n| `pin` | `string` Required. PIN code received by the merchant to complete the verification. |\n\n### Response body\n\nResponse message for Verifications.CompleteVerificationAction.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"verification\": { object (/my-business/reference/verifications/rest/v1/Verification) } } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------|\n| `verification` | `object (`[Verification](/my-business/reference/verifications/rest/v1/Verification)`)` The completed verification. |\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)."]]
