REST Resource: locations

{
  "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)
    }
  ]
}

string

معرّف Google لهذا الموقع الجغرافي بالصيغة: locations/{locationId}.

string

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

string

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

string

مطلوبة. يجب أن يعكس اسم الموقع الجغرافي اسم نشاطك التجاري في العالم الفعلي، كما يجري استخدامه دائمًا على واجهة متجرك وموقعك الإلكتروني وأدواتك المكتبية، وكما هو معروف بين العملاء. يمكن تضمين أي معلومات إضافية، عند الاقتضاء، في حقول أخرى من المورد (على سبيل المثال، Address، Categories). ولا تضِف معلومات غير ضرورية إلى اسمك (على سبيل المثال، يمكنك تفضيل "Google" على "Google Inc. - المقر الرئيسي لشركة ماونتن فيو"). لا تضمِّن سطور وصف للتسويق أو رموز متاجر أو رموزًا خاصة أو ساعات عمل أو حالة الإغلاق/الفتح أو أرقام الهواتف أو عناوين URL للمواقع الإلكترونية أو معلومات الخدمة/المنتج أو الموقع الجغرافي/العنوان أو الاتجاهات أو معلومات الاحتواء (على سبيل المثال، "ماكينة الصراف الآلي في الإسكندرية في شارع جامعة الدول العربية").

object (PhoneNumbers)

اختياريّ. أرقام الهاتف المختلفة التي يمكن للعملاء استخدامها للتواصل مع النشاط التجاري.

object (Categories)

اختياريّ. الفئات المختلفة التي تصف النشاط التجاري.

object (PostalAddress)

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

string

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

object (BusinessHours)

اختياريّ. ساعات العمل للنشاط التجاري.

object (SpecialHours)

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

object (ServiceAreaBusiness)

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

string

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

object (AdWordsLocationExtensions)

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

object (LatLng)

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

object (OpenInfo)

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

object (Metadata)

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

object (Profile)

اختياريّ. يصف نشاطك التجاري بصوتك الخاص ويشارك مع المستخدمين القصة الفريدة لنشاطك التجاري وعروضك.

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

object (RelationshipData)

اختياريّ. جميع المواقع الجغرافية والسلسلة ذات الصلة بهذا الموقع.

object (MoreHours)

اختياريّ. ساعات إضافية للأقسام المختلفة أو العملاء المحدّدين في أحد الأنشطة التجارية.

object (ServiceItem)

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