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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
الحقول
method

enum (VerificationMethod)

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

string

اختياريّ. رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق.
context

object (ServiceBusinessContext)

اختياريّ. معلومات سياقية إضافية للتحقّق من المؤسسات الخدمية وهو مطلوب فقط للمواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. لإثبات صحة العنوان، سيتم استخدامه لإرسال بطاقة بريدية. بالنسبة إلى الطرق الأخرى، يجب أن تكون مماثلة للطريقة التي تم تمريرها إلى GetVerificationOptions. سيتم عرض INVALID_ARGUMENT إذا تم ضبطه لأنواع أخرى من المواقع الجغرافية للنشاط التجاري.
بيانات إدخال المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض يجب أن تتطابق البيانات مع الطريقة المطلوبة. اتركه فارغًا إذا لم تكن هناك حاجة إلى بيانات. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
emailAddress

string

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

لا يتم قبول عنوان بريد إلكتروني إلا إذا كان أحد العناوين التي يوفّرها locations.fetchVerificationOptions. إذا تم ضبط isUserNameEditable على "صحيح" في [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData]، يمكن للعميل تحديد اسم مستخدم مختلف (الجزء المحلي) ولكن يجب أن يتطابق مع اسم النطاق.
mailerContact

string

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

string

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

object (VerificationToken)

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

string

تمثّل هذه السمة الإدخال لطريقة TRUSTED_PARTNER، وهو رمز إثبات الملكية المرتبط بالموقع الجغرافي.
نهاية الحقول التي يستبعد كلّ منها الآخر

نص الاستجابة

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

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

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

object (Verification)

طلب التحقّق الذي تم إنشاؤه

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

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

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

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

VerificationToken

رمز مميّز أنشأه شريك معتمَد

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

string

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