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. - 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)

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

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

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

string

اختيارية: الموقع الفرعي للعنوان على سبيل المثال، يمكن أن يكون هذا حيًا أو دائرة أو منطقة.
addressLines[]

string

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

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

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

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

string

اختيارية: المستلِم على العنوان قد يحتوي هذا الحقل، في ظروف معيّنة، على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على معلومات "care of".
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 منتصف الليل في نهاية حقل اليوم المحدّد. ملاحظة: في عملية ربط Proto3 JSON، يتم حذف القيم التلقائية التي تساوي صفرًا (00:00)، ما يؤدي إلى ظهور {} في openTime.
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

الحقل مطلوب. القيم الصالحة هي من 00:00 إلى 24:00، حيث يمثّل الوقت 24:00 منتصف الليل في نهاية حقل اليوم المحدّد. ملاحظة: في عملية ربط Proto3 JSON، يتم حذف القيم التلقائية التي تساوي صفرًا (00:00)، ما يؤدي إلى ظهور {} في closeTime.

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 هي false.
endDate

object (Date)

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

object (TimeOfDay)

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

boolean

اختيارية: إذا كانت القيمة صحيحة، يتم تجاهل 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)

الحقل مطلوب. يشير إلى [نوع] [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

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

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

string

الحقل مطلوب. رقم هاتف بديل لعرضه في إضافات المواقع الجغرافية في "إعلانات Google" بدلاً من رقم الهاتف الأساسي للموقع الجغرافي

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,
  "isParticularlyPersonalPlace": boolean
}
الحقول
hasGoogleUpdated

boolean

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

boolean

للعرض فقط. تشير إلى ما إذا كانت أي من سمات هذا الموقع الجغرافي في حالة تعديل في انتظار المراجعة.
canDelete

boolean

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

boolean

للعرض فقط. متوقّف نهائيًا: لم يعُد هذا الحقل متاحًا وستتم إزالته في إصدار مستقبلي.
canModifyServiceList

boolean

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

boolean

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

boolean

للعرض فقط. يشير إلى ما إذا كان بإمكان الموقع الجغرافي معالجة البيانات الصحية.
canOperateLodgingData

boolean

للعرض فقط. يشير إلى ما إذا كان بإمكان الموقع الجغرافي العمل على بيانات "أماكن الإقامة".
placeId

string

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

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

string

للعرض فقط. مورد الموقع الجغرافي الذي يكرّره هذا الموقع الجغرافي
mapsUri

string

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

string

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

boolean

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

boolean

للعرض فقط. يشير هذا الحقل إلى ما إذا كانت بطاقة البيانات تتضمّن ميزة "آراء التجّار". إذا كانت هذه القيمة المنطقية خاطئة، عليك طلب واجهة برمجة التطبيقات locations.getVoiceOfMerchantState للحصول على تفاصيل حول سبب عدم توفّر ميزة "رأي التاجر".
isParticularlyPersonalPlace

boolean

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

الملف الشخصي

كل المعلومات المتعلقة بالملف التجاري للموقع الجغرافي

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

string

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

RelationshipData

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

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

object (RelevantLocation)

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

object (RelevantLocation)

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

string

اختيارية: اسم مصدر السلسلة التي ينتمي إليها هذا الموقع الجغرافي [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

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

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

string

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

enum (RelationType)

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

RelationType

العلاقات بين الأنواع التي يجب تحديدها.

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

MoreHours

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

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

string

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

object (TimePeriod)

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

ServiceItem

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
الحقول
price

object (Money)

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

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

اختيارية: سيتم ضبط هذا الحقل في حال توفُّر بيانات الخدمات ذات التصميم المرن.
نهاية الحقول التي يستبعد كلّ منها الآخر

StructuredServiceItem

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

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

string

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

string

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

FreeFormServiceItem

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

تمثيل 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

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