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

نص الاستجابة

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

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

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

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

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