- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- VerificationOption
- PhoneVerificationData
- AddressVerificationData
- EmailVerificationData
تعمل هذه السياسة على الإبلاغ عن جميع خيارات إثبات الملكية المؤهّلة لموقع جغرافي معيّن بلغة معيّنة.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:fetchVerificationOptions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم المورد للموقع الجغرافي المطلوب إثبات ملكيته |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل 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/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
VerificationOption
يمثّل خيار إثبات الملكية طريقة إثبات ملكية الموقع الجغرافي (الموضّحة من خلال طريقة إثبات الملكية) والمكان الذي سيتم إرسال إثبات الملكية إليه (المحدَّد من خلال بيانات العرض).
تمثيل JSON | |
---|---|
{ "verificationMethod": enum ( |
الحقول | ||
---|---|---|
verificationMethod |
طريقة للتحقق من الموقع. |
|
حقل الاتحاد DisplayData إحدى بيانات العرض يجب أن تتطابق البيانات مع الطريقة. يكون هذا الحقل فارغًا إذا لم تتضمّن الطريقة المقابلة أي بيانات عرض. يمكن أن تكون السمة "DisplayData " واحدة فقط مما يلي: |
||
phoneData |
لا يتم تعيينها إلا إذا كانت الطريقة هي PHONE_CALL أو رسالة SMS. |
|
addressData |
لا يتم التعيين إلا إذا كانت الطريقة هي يسر. |
|
emailData |
لا يتم التعيين إلا إذا كانت الطريقة هي EMAIL. |
PhoneVerificationData
عرض البيانات لعمليات التحقّق من خلال الهاتف، مثل المكالمات الهاتفية والرسائل القصيرة
تمثيل JSON | |
---|---|
{ "phoneNumber": string } |
الحقول | |
---|---|
phoneNumber |
رقم الهاتف الذي سيتم إرسال رقم التعريف الشخصي إليه |
AddressVerificationData
عرض بيانات عمليات إثبات الملكية من خلال البطاقة البريدية.
تمثيل JSON | |
---|---|
{
"businessName": string,
"address": {
object ( |
الحقول | |
---|---|
businessName |
اسم النشاط التجاري للتاجر. |
address |
العنوان الذي يمكن إرسال بطاقة بريدية إليه. |
EmailVerificationData
يمكنك عرض بيانات عمليات إثبات الهوية عبر البريد الإلكتروني.
تمثيل JSON | |
---|---|
{ "domainName": string, "userName": string, "isUserNameEditable": boolean } |
الحقول | |
---|---|
domainName |
اسم النطاق في عنوان البريد الإلكتروني. على سبيل المثال، "gmail.com" في foo@gmail.com |
userName |
اسم المستخدم في عنوان البريد الإلكتروني، مثل "foo" في foo@gmail.com |
isUserNameEditable |
ما إذا كان يُسمَح للعميل بتقديم اسم مستخدم مختلف. |