بدء عملية إثبات ملكية موقع جغرافي
طلب HTTP
POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم المورد للموقع الجغرافي المطلوب إثبات ملكيته |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "method": enum ( |
الحقول | ||
---|---|---|
method |
طريقة إثبات الملكية. |
|
languageCode |
رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق من المعلِن. |
|
context |
معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية مطلوب للمواقع الجغرافية التي يكون نوع النشاط التجاري فيها CUSTOMER_LOCATION_ONLY. للتحقق من العنوان ADDRESS، سيتم استخدام العنوان لإرسال بطاقة بريدية. بالنسبة إلى الطرق الأخرى، يجب أن تكون هي الطريقة نفسها التي تم تمريرها إلى location.fetchverificationOptions. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أخرى من المواقع الجغرافية للنشاط التجاري. |
|
حقل الاتحاد RequestData بيانات يدخلها المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض يجب أن تتطابق البيانات مع الطريقة المطلوبة. ويمكنك تركه فارغًا إذا لم تكن هناك حاجة إلى البيانات. يمكن أن تكون السمة "RequestData " واحدة فقط مما يلي: |
||
emailInput |
إدخال طريقة EMAIL. |
|
addressInput |
إدخال طريقة ADDRESS. |
|
phoneInput |
الإدخال لطريقة PHONE_CALL/SMS |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة رد لإثبات ملكية الموقع الإلكتروني التحقّق من الموقع الجغرافي
تمثيل JSON | |
---|---|
{
"verification": {
object ( |
الحقول | |
---|---|
verification |
طلب إثبات الملكية الذي تم إنشاؤه. |
نطاقات الأذونات
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
EmailInput
حقل لإثبات ملكية عنوان البريد الإلكتروني EMAIL.
تمثيل JSON | |
---|---|
{ "emailAddress": string } |
الحقول | |
---|---|
emailAddress |
عنوان البريد الإلكتروني الذي يجب إرسال رقم التعريف الشخصي إليه. لا يتم قبول عنوان بريد إلكتروني إلا إذا كان أحد العناوين التي تقدِّمها المواقع الجغرافية.fetchCheckOptions. إذا تم ضبط قيمة isUserNameEditable في |
AddressInput
حقل لإثبات ملكية العنوان ADDRESS.
تمثيل JSON | |
---|---|
{ "mailerContactName": string } |
الحقول | |
---|---|
mailerContactName |
اسم جهة الاتصال الذي يجب إرسال البريد إليه. |
PhoneInput
إدخال لتأكيد رقم الهاتف PHONE_CALL/SMS
تمثيل JSON | |
---|---|
{ "phoneNumber": string } |
الحقول | |
---|---|
phoneNumber |
رقم الهاتف الذي يجب الاتصال به أو إرسال رسالة قصيرة SMS إليه. يجب أن يكون أحد أرقام الهواتف في الخيارات المؤهَّلة. |