REST Resource: accounts.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)

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

PhoneNumbers

مجموعة من أرقام الهواتف للنشاط التجاري. أثناء إجراء التحديثات، يجب ضبط كلا الحقلَين. لا يمكن للعملاء تعديل أرقام الهواتف الأساسية أو الإضافية فقط باستخدام قناع التحديث. يُفضَّل استخدام تنسيق الهاتف الدولي، مثل " +1 415 555 0132"، ويمكنك الاطّلاع على مزيد من المعلومات في (https://developers.google.com/style/phone-numbers#international-phone-numbers).

تمثيل JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
الحقول
primaryPhone

string

مطلوب. رقم هاتف يتصل بموقع نشاطك التجاري الفردي بشكل مباشر قدر الإمكان. استخدِم رقم هاتف محليًا بدلاً من استخدام رقم خط مساعدة مركزي في مركز اتصالات متى أمكن ذلك.
additionalPhones[]

string

اختياريّ. ما يصل إلى رقمَي هاتف (جوّال أو أرضي، لا يُسمح بالفاكس) يمكن الاتصال بنشاطك التجاري، بالإضافة إلى رقم هاتفك الأساسي.

الفئات

هي مجموعة من الفئات التي تصف النشاط التجاري. أثناء إجراء التحديثات، يجب ضبط كلا الحقلَين. ويُحظر على العملاء تعديل الفئات الأساسية أو الإضافية بشكل فردي باستخدام قناع التحديث.

تمثيل JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
الحقول
primaryCategory

object (Category)

مطلوب. الفئة التي تصف النشاط التجاري الأساسي الذي يشارك فيه هذا الموقع الجغرافي على أفضل وجه
additionalCategories[]

object (Category)

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

الفئة

فئة تصف ماهية هذا النشاط التجاري (وليس ما يقدّمه). للحصول على قائمة بمعرّفات الفئات الصالحة وعمليات الربط لأسمائها التي يمكن للمستخدمين قراءتها، يُرجى الاطّلاع على categories.list.

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
الحقول
name

string

مطلوب. معرّف ثابت (توفّره Google) لهذه الفئة يجب تحديد القيمة عند تعديل الفئة (عند إنشاء موقع أو تعديله).
displayName

string

النتائج فقط. تمثّل هذه السمة اسم الفئة سهل القراءة للمستخدم. ويتم ضبطه عند قراءة الموقع الجغرافي. عند تعديل الموقع الجغرافي، يجب ضبط category_id.
serviceTypes[]

object (ServiceType)

النتائج فقط. قائمة بجميع أنواع الخدمات المتاحة لفئة النشاط التجاري هذه.
moreHoursTypes[]

object (MoreHoursType)

النتائج فقط. أنواع ساعات العمل الإضافية المتاحة لفئة النشاط التجاري هذه.

ServiceType

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

تمثيل JSON 
{
  "serviceTypeId": string,
  "displayName": string
}
الحقول
serviceTypeId

string

النتائج فقط. معرّف ثابت (توفّره Google) لهذا النوع من الخدمات
displayName

string

النتائج فقط. الاسم المعروض لنوع الخدمة الذي يمكن للمستخدمين قراءته.

MoreHoursType

أنواع ساعات العمل الإضافية التي يمكن أن يقدِّمها النشاط التجاري، بالإضافة إلى ساعات العمل العادية.

تمثيل JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
الحقول
hoursTypeId

string

النتائج فقط. معرّف ثابت توفّره Google لنوع ساعات العمل هذا
displayName

string

النتائج فقط. تمثّل هذه السمة الاسم المعروض باللغة الإنجليزية الذي يمكن للمستخدم قراءته لنوع الساعات.
localizedDisplayName

string

النتائج فقط. الاسم المعروض المترجَم الذي يمكن للمستخدمين قراءته لنوع ساعات العمل.

PostalAddress

يمثل عنوانًا بريديًا، على سبيل المثال: لعناوين التسليم البريدي أو الدفع استنادًا إلى العنوان البريدي، يمكن لخدمة البريد تسليم السلع إلى المبنى. صندوق أو ما شابه ذلك. حيث لم يُقصد به تصميم نماذج للمواقع الجغرافية (الطرق والمدن والجبال).

في الاستخدام النموذجي، يتم إنشاء عنوان من خلال البيانات التي يُدخلها المستخدم أو من استيراد البيانات الحالية، وذلك حسب نوع العملية.

نصائح بشأن إدخال العنوان أو تعديله: - استخدام تطبيق مصغّر بعنوان جاهز للاستخدام مع مختلف البلدان، مثل https://github.com/google/libaddressinput). يجب عدم تقديم عناصر واجهة المستخدم إلى المستخدمين لإدخال أو تعديل الحقول التي تقع خارج البلدان التي يُستخدَم فيها هذا الحقل.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478

تمثيل JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
الحقول
revision

integer

تمثّل هذه السمة مراجعة المخطط لـ PostalAddress. يجب تعيين هذا على 0، وهي أحدث مراجعة.

يجب أن تكون جميع النُسخ السابقة متوافقة مع الإصدارات القديمة.
regionCode

string

مطلوب. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان. لا يتم استنتاج ذلك أبدًا، وتقع على عاتق المستخدم مسؤولية التأكّد من صحة القيمة. يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html لمعرفة التفاصيل. مثال: "CH" لسويسرا.
languageCode

string

اختياريّ. رمز لغة محتوى هذا العنوان BCP-47 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم لنموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدمة في العنوان الدولة/المنطقة، أو ما يعادلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق.

وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة).

أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en".
postalCode

string

اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية).
sortingCode

string

اختياريّ. رمز فرز إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. عند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة بشكل اختياري برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا)، "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال: ساحل العاج).
administrativeArea

string

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

string

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

string

اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق.
addressLines[]

string

أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان.

بما أنّ القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أبو ظبي، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان "ترتيب على شكل مغلف". للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة.

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

إنشاء عنوان يحتوي فقط على رمز المنطقة وسطر العنوان، ومن ثمَّ يُعتبر الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية).
recipients[]

string

اختياريّ. المستلِم في العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على كلمة "رعاية" المعلومات.
organization

string

اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان.

BusinessHours

تمثل الفترات الزمنية التي يكون فيها هذا الموقع الجغرافي مفتوحًا للنشاط التجاري. يتضمن مجموعة من مثيلات [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

تمثيل JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
الحقول
periods[]

object (TimePeriod)

مطلوب. هذه مجموعة للأوقات التي يكون فيها هذا الموقع الجغرافي مفتوحًا لمزاولة النشاط التجاري. تمثل كل فترة نطاقًا من الساعات التي يكون فيها الموقع الجغرافي مفتوحًا خلال الأسبوع.

TimePeriod

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

تمثيل JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
الحقول
openDay

enum (DayOfWeek)

مطلوب. يشير إلى day of the week التي تبدأ بها هذه الفترة.
openTime

object (TimeOfDay)

مطلوب. القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد.
closeDay

enum (DayOfWeek)

مطلوب. ويشير إلى day of the week التي تنتهي فيها هذه الفترة.
closeTime

object (TimeOfDay)

مطلوب. القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد.

DayOfWeek

يمثل يومًا من الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED لم يتم تحديد اليوم من الأسبوع.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

TimeOfDay

يمثل وقتًا من اليوم. إما أن التاريخ والمنطقة الزمنية ليست مهمة أو تم تحديدها في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالثواني. الأنواع ذات الصلة هي google.type.Date وgoogle.protobuf.Timestamp.

تمثيل JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
الحقول
hours

integer

ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل موعد إغلاق العمل.
minutes

integer

دقائق من ساعات اليوم. يجب أن تتراوح القيمة بين 0 و59.
seconds

integer

ثواني الدقائق من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة.
nanos

integer

الكسور من الثواني بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999.

SpecialHours

ويمثِّل مجموعة من الفترات الزمنية التي تختلف فيها ساعات العمل في الموقع الجغرافي عن ساعات العمل العادية.

تمثيل JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
الحقول
specialHourPeriods[]

object (SpecialHourPeriod)

مطلوب. قائمة بالاستثناءات لساعات العمل العادية للنشاط التجاري.

SpecialHourPeriod

ويمثِّل هذه الفترة فترة زمنية واحدة تختلف فيها ساعات العمل في أحد المواقع الجغرافية عن ساعات العمل العادية لهذا الموقع الجغرافي. يجب أن تمثل فترة الساعات الخاصة نطاقًا أقل من 24 ساعة. يجب أن تسبق openTime وstartDate كلاً من closeTime وendDate. يمكن أن يمتد نطاقا closeTime وendDate حتى الساعة 11:59 صباحًا في اليوم التالي لتاريخ startDate المحدَّد. على سبيل المثال، المدخلات التالية صالحة:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

البيانات التي تم إدخالها التالية غير صالحة:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
تمثيل JSON 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
الحقول
startDate

object (Date)

مطلوب. تاريخ التقويم الذي تبدأ فيه فترة الساعة الخاصة هذه.
openTime

object (TimeOfDay)

اختياريّ. القيم الصالحة هي 00:00-24:00 حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. يجب تحديدها إذا كانت السمة closed خاطئة.
endDate

object (Date)

اختياريّ. التاريخ التقويمي الذي تنتهي فيه فترة الساعة الخاصة هذه. إذا لم يتم ضبط حقل endDate، سيتم تلقائيًا استخدام التاريخ المحدّد في startDate. وفي حال ضبطها، يجب أن يساوي هذا الحقل يوم startDate أو بعده بيوم واحد على الأكثر.
closeTime

object (TimeOfDay)

اختياريّ. القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. يجب تحديدها إذا كانت السمة closed خاطئة.
closed

boolean

اختياريّ. إذا كانت القيمة هي true، سيتم تجاهل endDate وopenTime وcloseTime، ويتم التعامل مع التاريخ المحدّد في startDate على أنّه الموقع الجغرافي الذي يتم إغلاقه طوال اليوم.

التاريخ

يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:

  • تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
  • سنة بمفردها، بشهر صفري ويوم صفري.
  • سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا.

ServiceAreaBusiness

تقدّم الأنشطة التجارية ذات نطاق الخدمة خدمتها في موقع العميل (على سبيل المثال، صناعة أقفال أو سباكة).

تمثيل JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
الحقول
businessType

enum (BusinessType)

مطلوب. تشير هذه السمة إلى [type]. [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] الخاص بالنشاط التجاري لمنطقة الخدمة.
places

object (Places)

يتم تحديد المنطقة التي يخدمها هذا النشاط التجاري من خلال مجموعة من الأماكن.
regionCode

string

غير قابل للتغيير. رمز CLDR للمنطقة التي يقع فيها النشاط التجاري لمنطقة الخدمة هذه للبلد أو المنطقة لمعرفة التفاصيل، يمكنك الاطّلاع على http://cldr.unicode.org/ وhttp://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. مثال: "CH" لسويسرا.

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

يمكن أن تختلف المنطقة المحدّدة هنا عن المناطق التي يخدمها هذا النشاط التجاري (مثل الأنشطة التجارية ذات نطاق الخدمة التي تقدّم خدمات في مناطق غير المنطقة التي يقع فيها مقرّ النشاط التجاري).

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

BusinessType

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

عمليات التعداد
BUSINESS_TYPE_UNSPECIFIED النتائج فقط. لم يتم تحديده.
CUSTOMER_LOCATION_ONLY تقدّم الخدمة في المنطقة المحيطة فقط (وليس في عنوان النشاط التجاري). في حال تعديل بيانات نشاط تجاري من CUSTOMER_AND_business_LOCATION إلى CUSTOMER_LOCATION_ONLY، يجب أن يتضمّن تعديل الموقع الجغرافي قناع الحقل storefrontAddress وضبط الحقل على "فارغ".
CUSTOMER_AND_BUSINESS_LOCATION تتوفّر الخدمة في عنوان النشاط التجاري والمنطقة المحيطة.

الأماكن

اتحاد المناطق التي تمثلها مجموعة من الأماكن.

تمثيل JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
الحقول
placeInfos[]

object (PlaceInfo)

المناطق التي تمثلها أرقام تعريف الأماكن. الحد الأقصى هو 20 مكانًا.

PlaceInfo

لتحديد المنطقة التي يتم تمثيلها برقم تعريف مكان.

تمثيل JSON 
{
  "placeName": string,
  "placeId": string
}
الحقول
placeName

string

مطلوب. الاسم المترجم للمكان. مثلاً: Scottsdale, AZ
placeId

string

مطلوب. رقم تعريف المكان. يجب أن يكون متوافقًا مع منطقة معيّنة. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

المعلومات الإضافية التي يتم عرضها في AdWords

تمثيل JSON 
{
  "adPhone": string
}
الحقول
adPhone

string

مطلوب. رقم هاتف بديل للعرض في إضافات مواقع AdWords بدلاً من رقم الهاتف الأساسي للموقع.

LatLng

كائن يمثّل زوجًا من خط العرض/الطول ويتم التعبير عن ذلك في صورة زوج من الزوجين لتمثيل درجات الطول والعرض والدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.

تمثيل JSON 
{
  "latitude": number,
  "longitude": number
}
الحقول
latitude

number

خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0].
longitude

number

خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0].

OpenInfo

معلومات ذات صلة بالحالة الافتتاحية للنشاط التجاري.

تمثيل JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
الحقول
status

enum (OpenForBusiness)

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

boolean

النتائج فقط. تشير إلى ما إذا كان هذا النشاط التجاري مؤهَّلاً لإعادة فتحه.
openingDate

object (Date)

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

OpenForBusiness

يشير إلى حالة موقع جغرافي.

عمليات التعداد
OPEN_FOR_BUSINESS_UNSPECIFIED لم يتم تحديده.
OPEN يشير إلى أن الموقع مفتوح.
CLOSED_PERMANENTLY يشير إلى أن الموقع قد تم إغلاقه نهائيًا.
CLOSED_TEMPORARILY يشير إلى أن الموقع الجغرافي قد تم إغلاقه مؤقتًا.

البيانات الوصفية

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

تمثيل JSON 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}
الحقول
hasGoogleUpdated

boolean

النتائج فقط. يشير إلى ما إذا كان رقم تعريف المكان المرتبط بهذا الموقع الجغرافي يحتوي على تعديلات يحتاج العميل إلى تعديلها أو رفضها. في حال ضبط هذه القيمة المنطقية، عليك استدعاء طريقة getGoogleUpdated للبحث عن المعلومات التي يجب إثبات صحتها.
hasPendingEdits

boolean

النتائج فقط. يشير إلى ما إذا كان أي من خصائص هذا الموقع في حالة التعديل.
canDelete

boolean

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

boolean

النتائج فقط. تشير هذه السمة إلى ما إذا كان يمكن لبطاقة بيانات المتجر إدارة المشاركات المحلية.
canModifyServiceList

boolean

النتائج فقط. يشير هذا الحقل إلى ما إذا كان بإمكان بطاقة بيانات المتجر تعديل قائمة الخدمات.
canHaveFoodMenus

boolean

النتائج فقط. تشير هذه السمة إلى ما إذا كانت البيانات مؤهّلة لقائمة الطعام.
canOperateHealthData

boolean

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

boolean

النتائج فقط. يشير إلى ما إذا كان يمكن للموقع الجغرافي العمل استنادًا إلى بيانات الإقامة.
placeId

string

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

يمكن ضبط هذا الحقل أثناء إنشاء مكالمات، ولكن ليس لإجراء "تحديث".
duplicateLocation

string

النتائج فقط. مورد الموقع الذي يكرر هذا الموقع.
mapsUri

string

النتائج فقط. رابط إلى الموقع الجغرافي على "خرائط Google"
newReviewUri

string

النتائج فقط. رابط إلى الصفحة على "بحث Google" حيث يمكن للعميل إضافة مراجعة عن الموقع الجغرافي.
canHaveBusinessCalls

boolean

النتائج فقط. يشير هذا الحقل إلى ما إذا كانت بطاقة بيانات المتجر مؤهَّلة لمكالمات النشاط التجاري.
hasVoiceOfMerchant

boolean

النتائج فقط. تشير هذه السمة إلى ما إذا كانت البيانات تتضمّن خدمة Voice of Merchant. إذا كانت هذه القيمة المنطقية خاطئة، يجب طلب واجهة برمجة التطبيقات location.getVoiceOfMerchantState API للحصول على تفاصيل عن سبب عدم توفّر خدمة Voice of Merchant.

الملف الشخصي

كل المعلومات ذات الصلة بالملف الشخصي للموقع الجغرافي.

تمثيل JSON 
{
  "description": string
}
الحقول
description

string

مطلوب. وصف للموقع الجغرافي بصوتك، ولا يمكن لأي شخص آخر تعديله.

RelationshipData

معلومات عن جميع المواقع الجغرافية للوالدَين والأطفال المرتبطة بهذا الموقع الجغرافي

تمثيل JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
الحقول
parentLocation

object (RelevantLocation)

الموقع الجغرافي الرئيسي الذي يرتبط به هذا الموقع الجغرافي.
childrenLocations[]

object (RelevantLocation)

قائمة المواقع الجغرافية الفرعية التي يرتبط بها هذا الموقع الجغرافي.
parentChain

string

اسم مورد السلسلة الذي ينتمي إليه هذا الموقع الجغرافي. [كيفية العثور على رقم تعريف السلسلة] [Locations.SearchChains]

RelevantLocation

معلومات حول موقع جغرافي آخر مرتبط بالموقع الجغرافي الحالي يمكن أن تكون العلاقة أي من DEPARTMENT_OF أو INDEPENDENT_ESTABLISHMENT_OF، ويمكن أن يكون الموقع المحدد هنا على أي من جانبي الموقع (الأصل/التابع).

تمثيل JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
الحقول
placeId

string

مطلوب. حدِّد الموقع الجغرافي على الجانب الآخر من العلاقة باستخدام رقم تعريف المكان.
relationType

enum (RelationType)

مطلوب. نوع العلاقة.

RelationType

علاقات النوع المراد تحديدها.

عمليات التعداد
RELATION_TYPE_UNSPECIFIED لم يتم تحديد النوع.
DEPARTMENT_OF يمثّل ذلك العلاقة بين موقعَين جغرافيَّين يتشاركان في منطقة جغرافية واحدة، والعلامة التجارية نفسها أو الإدارة العليا أو المؤسسة نفسها، ولكن بسمات رئيسية مختلفة، مثل ساعات عمل المتجر أو أرقام الهاتف. على سبيل المثال، صيدلية Costco هي قسم في Costco بالجملة.
INDEPENDENT_ESTABLISHMENT_IN وتمثّل هذه القيمة الحالات التي يتشارك فيها موقعان جغرافيان الموقع الجغرافي نفسه، ولكن من شركات مختلفة (مثل مقهى "ستاربكس" في طريق "سافيواي" والمتاجر في مركز تجاري).

MoreHours

الفترات الزمنية التي يفتح خلالها الموقع الجغرافي لأنواع معيّنة من الأنشطة التجارية.

تمثيل JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
الحقول
hoursTypeId

string

مطلوب. نوع ساعات العمل. ويجب أن يتصل العملاء بـ {#link businesscategory:BatchGet} للحصول على أنواع ساعات العمل المتوفرة لفئات مواقعهم الجغرافية.
periods[]

object (TimePeriod)

مطلوب. هذه مجموعة للأوقات التي يكون فيها هذا الموقع الجغرافي مفتوحًا. تمثل كل فترة نطاقًا من الساعات التي يكون فيها الموقع الجغرافي مفتوحًا خلال الأسبوع.

ServiceItem

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

تمثيل JSON 
{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
الحقول
price

object (Money)

اختياريّ. تمثّل هذه السمة السعر النقدي لعنصر الخدمة. وننصح بضبط رمز العملة والوحدات عند تضمين سعر. وسيتم اعتبار هذا السعر كسعر ثابت لعنصر الخدمة.
حقل الاتحاد service_item_info. يجب دائمًا ضبط أحد الحقول التالية. يمكن أن يكون service_item_info واحدًا فقط مما يلي:
structuredServiceItem

object (StructuredServiceItem)

اختياريّ. سيتم ضبط هذا الحقل على حالة بيانات الخدمات المنظَّمة.
freeFormServiceItem

object (FreeFormServiceItem)

اختياريّ. سيتم ضبط هذا الحقل على حالة بيانات الخدمات الحرة.

StructuredServiceItem

إذا كان يمثّل خدمة منظَّمة يقدّمها التاجر على سبيل المثال: toilet_installation.

تمثيل JSON 
{
  "serviceTypeId": string,
  "description": string
}
الحقول
serviceTypeId

string

مطلوب. الحقل serviceTypeId هو معرّف فريد توفّره Google ويمكن العثور عليه في ServiceType. يتم توفير هذه المعلومات من خلال خدمة متوسط عائد النقرة في "categories.batchGet".
description

string

اختياريّ. وصف عنصر الخدمة المنظَّم. عدد الأحرف المسموح به هو 300.

FreeFormServiceItem

تمثّل هذه السمة خدمة ذات تصميم مرن يقدّمها التاجر. وهذه هي خدمات لا يتم الكشف عنها كجزء من بيانات الخدمة المنظَّمة. ويُدخِل التاجر أسماء هذه الخدمات يدويًا عبر واجهة التاجر الجغرافية.

تمثيل JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
الحقول
category

string

مطلوب. يمثل هذا الحقل اسم الفئة (أي المعرّف الثابت للفئة). يجب أن يتطابق category وserviceTypeId مع التركيبات المحتملة الواردة في رسالة Category.
label

object (Label)

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

التصنيف

تصنيف يتم استخدامه عند عرض قائمة الأسعار أو القسم أو السلعة

تمثيل JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
الحقول
displayName

string

مطلوب. الاسم المعروض لقائمة الأسعار أو القسم أو السلعة.
description

string

اختياريّ. وصف قائمة الأسعار أو القسم أو العنصر.
languageCode

string

اختياريّ. تمثّل هذه السمة رمز اللغة BCP-47 الذي تنطبق عليه هذه السلاسل. لا يمكن ضبط أكثر من مجموعة واحدة من التصنيفات لكل لغة.

المال

يمثل مبلغًا من المال مع نوع العملة.

تمثيل JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
الحقول
currencyCode

string

تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217.
units

string (int64 format)

تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة currencyCode هي "USD"، تكون قيمة الوحدة الواحدة دولار أمريكي واحد.
nanos

integer

عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت قيمة units موجبة، يجب أن تكون قيمة nanos موجبة أو صفرًا. إذا كانت قيمة units صفرًا، يمكن أن تكون قيمة nanos موجبة أو صفرية أو سالبة. إذا كانت units سالبة، يجب أن تكون قيمة nanos سالبة أو صفرًا. على سبيل المثال، يتم تمثيل $1.75 على النحو التالي: units=-1 وnanos=-750,000,000.

الطُرق

create

 إنشاء موقع جديد يملكه المستخدم الذي سجّل الدخول.

list

 يسرد المواقع الجغرافية للحساب المحدّد.