تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
REST Resource: accounts.locations.verifications
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: التحقّق
تمثّل عملية إثبات الملكية محاولة إثبات ملكية في موقع جغرافي معيّن.
| الحقول |
name |
string
اسم المصدر الخاص بعملية التحقّق
|
method |
enum (VerificationMethod)
طريقة إثبات الملكية.
|
state |
enum (VerificationState)
حالة إثبات الملكية.
|
createTime |
string (Timestamp format)
الطابع الزمني عندما يتم طلب إثبات الملكية. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
VerificationMethod
تحدِّد هذه السياسة العمليات التي تستخدمها Google لإثبات ملكية موقع جغرافي.
| عمليات التعداد |
VERIFICATION_METHOD_UNSPECIFIED |
وستؤدي القيمة التلقائية إلى حدوث أخطاء. |
ADDRESS |
أرسِل بطاقة بريدية تتضمّن رقم التعريف الشخصي لإثبات الملكية إلى عنوان بريدي محدّد. يُستخدم رقم التعريف الشخصي لإكمال عملية إثبات الهوية من خلال Google. |
EMAIL |
أرسِل رسالة إلكترونية تتضمّن رقم التعريف الشخصي لإثبات الملكية إلى عنوان بريد إلكتروني محدّد. يُستخدم رقم التعريف الشخصي لإكمال عملية إثبات الهوية من خلال Google. |
PHONE_CALL |
يمكنك إجراء مكالمة هاتفية باستخدام رقم التعريف الشخصي لإثبات الملكية مع رقم هاتف معيّن. يُستخدم رقم التعريف الشخصي لإكمال عملية إثبات الهوية من خلال Google. |
SMS |
أرسِل رسالة قصيرة SMS تحتوي على رقم التعريف الشخصي لإثبات الملكية إلى رقم هاتف معين. يُستخدم رقم التعريف الشخصي لإكمال عملية إثبات الهوية من خلال Google. |
AUTO |
إثبات ملكية الموقع الجغرافي بدون اتخاذ إجراء إضافي من المستخدم قد لا يتوفّر هذا الخيار لجميع المواقع الجغرافية. |
VerificationState
جميع حالات إثبات الملكية الممكنة
| عمليات التعداد |
VERIFICATION_STATE_UNSPECIFIED |
وستؤدي القيمة التلقائية إلى حدوث أخطاء. |
PENDING |
عملية إثبات الملكية في انتظار المراجعة. |
COMPLETED |
اكتملت عملية إثبات الهوية. |
FAILED |
تعذّر إثبات الهوية. |
الطُرق |
|
|
تُكمل عملية إثبات الهوية من خلال PENDING. |
|
|
سرد عمليات إثبات ملكية موقع جغرافي، مرتبة حسب وقت الإنشاء |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eA verification in Google My Business represents an attempt to verify a location using various methods like address, email, phone, or SMS.\u003c/p\u003e\n"],["\u003cp\u003eVerification resources contain details like the method used, the verification state (pending, completed, or failed), and a timestamp indicating when the verification was initiated.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses can utilize the Google My Business API to manage verifications, including completing pending verifications and retrieving a list of past verifications for a specific location.\u003c/p\u003e\n"],["\u003cp\u003eDifferent verification methods are available, including postcard mailing, email, phone call, SMS, or automatic verification if eligible.\u003c/p\u003e\n"]]],["A verification tracks an attempt to verify a location, represented by a name, method, state, and creation timestamp. Verification methods include `ADDRESS` (postcard), `EMAIL`, `PHONE_CALL`, `SMS`, and `AUTO`. Verification states can be `PENDING`, `COMPLETED`, or `FAILED`. Key actions involve completing a pending verification and listing verifications for a location ordered by their creation date.\n"],null,["# REST Resource: accounts.locations.verifications\n\n- [Resource: Verification](#Verification)\n - [JSON representation](#Verification.SCHEMA_REPRESENTATION)\n- [VerificationMethod](#VerificationMethod)\n- [VerificationState](#VerificationState)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Verification\n----------------------\n\nA verification represents a verification attempt on a location.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"method\": enum (/my-business/reference/rest/v4/accounts.locations.verifications#VerificationMethod), \"state\": enum (/my-business/reference/rest/v4/accounts.locations.verifications#VerificationState), \"createTime\": string } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of the verification. |\n| `method` | `enum (`[VerificationMethod](/my-business/reference/rest/v4/accounts.locations.verifications#VerificationMethod)`)` The method of the verification. |\n| `state` | `enum (`[VerificationState](/my-business/reference/rest/v4/accounts.locations.verifications#VerificationState)`)` The state of the verification. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` The timestamp when the verification is requested. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n\nVerificationMethod\n------------------\n\nSpecifies the processes used by Google to verify a location.\n\n| Enums ||\n|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| `VERIFICATION_METHOD_UNSPECIFIED` | Default value, will result in errors. |\n| `ADDRESS` | Send a postcard with a verification PIN to a specific mailing address. The PIN is used to complete verification with Google. |\n| `EMAIL` | Send an email with a verification PIN to a specific email address. The PIN is used to complete verification with Google. |\n| `PHONE_CALL` | Make a phone call with a verification PIN to a specific phone number. The PIN is used to complete verification with Google. |\n| `SMS` | Send an SMS with a verification PIN to a specific phone number. The PIN is used to complete verification with Google. |\n| `AUTO` | Verify the location without additional user action. This option may not be available for all locations. |\n\nVerificationState\n-----------------\n\nAll possible verification states.\n\n| Enums ||\n|----------------------------------|---------------------------------------|\n| `VERIFICATION_STATE_UNSPECIFIED` | Default value, will result in errors. |\n| `PENDING` | The verification is pending. |\n| `COMPLETED` | The verification is completed. |\n| `FAILED` | The verification is failed. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|-----------------------------------------------------------|\n| ### [complete](/my-business/reference/rest/v4/accounts.locations.verifications/complete) | Completes a `PENDING` verification. |\n| ### [list](/my-business/reference/rest/v4/accounts.locations.verifications/list) | List verifications of a location, ordered by create time. |"]]
