Method: locations.getGoogleUpdated

تعرض هذه السمة الموقع الجغرافي المحدّد كما يظهر مباشرةً على "خرائط Google" و"بحث Google". قد تكون Google أو المحتوى من إنشاء المستخدمين قد عدّلا طريقة العرض هذه التي تظهر للمستهلكين، وقد تختلف عن نسخة التاجر. يحتوي الموقع الجغرافي الذي تم تعديله من Google على أقنعة تشير إلى الحقول التي تختلف عن معلومات التاجر.

طلب HTTP

GET https://mybusinessbusinessinformation.googleapis.com/v1/{name=locations/*}:getGoogleUpdated

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

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

المعلمات
name

string

الحقل مطلوب. اسم الموقع الجغرافي المطلوب جلبه

مَعلمات طلب البحث

المعلمات
readMask

string (FieldMask format)

الحقل مطلوب. قناع القراءة لتحديد الحقول التي سيتم عرضها في الاستجابة.

هذه قائمة بأسماء الحقول المؤهَّلة بالكامل، وتكون مفصولة بفواصل. مثال: "user.displayName,photo"

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

تمثّل هذه الحالة طريقة عرض الموقع الجغرافي كما يظهر للمستهلكين، وتشمل التعديلات التي تظهر حاليًا على "خرائط Google" و"بحث Google".

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

تمثيل JSON 
{
  "location": {
    object (Location)
  },
  "diffMask": string,
  "pendingMask": string
}
الحقول
location

object (Location)

النسخة المعدَّلة من Google لهذا الموقع الجغرافي
diffMask

string (FieldMask format)

الحقول التي تختلف فيها القيم في طريقة العرض التي تظهر للمستهلكين عن معلومات التاجر. لقبول هذه التغييرات، عليك تصحيح الموقع الجغرافي. للرفض، يمكنك التصحيح باستخدام القيم المفضّلة لديك.

هذه قائمة بأسماء الحقول المؤهَّلة بالكامل، وتكون مفصولة بفواصل. مثال: "user.displayName,photo"
pendingMask

string (FieldMask format)

الحقول التي قدّم فيها التاجر تعديلاً قيد المراجعة حاليًا ولم يتم نشره بعد على "خرائط Google" و"بحث Google". يتتبّع هذا القناع حالة تعديلات التاجر فقط، وليس التغييرات الخارجية.

هذه قائمة بأسماء الحقول المؤهَّلة بالكامل، وتكون مفصولة بفواصل. مثال: "user.displayName,photo"

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

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

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

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