Method: locations.verify

لبدء عملية إثبات ملكية الموقع الجغرافي.

طلب HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
name

string

مطلوب. اسم المورد للموقع الجغرافي المطلوب إثبات ملكيته

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
الحقول
method

enum (VerificationMethod)

مطلوب. طريقة التحقق.
languageCode

string

اختياريّ. رمز اللغة BCP 47 الذي يمثّل اللغة المستخدَمة في عملية إثبات الهوية.
context

object (ServiceBusinessContext)

اختياريّ. معلومات سياقية إضافية لإثبات ملكية الأنشطة التجارية الخدمية وهو مطلوب فقط للمواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. بالنسبة إلى إثبات الملكية ADDRESS، سيتم استخدام العنوان لإرسال البطاقة البريدية. وبالنسبة إلى الطرق الأخرى، يجب أن يكون مطابقًا للطريقة التي تم تمريرها إلى GetVerifyOptions. سيتم طرح القيمة القائِلة القَيِّد على عالَم "الخطأ" إذا تم إعدادها لأنواع أخرى من المواقع الجغرافية للنشاط التجاري.
حقل الاتحاد RequestData. البيانات التي يُدخِلها المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض. يجب أن تتطابق البيانات مع الطريقة المطلوبة. ويمكنك ترك هذا الحقل فارغًا إذا لم تكن هناك حاجة إلى البيانات. يمكن أن يكون RequestData واحدًا فقط مما يلي:
emailAddress

string

اختياريّ. إدخال أسلوب EMAIL. عنوان البريد الإلكتروني الذي يجب إرسال رقم التعريف الشخصي إليه.

لا يتم قبول عنوان البريد الإلكتروني إلا إذا كان أحد العناوين التي قدّمتها المواقع الجغرافية.fetchfetchOptions. إذا كانت صفحة [EmailVerifyData] تم ضبط isUserNameEditable على "صحيح" في الحقل [google.mybusiness-verifications.v1.VerifyOption.Email VerificationData] صحيح، ويجوز للعميل تحديد اسم مستخدم مختلف (local-part) ولكن يجب أن يتطابق مع اسم النطاق
mailerContact

string

اختياريّ. إدخال لطريقة ADDRESS. اسم جهة الاتصال الذي يجب إرسال البريد إليه.
phoneNumber

string

اختياريّ. إدخال طريقة PHONE_CALL/الرسائل القصيرة SMS رقم الهاتف الذي يجب الاتصال به أو إرسال الرسائل القصيرة إليه. يجب أن يكون أحد أرقام الهواتف في الخيارات المؤهَّلة.
token

object (VerificationToken)

اختياريّ. يتوفّر إدخال لطريقة VETTED_PARTNER لاختيار الشركاء. ولا حاجة إلى الإدخال في حساب تم التدقيق فيه. الرمز المميّز المرتبط بالموقع الجغرافي الرمز المميّز المرتبط بالموقع الجغرافي

نص الاستجابة

رسالة ردّ على Verifys.VerifyLocation

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "verification": {
    object (Verification)
  }
}
الحقول
verification

object (Verification)

طلب إثبات الملكية الذي تم إنشاؤه

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

VerificationToken

الرمز المميّز الذي أنشأه شريك تم التحقّق منه

تمثيل JSON 
{
  "tokenString": string
}
الحقول
tokenString

string

سلسلة الرمز المميّز