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. سيتم طرح القيمة القائلة ضياء زياد كالعادة إذا تم تعيينها لأنواع أنشطة تجارية أخرى.

نص الاستجابة

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

رسالة استجابة لـ Verifications.Fetch VerificationOptions.

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

لا يتم الضبط إلا إذا كانت الطريقة هي mail.
emailData

object (EmailVerificationData)

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

PhoneVerificationData

عرض البيانات لعمليات إثبات الملكية من خلال الهاتف، على سبيل المثال: مكالمة هاتفية، رسائل قصيرة SMS.

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

ما إذا كان مسموحًا للعميل بتقديم اسم مستخدم مختلف