تعرض هذه السمة الموقع الجغرافي المحدّد كما يظهر مباشرةً على "خرائط Google" و"بحث Google". قد تكون Google أو المحتوى من إنشاء المستخدمين قد عدّلا طريقة العرض هذه التي تظهر للمستهلكين، وقد تختلف عن نسخة التاجر. يحتوي الموقع الجغرافي الذي تم تعديله من Google على أقنعة تشير إلى الحقول التي تختلف عن معلومات التاجر.
طلب HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/{name=locations/*}:getGoogleUpdated
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
name |
الحقل مطلوب. اسم الموقع الجغرافي المطلوب جلبه |
مَعلمات طلب البحث
| المعلمات | |
|---|---|
readMask |
الحقل مطلوب. قناع القراءة لتحديد الحقول التي سيتم عرضها في الاستجابة. هذه قائمة قيم مفصولة بفاصلة لأسماء الحقول المؤهَّلة بالكامل. مثال: |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
تمثّل هذه الحالة طريقة عرض الموقع الجغرافي كما يظهر للمستهلكين، وتشمل التعديلات التي تظهر حاليًا على "خرائط Google" و"بحث Google".
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
|---|
{
"location": {
object ( |
| الحقول | |
|---|---|
location |
النسخة المعدَّلة من Google لهذا الموقع الجغرافي |
diffMask |
الحقول التي تختلف فيها القيم في طريقة العرض التي تظهر للمستهلكين عن معلومات التاجر. لقبول هذه التغييرات، عليك تصحيح الموقع الجغرافي. للرفض، يمكنك التصحيح باستخدام القيم المفضّلة لديك. هذه قائمة قيم مفصولة بفاصلة لأسماء الحقول المؤهَّلة بالكامل. مثال: |
pendingMask |
الحقول التي قدّم فيها التاجر تعديلاً قيد المراجعة حاليًا ولم يتم نشره بعد على "خرائط Google" و"بحث Google". يتتبّع هذا القناع حالة تعديلات التاجر فقط، وليس التغييرات الخارجية. هذه قائمة قيم مفصولة بفاصلة لأسماء الحقول المؤهَّلة بالكامل. مثال: |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.