Method: locations.fetchVerificationOptions

همه گزینه های تأیید واجد شرایط را برای یک مکان به زبان خاصی گزارش می دهد.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 مراجعه کنید.

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 یا پیامک باشد. شماره تلفنی که پین ​​به آن ارسال خواهد شد.

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

آیا مشتری مجاز به ارائه نام کاربری متفاوت است یا خیر.