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.fetchverificationOptions. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أخرى من المواقع الجغرافية للنشاط التجاري.
حقل الاتحاد RequestData بيانات يدخلها المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض يجب أن تتطابق البيانات مع الطريقة المطلوبة. ويمكنك تركه فارغًا إذا لم تكن هناك حاجة إلى البيانات. يمكن أن تكون السمة "RequestData" واحدة فقط مما يلي:
emailInput

object (EmailInput)

إدخال طريقة EMAIL.
addressInput

object (AddressInput)

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

object (PhoneInput)

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

نص الاستجابة

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

رسالة رد لإثبات ملكية الموقع الإلكتروني التحقّق من الموقع الجغرافي

تمثيل 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

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

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

AddressInput

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

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

string

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

PhoneInput

إدخال لتأكيد رقم الهاتف PHONE_CALL/SMS

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

string

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