REST Resource: locations

المورد: الموقع الجغرافي

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

تمثيل JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
الحقول
name

string

المعرّف. معرّف Google لهذا الموقع الجغرافي بالتنسيق: locations/{locationId}.
languageCode

string

غير قابل للتغيير لغة الموقع الجغرافي يتم ضبطه أثناء الإنشاء ولا يمكن تعديله.
storeCode

string

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

string

الحقل مطلوب. يجب أن يعكس اسم الموقع الجغرافي اسم نشاطك التجاري على أرض الواقع، أي الاسم الذي يعرفه العملاء والمستخدم على واجهة متجرك وموقعك الإلكتروني وأدواتك المكتبية. يمكن تضمين أي معلومات إضافية، عندما تكون ذات صلة، في حقول أخرى من المورد (على سبيل المثال، Address وCategories). لا تضِف معلومات غير ضرورية إلى اسمك (على سبيل المثال، يُفضَّل استخدام "Google" بدلاً من "Google Inc. - Mountain View Corporate Headquarters"). لا تُدرِج جمل ترويجية تسويقية أو رموز متاجر أو رموز خاصة أو ساعات عمل أو حالة الإغلاق/الفتح أو أرقام هواتف أو عناوين URL لمواقع إلكترونية أو معلومات عن الخدمات/المنتجات أو الموقع الجغرافي/العنوان أو الاتجاهات أو معلومات عن الموقع (على سبيل المثال، "ماكينة صرّاف آلي لبنك Chase في Duane Reade").
phoneNumbers

object (PhoneNumbers)

اختيارية: أرقام الهاتف المختلفة التي يمكن للعملاء استخدامها للتواصل مع المؤسسة
categories

object (Categories)

اختيارية: الفئات المختلفة التي تصف المؤسسة
storefrontAddress

object (PostalAddress)

اختيارية: عنوان دقيق وصحيح لوصف الموقع الجغرافي لمؤسستك ولا يُقبل بصناديق البريد الواقعة في مواقع جغرافية نائية. في الوقت الحالي، يمكنك تحديد خمس قيم addressLines كحدّ أقصى في العنوان. يجب ضبط هذا الحقل فقط للمؤسسات التي لديها واجهة محل. يجب عدم ضبط هذا الحقل للمواقع الجغرافية من النوع CUSTOMER_LOCATION_ONLY، ولكن في حال ضبطه، سيتم تجاهل أي قيمة يتم تقديمها.
websiteUri

string

اختيارية: عنوان URL لهذه المؤسسة إذا أمكن، استخدِم عنوان URL يمثّل الموقع الجغرافي الفردي لهذا النشاط التجاري بدلاً من موقع إلكتروني أو عنوان URL عام يمثّل جميع المواقع الجغرافية أو العلامة التجارية.
regularHours

object (BusinessHours)

اختيارية: ساعات عمل المؤسسة
specialHours

object (SpecialHours)

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

object (ServiceAreaBusiness)

اختيارية: تقدّم المؤسسات ضمن منطقة الخدمة خدماتها في الموقع الجغرافي للعميل. إذا كانت هذه المؤسسة ضمن نطاق الخدمة، يصف هذا الحقل المناطق التي تقدّم فيها المؤسسة خدماتها.
labels[]

string

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

object (AdWordsLocationExtensions)

اختيارية: معلومات إضافية تظهر في "إعلانات Google"
latlng

object (LatLng)

اختيارية: خطوط الطول والعرض التي يقدّمها المستخدم عند إنشاء موقع جغرافي، يتم تجاهل هذا الحقل إذا تم ترميز العنوان المقدَّم جغرافيًا بنجاح. لا يتم عرض هذا الحقل إلا في طلبات استرداد البيانات باستخدام GET إذا تم قبول قيمة latlng التي قدّمها المستخدم أثناء الإنشاء، أو إذا تم تعديل قيمة latlng من خلال الموقع الإلكتروني لـ "الملف التجاري على Google". لا يمكن تعديل هذا الحقل إلا من قِبل العملاء المعتمَدين.
openInfo

object (OpenInfo)

اختيارية: علامة تشير إلى ما إذا كان الموقع الجغرافي مفتوحًا حاليًا لمزاولة النشاط التجاري.
metadata

object (Metadata)

للعرض فقط. معلومات إضافية غير قابلة للتعديل من قِبل المستخدم
profile

object (Profile)

اختيارية: يصف مؤسستك بأسلوبك الخاص ويشارك مع المستخدمين القصة الفريدة لمؤسستك وعروضها.

هذا الحقل مطلوب لجميع الفئات باستثناء فئات أماكن الإقامة (مثل الفنادق والنُزل).
relationshipData

object (RelationshipData)

اختيارية: جميع المواقع الجغرافية والسلسلة المرتبطة بهذا الموقع
moreHours[]

object (MoreHours)

اختيارية: ساعات عمل إضافية لأقسام مختلفة في مؤسسة أو لعملاء محدّدين
serviceItems[]

object (ServiceItem)

اختيارية: قائمة بالخدمات التي يوفّرها التجّار يمكن أن تكون الخدمة قص شعر أو تركيب سخان مياه أو غير ذلك. وستتم إزالة الخدمات المكرّرة تلقائيًا.

الطُرق

delete

 تحذف هذه الطريقة موقعًا جغرافيًا.

get

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

getAttributes

 تسترد هذه الطريقة سمات موقع جغرافي وفقًا لآخر إعدادات ضبطها التاجر.

getGoogleUpdated

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

patch

 لتعديل الموقع الجغرافي المحدّد

updateAttributes

 تعديل سمات موقع جغرافي معيّن