Method: verificationTokens.generate

أنشِئ رمزًا مميزًا لبيانات الموقع الجغرافي المقدَّمة من أجل تأكيد الموقع الجغرافي.

طلب HTTP

POST https://mybusinessverifications.googleapis.com/v1/verificationTokens:generate

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationId": string
  // End of mutually exclusive fields.
}
الحقول
معلومات عن الموقع الجغرافي لإنشاء رمز مميّز لإثبات الملكية الفوري. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
locationId

string

معرّف الموقع الجغرافي المرتبط ببيانات غير مؤكدة

هذا هو معرّف الموقع الجغرافي الذي تم إنشاؤه في وقت إنشاء بطاقة البيانات في الأصل. وهو الجزء الأخير من اسم مورد الموقع الجغرافي كما تم إنشاؤه بواسطة Business Information API.

ملاحظة: يجب أن يكون المتصل مالكًا أو مديرًا لبطاقة البيانات هذه من أجل إنشاء رمز مميّز لإثبات الملكية.

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات مورد الموقع الجغرافي.
نهاية الحقول التي يستبعد كلّ منها الآخر

نص الاستجابة

رسالة الردّ على Verifications.GenerateInstantVerificationToken.

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

تمثيل JSON 
{
  "result": enum (Result),
  "instantVerificationToken": string
}
الحقول
result

enum (Result)

النتائج فقط. نتيجة إنشاء الرمز المميّز لإثبات الملكية الفوري
instantVerificationToken

string

الرمز المميّز الذي تم إنشاؤه لإثبات الملكية الفوري

نطاقات الأذونات

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

النتيجة

عمليات التعداد
RESULT_UNSPECIFIED القيمة التلقائية، ستؤدي إلى حدوث أخطاء.
SUCCEEDED تم إنشاء الرمز المميّز لإثبات الملكية الفوري بنجاح.
FAILED لم يتم إنشاء الرمز المميّز لإثبات الملكية الفوري.