Method: locations.getExtended

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

طلب HTTP

GET https://mybusinessbusinessinformation.googleapis.com/v1alpha/{name=locations/*}:getExtended

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

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

المعلمات
name

string

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

نص الطلب

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

نص الاستجابة

تمثّل هذه السمة موقعًا جغرافيًا بالإضافة إلى بياناته الوصفية الخاصة بالتعديل وحالة العرض الحالية.

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

تمثيل JSON 
{
  "locationProvidedByMerchant": {
    object (Location)
  },
  "locationSeenByConsumers": {
    object (Location)
  },
  "extendedFieldData": {
    string: {
      object (ExtendedFieldData)
    },
    ...
  }
}
الحقول
locationProvidedByMerchant

object (Location)

النتائج فقط. بيانات الموقع الجغرافي الأساسية التي يديرها التاجر
locationSeenByConsumers

object (Location)

النتائج فقط. بيانات الموقع الجغرافي التي تظهر حاليًا للمستهلكين على "خرائط Google" و"بحث Google"
extendedFieldData

map (key: string, value: object (ExtendedFieldData))

النتائج فقط. بيانات الحقول الموسّعة، التي يتم إدخالها باسم حقل ذي مستوى أعلى من مورد Location.

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

عنصر يحتوي على قائمة بأزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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

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

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

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