Method: locations.verify

بدء عملية إثبات ملكية موقع جغرافي

طلب HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
name

string

مطلوبة. اسم المورد للموقع الجغرافي المطلوب إثبات ملكيته

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
الحقول
method

enum (VerificationMethod)

مطلوبة. طريقة إثبات الملكية.
languageCode

string

اختياريّ. رمز اللغة BCP 47 الذي يمثّل اللغة التي سيتم استخدامها في عملية التحقّق من المعلِن.
context

object (ServiceBusinessContext)

اختياريّ. معلومات سياق إضافية لإثبات ملكية الأنشطة التجارية الخدمية وهو مطلوب فقط للمواقع الجغرافية التي يكون نوع نشاطها التجاري CUSTOMER_LOCATION_ONLY. للتحقق من العنوان ADDRESS، سيتم استخدام العنوان لإرسال بطاقة بريدية. بالنسبة إلى الطرق الأخرى، يجب أن تكون هي الطريقة التي تم تمريرها إلى GetCheckOptions. سيتم إلغاء INVALID_{9} إذا تم تعيينه لأنواع أخرى من المواقع الجغرافية للنشاط التجاري.
حقل الاتحاد RequestData بيانات يدخلها المستخدم لطريقة معيّنة بالإضافة إلى بيانات العرض يجب أن تتطابق البيانات مع الطريقة المطلوبة. ويمكنك تركه فارغًا إذا لم تكن هناك حاجة إلى البيانات. يمكن أن تكون السمة "RequestData" واحدة فقط مما يلي:
emailAddress

string

اختياريّ. إدخال طريقة EMAIL. عنوان البريد الإلكتروني الذي يجب إرسال رقم التعريف الشخصي إليه.

لا يتم قبول عنوان بريد إلكتروني إلا إذا كان أحد العناوين التي تقدِّمها المواقع الجغرافية.fetchCheckOptions. في حال ضبط قيمة isUserNameEditable على "صحيح" في [EmailverificationData] [google.mybusiness-verifications.v1.verificationOption.EmailCheckData] ، يمكن للعميل تحديد اسم مستخدم مختلف (جزء محلي) ولكن يجب أن يتطابق مع اسم النطاق.
mailerContact

string

اختياريّ. إدخال طريقة ADDRESS. اسم جهة الاتصال الذي يجب إرسال البريد إليه.
phoneNumber

string

اختياريّ. إدخال طريقة PHONE_CALL/SMS رقم الهاتف الذي ينبغي الاتصال به أو إرسال رسالة قصيرة SMS إليه. يجب أن يكون أحد أرقام الهواتف في الخيارات المؤهَّلة.
token

object (VerificationToken)

اختياريّ. يتوفّر إدخال طريقة VETTED_PARTNER لمجموعة محدَّدة من partners. لا يلزم إدخال بيانات لحساب تم التحقق منه. الرمز المميّز المرتبط بالموقع الجغرافي الرمز المميّز المرتبط بالموقع الجغرافي

نص الاستجابة

رسالة رد لإثبات ملكية الموقع الإلكتروني التحقّق من الموقع الجغرافي

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "verification": {
    object (Verification)
  }
}
الحقول
verification

object (Verification)

طلب إثبات الملكية الذي تم إنشاؤه.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

VerificationToken

الرمز المميّز الذي ينشئه شريك تم فحصه

تمثيل JSON 
{
  "tokenString": string
}
الحقول
tokenString

string

سلسلة الرمز المميّز