بدء عملية إثبات ملكية موقع جغرافي
طلب HTTP
POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
مطلوبة. اسم المورد للموقع الجغرافي المطلوب إثبات ملكيته |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "method": enum ( |
الحقول | |
---|---|
method |
مطلوبة. طريقة إثبات الملكية. |
languageCode |
اختياريّ. رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق من المعلِن. |
context |
اختياريّ. معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية وهو مطلوب فقط للمواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. للتحقق من العنوان ADDRESS، سيتم استخدام العنوان لإرسال بطاقة بريدية. بالنسبة إلى الطرق الأخرى، يجب أن تكون هي الطريقة التي تم تمريرها إلى GetCheckOptions. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أخرى من المواقع الجغرافية للنشاط التجاري. |
حقل الاتحاد RequestData بيانات يدخلها المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض يجب أن تتطابق البيانات مع الطريقة المطلوبة. ويمكنك تركه فارغًا إذا لم تكن هناك حاجة إلى البيانات. يمكن أن تكون السمة "RequestData " واحدة فقط مما يلي: |
|
emailAddress |
اختياريّ. إدخال طريقة EMAIL. عنوان البريد الإلكتروني الذي يجب إرسال رقم التعريف الشخصي إليه. لا يتم قبول عنوان بريد إلكتروني إلا إذا كان أحد العناوين التي تقدِّمها المواقع الجغرافية.fetchCheckOptions. في حال ضبط قيمة isUserNameEditable على "صحيح" في [EmailverificationData] [google.mybusiness-verifications.v1.verificationOption.EmailCheckData] ، يمكن للعميل تحديد اسم مستخدم مختلف (جزء محلي) ولكن يجب أن يتطابق مع اسم النطاق. |
mailerContact |
اختياريّ. إدخال طريقة ADDRESS. اسم جهة الاتصال الذي يجب إرسال البريد إليه. |
phoneNumber |
اختياريّ. إدخال طريقة PHONE_CALL/SMS رقم الهاتف الذي ينبغي الاتصال به أو إرسال رسالة قصيرة SMS إليه. يجب أن يكون أحد أرقام الهواتف في الخيارات المؤهَّلة. |
token |
اختياريّ. يتوفّر إدخال طريقة VETTED_PARTNER لمجموعة محدَّدة من partners. لا يلزم إدخال بيانات لحساب تم التحقق منه. الرمز المميّز المرتبط بالموقع الجغرافي الرمز المميّز المرتبط بالموقع الجغرافي |
نص الاستجابة
رسالة رد لإثبات ملكية الموقع الإلكتروني التحقّق من الموقع الجغرافي
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"verification": {
object ( |
الحقول | |
---|---|
verification |
طلب إثبات الملكية الذي تم إنشاؤه. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
VerificationToken
الرمز المميّز الذي ينشئه شريك تم فحصه
تمثيل JSON |
---|
{ "tokenString": string } |
الحقول | |
---|---|
tokenString |
سلسلة الرمز المميّز |