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_{9} إذا تم تعيينه لأنواع أنشطة تجارية أخرى من المواقع.

نص الاستجابة

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

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

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

object (VerificationOption)

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

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

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

  • 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:
  "phoneNumber": string,
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  },
  "announcement": string
  // End of list of possible types for union field DisplayData.
}
الحقول
verificationMethod

enum (VerificationMethod)

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

string

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

object (AddressVerificationData)

لا يتم التعيين إلا إذا كانت الطريقة هي يسر.
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

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