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. - مقر شركة ماونتن فيو"). لا تُدرِج الجُمل الترويجية التسويقية أو رموز المتاجر أو الرموز الخاصة أو ساعات العمل أو حالة الإغلاق/الفتح أو أرقام الهواتف أو عناوين URL للمواقع الإلكترونية أو معلومات الخدمة/المنتجات أو الموقع الجغرافي/العنوان أو الاتجاهات أو معلومات الاحتواء (مثل "ماكينة الصراف الآلي للبنك الأهلي في دبي").
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

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

object (AdWordsLocationExtensions)

اختياريّ. المعلومات الإضافية التي يتم عرضها في AdWords
latlng

object (LatLng)

اختياريّ. خطوط الطول والعرض المقدَّمة من المستخدم. عند إنشاء موقع، يتم تجاهل هذا الحقل إذا كان الترميز الجغرافي للعنوان المقدَّم يعمل بنجاح. لا يتم عرض هذا الحقل في طلبات تلقّي الطلبات إلا إذا تم قبول قيمة 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 للموقع الجغرافي المحدّد

patch

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

updateAttributes

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