- المورد: الموقع الجغرافي
- تمثيل JSON
- PhoneNumbers
- الفئات
- الفئة
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- التاريخ
- ServiceAreaBusiness
- BusinessType
- أماكن
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- البيانات الوصفية
- الملف الشخصي
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- التصنيف
- المال
- الطُرق
المرجع: الموقع الجغرافي
موقع جغرافي راجِع مقالة مركز المساعدة للحصول على وصف تفصيلي لهذه الحقول، أو نقطة نهاية الفئة للحصول على قائمة بفئات الأنشطة التجارية الصالحة.
تمثيل JSON |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
الحقول | |
---|---|
name |
معرّف Google لهذا الموقع الجغرافي بالصيغة: |
languageCode |
غير قابل للتغيير. لغة الموقع الجغرافي. يتم ضبط القيمة أثناء الإنشاء ولا يمكن تعديلها. |
storeCode |
اختياريّ. المعرّف الخارجي لهذا الموقع الجغرافي، والذي يجب أن يكون فريدًا ضمن حساب معيّن وتعد هذه وسيلة لإقران الموقع بسجلاتك الخاصة. |
title |
مطلوب. يجب أن يعكس اسم الموقع الجغرافي الاسم الفعلي لنشاطك التجاري، كما هو معروف لدى العملاء على واجهة متجرك وموقعك الإلكتروني وأدواتك المكتبية. يمكن تضمين أي معلومات إضافية، عند الاقتضاء، في حقول أخرى من المورد (على سبيل المثال، |
phoneNumbers |
اختياريّ. أرقام الهاتف المختلفة التي يمكن للعملاء استخدامها للتواصل مع النشاط التجاري. |
categories |
اختياريّ. الفئات المختلفة التي تصف النشاط التجاري. |
storefrontAddress |
اختياريّ. عنوان دقيق ودقيق لوصف الموقع الجغرافي لنشاطك التجاري ولا يتم قبول صناديق البريد الواقعة في مواقع جغرافية نائية. في الوقت الحالي، يمكنك تحديد خمس قيم كحد أقصى للحقل " |
websiteUri |
اختياريّ. عنوان URL لهذا النشاط التجاري. استخدِم، إن أمكن، عنوان URL يمثّل الموقع الجغرافي للنشاط التجاري الفردي بدلاً من موقع إلكتروني عام أو عنوان URL عام يمثّل كل المواقع الجغرافية أو العلامة التجارية. |
regularHours |
اختياريّ. ساعات العمل للنشاط التجاري. |
specialHours |
اختياريّ. ساعات العمل الخاصة للنشاط التجاري. ويشمل ذلك عادةً ساعات العمل خلال العطلات وأوقات أخرى خارج ساعات العمل العادية. ويلغي ذلك ساعات العمل العادية. لا يمكن ضبط هذا الحقل بدون ساعات العمل العادية. |
serviceArea |
اختياريّ. تقدّم الأنشطة التجارية ذات منطقة نطاق الخدمة خدمتها في الموقع الجغرافي للعميل. إذا كان هذا النشاط التجاري عبارة عن نشاط تجاري يقدّم منطقة نطاق خدمة، يصف هذا الحقل المناطق التي يخدمها النشاط التجاري. |
labels[] |
اختياريّ. هي مجموعة من السلاسل الحرة التي تتيح لك الإشارة إلى نشاطك التجاري. هذه التصنيفات لا تكون موجّهة للمستخدمين، لا يمكن لأحد سواك رؤيتها. يجب أن يتراوح عدد الأحرف بين حرف واحد و255 حرفًا لكل تصنيف. |
adWordsLocationExtensions |
اختياريّ. المعلومات الإضافية التي يتم عرضها في AdWords |
latlng |
اختياريّ. خطوط الطول والعرض المقدَّمة من المستخدم. عند إنشاء موقع، يتم تجاهل هذا الحقل إذا كان الترميز الجغرافي للعنوان المقدَّم يعمل بنجاح. لا يتم عرض هذا الحقل في طلبات تلقّي الطلبات إلا إذا تم قبول قيمة |
openInfo |
اختياريّ. علامة تشير إلى ما إذا كان الموقع الجغرافي مفتوحًا حاليًا للنشاط التجاري. |
metadata |
النتائج فقط. معلومات إضافية غير قابلة للتعديل من قِبل المستخدم |
profile |
اختياريّ. تصف نشاطك التجاري بأسلوبك الخاص ويشارك مع المستخدمين القصة الفريدة لنشاطك التجاري وعروضك. يكون هذا الحقل مطلوبًا لجميع الفئات باستثناء فئات أماكن الإقامة (مثل الفنادق والاستراحات والاستراحات). |
relationshipData |
اختياريّ. جميع المواقع والسلسلة ذات الصلة بهذا الموقع. |
moreHours[] |
اختياريّ. ساعات عمل إضافية للأقسام المختلفة في النشاط التجاري أو لعملاء محددين. |
serviceItems[] |
اختياريّ. قائمة الخدمات التي يوفّرها التجّار يمكن أن تشمل الخدمة قصّ الشعر أو تركيب سخّان مياه أو غير ذلك. وستتم تلقائيًا إزالة عناصر الخدمة المكررة. |
PhoneNumbers
مجموعة من أرقام الهواتف للنشاط التجاري. أثناء إجراء التحديثات، يجب ضبط كلا الحقلَين. لا يمكن للعملاء تعديل أرقام الهواتف الأساسية أو الإضافية فقط باستخدام قناع التحديث. يُفضَّل استخدام تنسيق الهاتف الدولي، مثل " +1 415 555 0132"، ويمكنك الاطّلاع على مزيد من المعلومات في (https://developers.google.com/style/phone-numbers#international-phone-numbers).
تمثيل JSON |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
الحقول | |
---|---|
primaryPhone |
مطلوب. رقم هاتف يتصل بموقع نشاطك التجاري الفردي بشكل مباشر قدر الإمكان. استخدِم رقم هاتف محليًا بدلاً من استخدام رقم خط مساعدة مركزي في مركز اتصالات متى أمكن ذلك. |
additionalPhones[] |
اختياريّ. ما يصل إلى رقمَي هاتف (جوّال أو أرضي، لا يُسمح بالفاكس) يمكن الاتصال بنشاطك التجاري، بالإضافة إلى رقم هاتفك الأساسي. |
الفئات
هي مجموعة من الفئات التي تصف النشاط التجاري. أثناء إجراء التحديثات، يجب ضبط كلا الحقلَين. ويُحظر على العملاء تعديل الفئات الأساسية أو الإضافية بشكل فردي باستخدام قناع التحديث.
تمثيل JSON |
---|
{ "primaryCategory": { object ( |
الحقول | |
---|---|
primaryCategory |
مطلوب. الفئة التي تصف النشاط التجاري الأساسي الذي يشارك فيه هذا الموقع الجغرافي على أفضل وجه |
additionalCategories[] |
اختياريّ. فئات إضافية لوصف نشاطك التجاري. تساعد الفئات عملاءك في العثور على نتائج دقيقة ومحددة للخدمات التي تهمهم. وللحفاظ على دقة معلومات نشاطك التجاري واستمرار عرضها، احرص على استخدام أقل عدد ممكن من الفئات لوصف نشاطك التجاري الأساسي بصورة شاملة. اختَر فئات محدّدة قدر الإمكان، على أن تمثّل نشاطك التجاري الرئيسي. |
الفئة
فئة تصف ماهية هذا النشاط التجاري (وليس ما يقدّمه). للحصول على قائمة بمعرّفات الفئات الصالحة وعمليات الربط لأسمائها التي يمكن للمستخدمين قراءتها، يُرجى الاطّلاع على categories.list
.
تمثيل JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
الحقول | |
---|---|
name |
مطلوب. معرّف ثابت (توفّره Google) لهذه الفئة يجب تحديد القيمة عند تعديل الفئة (عند إنشاء موقع أو تعديله). |
displayName |
النتائج فقط. تمثّل هذه السمة اسم الفئة سهل القراءة للمستخدم. ويتم ضبطه عند قراءة الموقع الجغرافي. عند تعديل الموقع الجغرافي، يجب ضبط |
serviceTypes[] |
النتائج فقط. قائمة بجميع أنواع الخدمات المتاحة لفئة النشاط التجاري هذه. |
moreHoursTypes[] |
النتائج فقط. أنواع ساعات العمل الإضافية المتاحة لفئة النشاط التجاري هذه. |
ServiceType
رسالة تصف نوع الخدمة التي يقدّمها النشاط التجاري
تمثيل JSON |
---|
{ "serviceTypeId": string, "displayName": string } |
الحقول | |
---|---|
serviceTypeId |
النتائج فقط. معرّف ثابت (توفّره Google) لهذا النوع من الخدمات |
displayName |
النتائج فقط. الاسم المعروض لنوع الخدمة الذي يمكن للمستخدمين قراءته. |
MoreHoursType
أنواع ساعات العمل الإضافية التي يمكن أن يقدِّمها النشاط التجاري، بالإضافة إلى ساعات العمل العادية.
تمثيل JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
الحقول | |
---|---|
hoursTypeId |
النتائج فقط. معرّف ثابت توفّره Google لنوع ساعات العمل هذا |
displayName |
النتائج فقط. تمثّل هذه السمة الاسم المعروض باللغة الإنجليزية الذي يمكن للمستخدم قراءته لنوع الساعات. |
localizedDisplayName |
النتائج فقط. الاسم المعروض المترجَم الذي يمكن للمستخدمين قراءته لنوع ساعات العمل. |
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 |
تمثّل هذه السمة مراجعة المخطط لـ يجب أن تكون جميع النُسخ السابقة متوافقة مع الإصدارات القديمة. |
regionCode |
مطلوب. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان. لا يتم استنتاج ذلك أبدًا، وتقع على عاتق المستخدم مسؤولية التأكّد من صحة القيمة. يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html لمعرفة التفاصيل. مثال: "CH" لسويسرا. |
languageCode |
اختياريّ. رمز لغة محتوى هذا العنوان BCP-47 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم لنموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدمة في العنوان الدولة/المنطقة، أو ما يعادلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق. وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة). أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en". |
postalCode |
اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية). |
sortingCode |
اختياريّ. رمز فرز إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. عند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة بشكل اختياري برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا)، "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (على سبيل المثال: ساحل العاج). |
administrativeArea |
اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، بالنسبة إلى إسبانيا، هذه هي الإقليم وليس المجتمع المستقلّ (على سبيل المثال، "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. مثلاً: في سويسرا يجب عدم تعبئة هذا الحقل. |
locality |
اختياريّ. يشير بوجه عام إلى الجزء من المدينة/البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم addressLines. |
sublocality |
اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق. |
addressLines[] |
أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان. بما أنّ القيم في addressLines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أبو ظبي، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان "ترتيب على شكل مغلف". للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة. إنّ الحد الأدنى المسموح به للتمثيل الهيكلي للعنوان هو رمز المنطقة مع جميع المعلومات المتبقية في سطر العنوان. سيكون من الممكن تنسيق هذا العنوان تقريبًا بدون ترميز جغرافي، ولكن لا يمكن وضع أي تفسير دلالي حول أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل. إنشاء عنوان يحتوي فقط على رمز المنطقة وسطر العنوان، ومن ثمَّ يُعتبر الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون مناطق محلية أو مناطق إدارية). |
recipients[] |
اختياريّ. المستلِم في العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على كلمة "رعاية" المعلومات. |
organization |
اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان. |
BusinessHours
تمثل الفترات الزمنية التي يكون فيها هذا الموقع الجغرافي مفتوحًا للنشاط التجاري. يتضمن مجموعة من مثيلات [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].
تمثيل JSON |
---|
{
"periods": [
{
object ( |
الحقول | |
---|---|
periods[] |
مطلوب. هذه مجموعة للأوقات التي يكون فيها هذا الموقع الجغرافي مفتوحًا لمزاولة النشاط التجاري. تمثل كل فترة نطاقًا من الساعات التي يكون فيها الموقع الجغرافي مفتوحًا خلال الأسبوع. |
TimePeriod
يمثل فترة زمنية يكون فيها النشاط التجاري مفتوحًا، بدءًا من اليوم/الوقت المفتوح المحدد والإغلاق في يوم/وقت الإغلاق المحدد. يجب أن يكون وقت الإغلاق بعد وقت الفتح، على سبيل المثال، في وقت لاحق من اليوم نفسه أو في يوم لاحق.
تمثيل JSON |
---|
{ "openDay": enum ( |
الحقول | |
---|---|
openDay |
مطلوب. يشير إلى |
openTime |
مطلوب. القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. |
closeDay |
مطلوب. ويشير إلى |
closeTime |
مطلوب. القيم الصالحة هي 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 |
ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل موعد إغلاق العمل. |
minutes |
دقائق من ساعات اليوم. يجب أن تتراوح القيمة بين 0 و59. |
seconds |
ثواني الدقائق من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة. |
nanos |
الكسور من الثواني بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999. |
SpecialHours
ويمثِّل مجموعة من الفترات الزمنية التي تختلف فيها ساعات العمل في الموقع الجغرافي عن ساعات العمل العادية.
تمثيل JSON |
---|
{
"specialHourPeriods": [
{
object ( |
الحقول | |
---|---|
specialHourPeriods[] |
مطلوب. قائمة بالاستثناءات لساعات العمل العادية للنشاط التجاري. |
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 ( |
الحقول | |
---|---|
startDate |
مطلوب. تاريخ التقويم الذي تبدأ فيه فترة الساعة الخاصة هذه. |
openTime |
اختياريّ. القيم الصالحة هي 00:00-24:00 حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. يجب تحديدها إذا كانت السمة |
endDate |
اختياريّ. التاريخ التقويمي الذي تنتهي فيه فترة الساعة الخاصة هذه. إذا لم يتم ضبط حقل |
closeTime |
اختياريّ. القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. يجب تحديدها إذا كانت السمة |
closed |
اختياريّ. إذا كانت القيمة هي true، سيتم تجاهل |
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر حيث لا يكون اليوم مهمًا. |
ServiceAreaBusiness
تقدّم الأنشطة التجارية ذات نطاق الخدمة خدمتها في موقع العميل (على سبيل المثال، صناعة أقفال أو سباكة).
تمثيل JSON |
---|
{ "businessType": enum ( |
الحقول | |
---|---|
businessType |
مطلوب. تشير هذه السمة إلى [type]. [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] الخاص بالنشاط التجاري لمنطقة الخدمة. |
places |
يتم تحديد المنطقة التي يخدمها هذا النشاط التجاري من خلال مجموعة من الأماكن. |
regionCode |
غير قابل للتغيير. رمز 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 ( |
الحقول | |
---|---|
placeInfos[] |
المناطق التي تمثلها أرقام تعريف الأماكن. الحد الأقصى هو 20 مكانًا. |
PlaceInfo
لتحديد المنطقة التي يتم تمثيلها برقم تعريف مكان.
تمثيل JSON |
---|
{ "placeName": string, "placeId": string } |
الحقول | |
---|---|
placeName |
مطلوب. الاسم المترجم للمكان. مثلاً: |
placeId |
مطلوب. رقم تعريف المكان. يجب أن يكون متوافقًا مع منطقة معيّنة. (https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
المعلومات الإضافية التي يتم عرضها في AdWords
تمثيل JSON |
---|
{ "adPhone": string } |
الحقول | |
---|---|
adPhone |
مطلوب. رقم هاتف بديل للعرض في إضافات مواقع AdWords بدلاً من رقم الهاتف الأساسي للموقع. |
LatLng
كائن يمثّل زوجًا من خط العرض/الطول ويتم التعبير عن ذلك في صورة زوج من الزوجين لتمثيل درجات الطول والعرض والدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُذكر خلاف ذلك. يجب أن تكون القيم ضمن النطاقات التي تمت تسويتها.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
خط العرض بالدرجات. يجب أن يكون في النطاق [ -90.0، +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون في النطاق [ -180.0، +180.0]. |
OpenInfo
معلومات ذات صلة بالحالة الافتتاحية للنشاط التجاري.
تمثيل JSON |
---|
{ "status": enum ( |
الحقول | |
---|---|
status |
مطلوب. يشير إلى ما إذا كان الموقع الجغرافي مفتوحًا حاليًا للنشاط التجاري أم لا. تكون جميع المواقع الجغرافية مفتوحة تلقائيًا، ما لم يتم تعديلها لتصبح مغلقة. |
canReopen |
النتائج فقط. تشير إلى ما إذا كان هذا النشاط التجاري مؤهَّلاً لإعادة فتحه. |
openingDate |
اختياريّ. تاريخ فتح الموقع الجغرافي لأول مرة. إذا لم يكن اليوم تحديدًا معروفًا، يمكن تقديم الشهر والسنة فقط. يجب أن يكون التاريخ في الماضي أو ألا يزيد عن عام واحد في المستقبل. |
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 |
النتائج فقط. يشير إلى ما إذا كان رقم تعريف المكان المرتبط بهذا الموقع الجغرافي يحتوي على تعديلات يحتاج العميل إلى تعديلها أو رفضها. في حال ضبط هذه القيمة المنطقية، عليك استدعاء طريقة |
hasPendingEdits |
النتائج فقط. يشير إلى ما إذا كان أي من خصائص هذا الموقع في حالة التعديل. |
canDelete |
النتائج فقط. تشير هذه السياسة إلى ما إذا كان يمكن حذف الموقع الجغرافي باستخدام واجهة برمجة التطبيقات. |
canOperateLocalPost |
النتائج فقط. تشير هذه السمة إلى ما إذا كان يمكن لبطاقة بيانات المتجر إدارة المشاركات المحلية. |
canModifyServiceList |
النتائج فقط. يشير هذا الحقل إلى ما إذا كان بإمكان بطاقة بيانات المتجر تعديل قائمة الخدمات. |
canHaveFoodMenus |
النتائج فقط. تشير هذه السمة إلى ما إذا كانت البيانات مؤهّلة لقائمة الطعام. |
canOperateHealthData |
النتائج فقط. تشير هذه السمة إلى ما إذا كان من الممكن استخدام الموقع الجغرافي استنادًا إلى البيانات الصحية. |
canOperateLodgingData |
النتائج فقط. يشير إلى ما إذا كان يمكن للموقع الجغرافي العمل استنادًا إلى بيانات الإقامة. |
placeId |
النتائج فقط. إذا ظهر هذا الموقع الجغرافي على "خرائط Google"، تتم تعبئة هذا الحقل برقم تعريف المكان للموقع الجغرافي. ويمكن استخدام هذا المعرّف في واجهات برمجة تطبيقات للأماكن المختلفة. يمكن ضبط هذا الحقل أثناء إنشاء مكالمات، ولكن ليس لإجراء "تحديث". |
duplicateLocation |
النتائج فقط. مورد الموقع الذي يكرر هذا الموقع. |
mapsUri |
النتائج فقط. رابط إلى الموقع الجغرافي على "خرائط Google" |
newReviewUri |
النتائج فقط. رابط إلى الصفحة على "بحث Google" حيث يمكن للعميل إضافة مراجعة عن الموقع الجغرافي. |
canHaveBusinessCalls |
النتائج فقط. يشير هذا الحقل إلى ما إذا كانت بطاقة بيانات المتجر مؤهَّلة لمكالمات النشاط التجاري. |
hasVoiceOfMerchant |
النتائج فقط. تشير هذه السمة إلى ما إذا كانت البيانات تتضمّن خدمة Voice of Merchant. إذا كانت هذه القيمة المنطقية خاطئة، يجب طلب واجهة برمجة التطبيقات location.getVoiceOfMerchantState API للحصول على تفاصيل عن سبب عدم توفّر خدمة Voice of Merchant. |
الملف الشخصي
كل المعلومات ذات الصلة بالملف الشخصي للموقع الجغرافي.
تمثيل JSON |
---|
{ "description": string } |
الحقول | |
---|---|
description |
مطلوب. وصف للموقع الجغرافي بصوتك، ولا يمكن لأي شخص آخر تعديله. |
RelationshipData
معلومات عن جميع المواقع الجغرافية للوالدَين والأطفال المرتبطة بهذا الموقع الجغرافي
تمثيل JSON |
---|
{ "parentLocation": { object ( |
الحقول | |
---|---|
parentLocation |
الموقع الجغرافي الرئيسي الذي يرتبط به هذا الموقع الجغرافي. |
childrenLocations[] |
قائمة المواقع الجغرافية الفرعية التي يرتبط بها هذا الموقع الجغرافي. |
parentChain |
اسم مورد السلسلة الذي ينتمي إليه هذا الموقع الجغرافي. [كيفية العثور على رقم تعريف السلسلة] [Locations.SearchChains] |
RelevantLocation
معلومات حول موقع جغرافي آخر مرتبط بالموقع الجغرافي الحالي يمكن أن تكون العلاقة أي من DEPARTMENT_OF أو INDEPENDENT_ESTABLISHMENT_OF، ويمكن أن يكون الموقع المحدد هنا على أي من جانبي الموقع (الأصل/التابع).
تمثيل JSON |
---|
{
"placeId": string,
"relationType": enum ( |
الحقول | |
---|---|
placeId |
مطلوب. حدِّد الموقع الجغرافي على الجانب الآخر من العلاقة باستخدام رقم تعريف المكان. |
relationType |
مطلوب. نوع العلاقة. |
RelationType
علاقات النوع المراد تحديدها.
عمليات التعداد | |
---|---|
RELATION_TYPE_UNSPECIFIED |
لم يتم تحديد النوع. |
DEPARTMENT_OF |
يمثّل ذلك العلاقة بين موقعَين جغرافيَّين يتشاركان في منطقة جغرافية واحدة، والعلامة التجارية نفسها أو الإدارة العليا أو المؤسسة نفسها، ولكن بسمات رئيسية مختلفة، مثل ساعات عمل المتجر أو أرقام الهاتف. على سبيل المثال، صيدلية Costco هي قسم في Costco بالجملة. |
INDEPENDENT_ESTABLISHMENT_IN |
وتمثّل هذه القيمة الحالات التي يتشارك فيها موقعان جغرافيان الموقع الجغرافي نفسه، ولكن من شركات مختلفة (مثل مقهى "ستاربكس" في طريق "سافيواي" والمتاجر في مركز تجاري). |
MoreHours
الفترات الزمنية التي يفتح خلالها الموقع الجغرافي لأنواع معيّنة من الأنشطة التجارية.
تمثيل JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
الحقول | |
---|---|
hoursTypeId |
مطلوب. نوع ساعات العمل. ويجب أن يتصل العملاء بـ {#link businesscategory:BatchGet} للحصول على أنواع ساعات العمل المتوفرة لفئات مواقعهم الجغرافية. |
periods[] |
مطلوب. هذه مجموعة للأوقات التي يكون فيها هذا الموقع الجغرافي مفتوحًا. تمثل كل فترة نطاقًا من الساعات التي يكون فيها الموقع الجغرافي مفتوحًا خلال الأسبوع. |
ServiceItem
يشير ذلك المصطلح إلى رسالة تصف عنصر خدمة واحدًا. وهي تُستخدم لوصف نوع الخدمة التي يقدّمها التاجر. على سبيل المثال، يمكن أن يكون قص الشعر خدمة.
تمثيل JSON |
---|
{ "price": { object ( |
الحقول | |
---|---|
price |
اختياريّ. تمثّل هذه السمة السعر النقدي لعنصر الخدمة. وننصح بضبط رمز العملة والوحدات عند تضمين سعر. وسيتم اعتبار هذا السعر كسعر ثابت لعنصر الخدمة. |
حقل الاتحاد service_item_info . يجب دائمًا ضبط أحد الحقول التالية. يمكن أن يكون service_item_info واحدًا فقط مما يلي: |
|
structuredServiceItem |
اختياريّ. سيتم ضبط هذا الحقل على حالة بيانات الخدمات المنظَّمة. |
freeFormServiceItem |
اختياريّ. سيتم ضبط هذا الحقل على حالة بيانات الخدمات الحرة. |
StructuredServiceItem
إذا كان يمثّل خدمة منظَّمة يقدّمها التاجر على سبيل المثال: toilet_installation.
تمثيل JSON |
---|
{ "serviceTypeId": string, "description": string } |
الحقول | |
---|---|
serviceTypeId |
مطلوب. الحقل |
description |
اختياريّ. وصف عنصر الخدمة المنظَّم. عدد الأحرف المسموح به هو 300. |
FreeFormServiceItem
تمثّل هذه السمة خدمة ذات تصميم مرن يقدّمها التاجر. وهذه هي خدمات لا يتم الكشف عنها كجزء من بيانات الخدمة المنظَّمة. ويُدخِل التاجر أسماء هذه الخدمات يدويًا عبر واجهة التاجر الجغرافية.
تمثيل JSON |
---|
{
"category": string,
"label": {
object ( |
الحقول | |
---|---|
category |
مطلوب. يمثل هذا الحقل اسم الفئة (أي المعرّف الثابت للفئة). يجب أن يتطابق |
label |
مطلوب. التصنيفات التي تحمل علامات لغة للعنصر. ننصح بأن تتضمن أسماء العناصر 140 حرفًا أو أقل، وأن تتضمّن الأوصاف 250 حرفًا أو أقل. يجب ضبط هذا الحقل فقط إذا كان الإدخال هو عنصر خدمة مخصّص. يجب تعديل أنواع الخدمات الموحّدة من خلال serviceTypeId. |
التصنيف
تصنيف يتم استخدامه عند عرض قائمة الأسعار أو القسم أو السلعة
تمثيل JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
الحقول | |
---|---|
displayName |
مطلوب. الاسم المعروض لقائمة الأسعار أو القسم أو السلعة. |
description |
اختياريّ. وصف قائمة الأسعار أو القسم أو العنصر. |
languageCode |
اختياريّ. تمثّل هذه السمة رمز اللغة BCP-47 الذي تنطبق عليه هذه السلاسل. لا يمكن ضبط أكثر من مجموعة واحدة من التصنيفات لكل لغة. |
المال
يمثل مبلغًا من المال مع نوع العملة.
تمثيل JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
الحقول | |
---|---|
currencyCode |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدّد في ISO 4217. |
units |
تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة |
nanos |
عدد وحدات نانو (10^-9) من الكمية. يجب أن تتراوح القيمة بين -999,999,999 و +999,999,999 أو أكثر. إذا كانت قيمة |
الطُرق |
|
---|---|
|
إنشاء موقع جديد يملكه المستخدم الذي سجّل الدخول. |
|
يسرد المواقع الجغرافية للحساب المحدّد. |