Method: accounts.locations.fetchVerificationOptions

تعمل هذه السياسة على الإبلاغ عن جميع خيارات إثبات الملكية المؤهّلة لموقع جغرافي معيّن بلغة معيّنة.

طلب HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:fetchVerificationOptions

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

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

المَعلمات
name

string

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

نص الطلب

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

تمثيل JSON 
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
الحقول
languageCode

string

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

object (ServiceBusinessContext)

معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية مطلوب للمواقع الجغرافية التي يكون نوع النشاط التجاري فيها CUSTOMER_LOCATION_ONLY. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أنشطة تجارية أخرى من المواقع.

نص الاستجابة

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

رسالة الرد لـverifications.FetchPendingOptions.

تمثيل JSON 
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
الحقول
options[]

object (VerificationOption)

خيارات إثبات الملكية المتاحة.

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

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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

VerificationOption

يمثّل خيار إثبات الملكية طريقة إثبات ملكية الموقع الجغرافي (الموضّحة من خلال طريقة إثبات الملكية) والمكان الذي سيتم إرسال إثبات الملكية إليه (المحدَّد من خلال بيانات العرض).

تمثيل JSON 
{
  "verificationMethod": enum (VerificationMethod),

  // Union field DisplayData can be only one of the following:
  "phoneData": {
    object (PhoneVerificationData)
  },
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  }
  // End of list of possible types for union field DisplayData.
}
الحقول
verificationMethod

enum (VerificationMethod)

طريقة للتحقق من الموقع.
حقل الاتحاد DisplayData إحدى بيانات العرض يجب أن تتطابق البيانات مع الطريقة. يكون هذا الحقل فارغًا إذا لم تتضمّن الطريقة المقابلة أي بيانات عرض. يمكن أن تكون السمة "DisplayData" واحدة فقط مما يلي:
phoneData

object (PhoneVerificationData)

لا يتم تعيينها إلا إذا كانت الطريقة هي PHONE_CALL أو رسالة SMS.
addressData

object (AddressVerificationData)

لا يتم التعيين إلا إذا كانت الطريقة هي يسر.
emailData

object (EmailVerificationData)

لا يتم التعيين إلا إذا كانت الطريقة هي EMAIL.

PhoneVerificationData

عرض البيانات لعمليات التحقّق من خلال الهاتف، مثل المكالمات الهاتفية والرسائل القصيرة

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

string

رقم الهاتف الذي سيتم إرسال رقم التعريف الشخصي إليه

AddressVerificationData

عرض بيانات عمليات إثبات الملكية من خلال البطاقة البريدية.

تمثيل JSON 
{
  "businessName": string,
  "address": {
    object (PostalAddress)
  }
}
الحقول
businessName

string

اسم النشاط التجاري للتاجر.
address

object (PostalAddress)

العنوان الذي يمكن إرسال بطاقة بريدية إليه.

EmailVerificationData

يمكنك عرض بيانات عمليات إثبات الهوية عبر البريد الإلكتروني.

تمثيل JSON 
{
  "domainName": string,
  "userName": string,
  "isUserNameEditable": boolean
}
الحقول
domainName

string

اسم النطاق في عنوان البريد الإلكتروني. على سبيل المثال، "gmail.com" في foo@gmail.com
userName

string

اسم المستخدم في عنوان البريد الإلكتروني، مثل "foo" في foo@gmail.com
isUserNameEditable

boolean

ما إذا كان يُسمَح للعميل بتقديم اسم مستخدم مختلف.