- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- VerificationOption
- AddressVerificationData
- EmailVerificationData
همه گزینه های تأیید واجد شرایط را برای یک مکان به زبان خاصی گزارش می دهد.
درخواست HTTP
POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
location | مورد نیاز. مکانی برای تأیید. |
درخواست بدن
بدنه درخواست شامل داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"languageCode": string,
"context": {
object ( |
فیلدها | |
---|---|
languageCode | مورد نیاز. کد زبان BCP 47 نشان دهنده زبانی است که قرار است برای فرآیند تأیید استفاده شود. گزینه های موجود بر اساس زبان متفاوت است. |
context | اختیاری. اطلاعات زمینه اضافی برای تأیید مشاغل خدماتی. فقط می تواند برای مکان هایی اعمال شود که نوع کسب و کار آنها CUSTOMER_LOCATION_ONLY است. تعیین یک آدرس دقیق می تواند گزینه های بیشتری را فعال کند. اگر INVALID_ARGUMENT برای مکانهای دیگر کسبوکار تنظیم شود، پرتاب میشود. |
بدن پاسخگو
پیام پاسخ برای Verifications.FetchVerificationOptions.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"options": [
{
object ( |
فیلدها | |
---|---|
options[] | گزینه های تأیید صحت موجود |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
VerificationOption
گزینه تأیید نحوه تأیید مکان (که با روش تأیید نشان داده شده است) و تأیید به کجا ارسال می شود (با داده های نمایش نشان داده شده است) را نشان می دهد.
نمایندگی JSON |
---|
{ "verificationMethod": enum ( |
فیلدها | |
---|---|
verificationMethod | روش تأیید مکان |
فیلد اتحادیه DisplayData . یکی از داده های نمایشگر داده ها باید با روش مطابقت داشته باشند. اگر روش مربوطه هیچ داده نمایشی ندارد، خالی شود. DisplayData تنها می تواند یکی از موارد زیر باشد: | |
phoneNumber | فقط در صورتی تنظیم کنید که روش PHONE_CALL یا پیامک باشد. شماره تلفنی که پین به آن ارسال خواهد شد. |
addressData | فقط در صورتی تنظیم کنید که روش MAIL باشد. |
emailData | تنها در صورتی تنظیم کنید که روش EMAIL باشد. |
announcement | فقط در صورتی تنظیم کنید که روش VETTED_PARTNER باشد. |
AddressVerificationData
نمایش داده ها برای تأیید از طریق کارت پستال.
نمایندگی JSON |
---|
{
"business": string,
"address": {
object ( |
فیلدها | |
---|---|
business | نام تجاری تاجر. |
address | آدرسی که می توان به آن کارت پستال ارسال کرد. |
expectedDeliveryDaysRegion | تعداد روزهای پیش بینی شده برای تحویل کارت پستال به منطقه آدرس طول می کشد. |
EmailVerificationData
نمایش داده ها برای تأیید از طریق ایمیل.
نمایندگی JSON |
---|
{ "domain": string, "user": string, "isUserNameEditable": boolean } |
فیلدها | |
---|---|
domain | نام دامنه در آدرس ایمیل. به عنوان مثال "gmail.com" در foo@gmail.com |
user | نام کاربری در آدرس ایمیل به عنوان مثال "foo" در foo@gmail.com |
isUserNameEditable | آیا مشتری مجاز به ارائه نام کاربری متفاوت است یا خیر. |