Method: accounts.locations.verify

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

طلب HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/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:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
الحقول
method

enum (VerificationMethod)

طريقة التحقق.
languageCode

string

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

object (ServiceBusinessContext)

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

object (EmailInput)

إدخال أسلوب EMAIL.
addressInput

object (AddressInput)

إدخال لطريقة ADDRESS.
phoneInput

object (PhoneInput)

إدخال طريقة PHONE_CALL/SMS

نص الاستجابة

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

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

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

object (Verification)

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

نطاقات التفويض

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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

EmailInput

حقل التحقق من EMAIL

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

string

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

لا يتم قبول عنوان البريد الإلكتروني إلا إذا كان أحد العناوين التي قدّمتها المواقع الجغرافية.fetchfetchOptions. في حال ضبط الحقل isUserNameEditable على "صحيح" في EmailVerificationData، قد يحدد العميل اسم مستخدم مختلفًا (الجزء المحلي) ولكن يجب أن يتطابق مع اسم النطاق.

AddressInput

حقل لإثبات ملكية ADDRESS.

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

string

اسم جهة الاتصال الذي يجب إرسال البريد إليه.

PhoneInput

إدخال لتأكيد رقم الهاتف من خلال PHONE_CALL/الرسائل القصيرة SMS

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

string

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