Method: locations.fetchVerificationOptions

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

طلب HTTP

POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions

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

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

المعلمات
location

string

الحقل مطلوب. الموقع الجغرافي المطلوب التحقّق منه

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

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

string

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

object (ServiceBusinessContext)

اختياريّ. معلومات سياقية إضافية للتحقّق من المؤسسات الخدمية لا يمكن تطبيقها إلا على المواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. قد يؤدي تحديد عنوان دقيق إلى تفعيل المزيد من الخيارات. سيتم عرض INVALID_ARGUMENT إذا تم ضبطه لأنواع أخرى من المواقع الجغرافية للأنشطة التجارية.

نص الاستجابة

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

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

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

object (VerificationOption)

خيارات التحقّق المتاحة

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

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

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

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

VerificationOption

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "phoneNumber": string,
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  },
  "announcement": string
  // End of mutually exclusive fields.
}
الحقول
verificationMethod

enum (VerificationMethod)

طريقة تأكيد الموقع الجغرافي
إحدى بيانات العرض يجب أن تتطابق البيانات مع الطريقة. يكون هذا الحقل فارغًا إذا لم تتوفّر أي بيانات عرض للطريقة المقابلة. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
phoneNumber

string

يجب ضبط هذه السمة فقط إذا كانت الطريقة هي PHONE_CALL أو SMS. رقم الهاتف الذي سيتم إرسال رقم التعريف الشخصي إليه
addressData

object (AddressVerificationData)

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

object (EmailVerificationData)

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

string

يتم ضبط هذه السمة فقط إذا كانت الطريقة هي VETTED_PARTNER.
نهاية الحقول التي يستبعد كلّ منها الآخر

AddressVerificationData

عرض بيانات عمليات التحقّق من خلال بطاقة بريدية

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

string

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

object (PostalAddress)

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

integer

عدد الأيام المتوقّع لتسليم بطاقة بريدية إلى منطقة العنوان

EmailVerificationData

عرض بيانات عمليات التحقّق من خلال البريد الإلكتروني

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

string

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

string

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

boolean

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