- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- VerificationOption
- AddressVerificationData
- EmailVerificationData
تعمل هذه السياسة على الإبلاغ عن جميع خيارات إثبات الملكية المؤهّلة لموقع جغرافي معيّن بلغة معيّنة.
طلب HTTP
POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
location |
مطلوبة. الموقع الجغرافي المطلوب إثبات ملكيته. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"languageCode": string,
"context": {
object ( |
الحقول | |
---|---|
languageCode |
مطلوبة. رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق من المعلِن. تختلف الخيارات المتاحة حسب اللغة. |
context |
اختياريّ. معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية لا يمكن تطبيق هذا الخيار إلا على المواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. يؤدي تحديد عنوان دقيق إلى تمكين المزيد من الخيارات. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أنشطة تجارية أخرى من المواقع. |
نص الاستجابة
رسالة الرد لـverifications.FetchPendingOptions.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل 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 أو رسالة SMS. رقم الهاتف الذي سيتم إرسال رقم التعريف الشخصي إليه |
addressData |
لا يتم التعيين إلا إذا كانت الطريقة هي يسر. |
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 |
ما إذا كان يُسمَح للعميل بتقديم اسم مستخدم مختلف. |