- المورد: الموقع الجغرافي
- تمثيل JSON
- BusinessHours
- TimePeriod
- DayOfWeek
- SpecialHours
- SpecialHourPeriod
- ServiceAreaBusiness
- BusinessType
- PointRadius
- LatLng
- الأماكن
- PlaceInfo
- LocationKey
- AdWordsLocationExtensions
- OpenInfo
- OpenForBusiness
- LocationState (حالة الموقع الجغرافي)
- السمة
- RepeatedEnumAttributeValue
- UrlAttributeValue
- البيانات الوصفية
- نسخة طبق الأصل
- الوصول
- PriceList
- التصنيف
- القسم
- SectionType
- السلعة
- مبلغ مالي
- الملف الشخصي
- RelationshipData
- MoreHours
- الطُرق
المرجع: الموقع الجغرافي
موقع جغرافي. يمكنك الاطّلاع على مقالة مركز المساعدة للحصول على وصف تفصيلي لهذه الحقول، أو على نقطة نهاية الفئة للحصول على قائمة بفئات الأنشطة التجارية الصالحة.
تمثيل JSON | |
---|---|
{ "name": string, "languageCode": string, "storeCode": string, "locationName": string, "primaryPhone": string, "additionalPhones": [ string ], "address": { object ( |
الحقول | |
---|---|
name |
معرّف Google لهذا الموقع الجغرافي بالصيغة: في سياق التطابقات، لن تتم تعبئة هذا الحقل. |
languageCode |
لغة الموقع الجغرافي. يتم ضبطه أثناء عملية الإنشاء وغير قابل للتعديل. |
storeCode |
هو معرّف خارجي لهذا الموقع الجغرافي، ويجب أن يكون فريدًا داخل حساب معيّن. وتُعد هذه وسيلة لإقران الموقع بسجلاتك الخاصة. |
locationName |
يجب أن يعكس اسم الموقع الجغرافي اسم نشاطك التجاري في العالم الفعلي، كما يجري استخدامه دائمًا على واجهة متجرك وموقعك الإلكتروني وأدواتك المكتبية، وكما هو معروف بين العملاء. يمكن تضمين أي معلومات إضافية، عند الاقتضاء، في حقول أخرى من المورد (على سبيل المثال، |
primaryPhone |
رقم هاتف يتصل بموقع نشاطك التجاري الفردي بشكل مباشر قدر الإمكان استخدِم رقم هاتف محليًا بدلاً من استخدام رقم خط مساعدة مركزي بمركز خدمة، متى أمكن ذلك. |
additionalPhones[] |
ما يصل إلى رقمين للهاتف (جوّال أو خط أرضي، بدون فاكس) يمكن الاتصال من خلالهما بنشاطك التجاري، بالإضافة إلى رقم هاتفك الأساسي. |
address |
عنوان دقيق ودقيق لوصف الموقع الجغرافي لنشاطك التجاري ولا يتم قبول صناديق البريد الواقعة في مواقع جغرافية نائية. في الوقت الحالي، يمكنك تحديد خمس قيم |
primaryCategory |
الفئة التي تصف على أفضل نحو النشاط التجاري الأساسي الذي يتفاعل فيه هذا الموقع الجغرافي |
additionalCategories[] |
فئات إضافية لوصف نشاطك التجاري. تساعد الفئات عملاءك في العثور على نتائج دقيقة ومحددة للخدمات التي يهتمون بها. للحفاظ على دقة معلومات نشاطك التجاري وظهورها، احرص على استخدام أقل عدد ممكن من الفئات لوصف نشاطك التجاري الأساسي بصورة شاملة. اختيار فئات محدّدة قدر الإمكان، على أنّها تمثّل نشاطك التجاري الرئيسي |
websiteUrl |
عنوان URL لهذا النشاط التجاري. استخدِم عنوان URL يمثّل الموقع الجغرافي الفردي للنشاط التجاري، إن أمكن، بدلاً من موقع إلكتروني/عنوان URL عام يمثّل جميع المواقع الجغرافية أو العلامة التجارية. |
regularHours |
ساعات العمل للنشاط التجاري. |
specialHours |
ساعات العمل الخاصة للنشاط التجاري. يشمل ذلك عادةً ساعات العمل خلال العطلات وأوقات أخرى خارج ساعات العمل العادية. وتلغي هذه المعايير ساعات العمل العادية. |
serviceArea |
تقدِّم الأنشطة التجارية في منطقة نطاق الخدمة خدمتها في الموقع الجغرافي للعميل. إذا كان هذا النشاط التجاري معنيًا بمنطقة نطاق خدمة، يصف هذا الحقل المناطق التي يقدم فيها النشاط التجاري. |
locationKey |
مجموعة من المفاتيح التي تربط هذا النشاط التجاري بخدمات Google الأخرى، مثل صفحة +Google وأماكن خرائط Google. |
labels[] |
مجموعة من السلاسل الحرة التي تسمح لك بالإشارة إلى نشاطك التجاري. هذه التصنيفات ليست موجّهة للمستخدمين، لذا لا يمكن لأحد سواك الاطّلاع عليها. يقتصر على 255 حرفًا (لكل تصنيف). |
adWordsLocationExtensions |
المعلومات الإضافية التي تظهر في AdWords. |
latlng |
خط العرض وخط الطول من تقديم المستخدم. عند إنشاء موقع، يتم تجاهل هذا الحقل في حال نجاح الترميزات الجغرافية للعنوان المقدم. لا يتم عرض هذا الحقل في طلبات الاستلام إلا في حال قبول قيمة " |
openInfo |
علامة تشير إلى ما إذا كان الموقع الجغرافي مفتوحًا حاليًا للنشاط التجاري أم لا. |
locationState |
النتائج فقط. مجموعة من القيم المنطقية التي تعكس حالة موقع جغرافي |
attributes[] |
سمات هذا الموقع الجغرافي |
metadata |
النتائج فقط. معلومات إضافية غير قابلة للتعديل من قِبل المستخدم. |
priceLists[] |
عنصر متوقّف نهائيًا: معلومات قائمة الأسعار لهذا الموقع الجغرافي. |
profile |
يصف نشاطك التجاري بصوتك الخاص ويشارك مع المستخدمين القصة الفريدة لنشاطك التجاري وعروضك. |
relationshipData |
جميع المواقع الجغرافية والسلسلة ذات الصلة بهذا الموقع. |
moreHours[] |
ساعات إضافية للأقسام المختلفة أو العملاء المحدّدين في أحد الأنشطة التجارية. |
BusinessHours
يمثل الفترات الزمنية التي يكون هذا الموقع الجغرافي مفتوحًا فيها للنشاط التجاري. يحتوي على مجموعة من TimePeriod
مثيل.
تمثيل JSON | |
---|---|
{
"periods": [
{
object ( |
الحقول | |
---|---|
periods[] |
مجموعة من المرّات التي يكون فيها هذا الموقع مفتوحًا للعمل. وتمثّل كل فترة نطاقًا من الساعات يكون فيه الموقع الجغرافي مفتوحًا خلال الأسبوع. |
TimePeriod
يمثل فترة زمنية يكون النشاط التجاري مفتوحًا فيها، بدءًا من اليوم أو وقت العمل المحدّدين وينتهي في يوم/وقت الإغلاق المحدّدين. ويجب أن يقع وقت الإغلاق بعد وقت الفتح، على سبيل المثال في وقت لاحق من اليوم نفسه، أو في يوم لاحق.
تمثيل JSON | |
---|---|
{ "openDay": enum ( |
الحقول | |
---|---|
openDay |
يشير إلى |
openTime |
الوقت بتنسيق 24 ساعة ISO 8601 الموسع (hh:mm). القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. |
closeDay |
يشير إلى |
closeTime |
الوقت بتنسيق 24 ساعة ISO 8601 الموسع (hh:mm). القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. |
DayOfWeek
يمثل أحد أيام الأسبوع.
عمليات التعداد | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
لَمْ يَتِمّْ تَحْدِيدُ الْيَوْمْ مِنَ الْأُسْبُوعْ. |
MONDAY |
الإثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
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 |
وقت الجدار في |
endDate |
تمثّل هذه السمة تاريخ التقويم الذي تنتهي به هذه الفترة الخاصة بالساعة. إذا لم يتم ضبط الحقل |
closeTime |
وقت الجدار في |
isClosed |
إذا كانت القيمة true، يتم تجاهل |
ServiceAreaBusiness
تقدِّم الأنشطة التجارية في منطقة نطاق الخدمة خدماتها في الموقع الجغرافي للعميل (على سبيل المثال، صانع أقفال أو سبّاك).
تمثيل JSON | |
---|---|
{ "businessType": enum ( |
الحقول | ||
---|---|---|
businessType |
تشير إلى |
|
حقل الاتحاد coverageArea تشير هذه السمة إلى منطقة التغطية التي يقدّم فيها النشاط التجاري الخدمة. يمكن أن تكون السمة "coverageArea " واحدة فقط مما يلي: |
||
radius |
النتائج فقط. المنطقة التي يخدمها هذا النشاط التجاري تتمحور حول نقطة معيّنة. |
|
places |
يتم تحديد المنطقة التي يخدمها هذا النشاط التجاري من خلال مجموعة من الأماكن. |
BusinessType
يشير إلى ما إذا كان هذا النشاط التجاري لا يقدّم سوى الخدمات في الموقع الجغرافي للعميل (على سبيل المثال، شاحنة سحب)، أو في كل من عنوان وفي الموقع (على سبيل المثال، متجر بيتزا يوفر منطقة لتناول الطعام يوفّر خدمة توصيل الطلبات إلى العملاء أيضًا).
عمليات التعداد | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
النتائج فقط. غير محدَّد. |
CUSTOMER_LOCATION_ONLY |
يقدم الخدمة في المنطقة المحيطة فقط (وليس في عنوان النشاط التجاري). |
CUSTOMER_AND_BUSINESS_LOCATION |
ويقدّم الخدمة في عنوان النشاط التجاري والمنطقة المحيطة. |
PointRadius
نصف قطر حول نقطة معينة (خط العرض/خط الطول).
تمثيل JSON | |
---|---|
{
"latlng": {
object ( |
الحقول | |
---|---|
latlng |
خط العرض/خط الطول الذي يحدد مركز منطقة محددة بواسطة نصف القطر. |
radiusKm |
المسافة بالكيلومترات في المنطقة حول النقطة. |
LatLng
تمثّل هذه السمة كائنًا يمثّل زوجًا من خطوط الطول/العرض. يتم التعبير عن ذلك كزوج من الازدواج لتمثيل درجات خطوط الطول والعرض. يجب أن يتوافق هذا الكائن مع معيار WGS84 ما لم يتم تحديد خلاف ذلك. يجب أن تكون القيم ضمن نطاقات تمت تسويتها.
تمثيل JSON | |
---|---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
تمثّل هذه السمة خط العرض بالدرجات. يجب أن يكون ضِمن نطاق [ -90.0 أو +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون ضمن النطاق [-180.0، +180.0]. |
الأماكن
تحدّد اتحاد المناطق التي تمثلها مجموعة من الأماكن.
تمثيل JSON | |
---|---|
{
"placeInfos": [
{
object ( |
الحقول | |
---|---|
placeInfos[] |
المناطق التي تمثلها أرقام تعريف الأماكن. الحد الأقصى هو 20 مكانًا. |
PlaceInfo
لتحديد منطقة يتم تمثيلها برقم تعريف مكان.
تمثيل JSON | |
---|---|
{ "name": string, "placeId": string } |
الحقول | |
---|---|
name |
الاسم المترجَم للمكان. مثلاً: |
placeId |
رقم تعريف المكان. يجب أن يتطابق مع المنطقة. |
LocationKey
المراجع الرئيسية البديلة/البديلة للموقع.
تمثيل JSON | |
---|---|
{ "plusPageId": string, "placeId": string, "explicitNoPlaceId": boolean, "requestId": string } |
الحقول | |
---|---|
plusPageId |
النتائج فقط. إذا كان هذا الموقع مرتبطًا بصفحة على Google+ ، فستتم تعبئتها برقم تعريف صفحة Google+ لهذا الموقع. |
placeId |
إذا تم إثبات ملكية هذا الموقع الجغرافي ويرتبط بـ/يظهر على "خرائط Google"، ستتم تعبئة هذا الحقل بمعرّف المكان للموقع الجغرافي. ويمكن استخدام هذا المعرّف في العديد من واجهات برمجة تطبيقات الأماكن. إذا لم يتم إثبات ملكية هذا الموقع الجغرافي، قد تتم تعبئة هذا الحقل إذا كان الموقع الجغرافي مرتبطًا بمكان يظهر على "خرائط Google". يمكن ضبط هذا الحقل أثناء "إنشاء المكالمات"، ولكن لا يمكن ضبطه أثناء "التحديث". وتحدّد القيمة المنطقية الإضافية لـ |
explicitNoPlaceId |
النتائج فقط. تشير قيمة true إلى أنّ رقم تعريف المكان الذي لم يتم ضبطه متعمّد، وهو ما يختلف عن عدم إجراء أي ربط بعد. |
requestId |
النتائج فقط. |
AdWordsLocationExtensions
المعلومات الإضافية التي تظهر في AdWords.
تمثيل JSON | |
---|---|
{ "adPhone": string } |
الحقول | |
---|---|
adPhone |
رقم هاتف بديل للعرض في إضافات المواقع الجغرافية في AdWords بدلاً من رقم الهاتف الأساسي للموقع الجغرافي. |
OpenInfo
معلومات تتعلّق بحالة افتتاح النشاط التجاري.
تمثيل JSON | |
---|---|
{ "status": enum ( |
الحقول | |
---|---|
status |
يشير إلى ما إذا كان الموقع الجغرافي مفتوحًا حاليًا للنشاط التجاري أم لا. تكون جميع المواقع الجغرافية مفتوحة بشكل تلقائي، ما لم يتم تعديلها لتصبح مغلقة. |
canReopen |
النتائج فقط. يشير هذا الحقل إلى ما إذا كان هذا النشاط التجاري مؤهَّلاً لإعادة فتحه. |
openingDate |
التاريخ الذي تم فيه فتح الموقع الجغرافي لأول مرة. إذا لم يكن اليوم المحدد معروفًا، يمكن تحديد الشهر والسنة فقط. يجب أن يكون التاريخ في الماضي أو ألا يزيد عن عام واحد في المستقبل. |
OpenForBusiness
يشير إلى حالة الموقع.
عمليات التعداد | |
---|---|
OPEN_FOR_BUSINESS_UNSPECIFIED |
غير محدَّد. |
OPEN |
تشير إلى أن الموقع مفتوح. |
CLOSED_PERMANENTLY |
يشير إلى أن الموقع تم إغلاقه نهائيًا. |
CLOSED_TEMPORARILY |
يشير إلى أن الموقع الجغرافي تم إغلاقه مؤقتًا. يمكن تطبيق هذه القيمة فقط على المواقع الجغرافية المنشورة (أي locationState.is_Publish = true). عند تعديل حقل الحالة إلى هذه القيمة، على العملاء ضبط updateMask صراحةً على openInfo.status . لا يمكن ضبط أقنعة تحديث أخرى أثناء مكالمة التحديث هذه. إنّ هذا الحظر مؤقّت وسيتم تخفيفه قريبًا. |
LocationState
يحتوي على مجموعة من القيم المنطقية التي تعكس حالة أحد المواقع الجغرافية.
تمثيل JSON | |
---|---|
{ "isGoogleUpdated": boolean, "isDuplicate": boolean, "isSuspended": boolean, "canUpdate": boolean, "canDelete": boolean, "isVerified": boolean, "needsReverification": boolean, "isPendingReview": boolean, "isDisabled": boolean, "isPublished": boolean, "isDisconnected": boolean, "isLocalPostApiDisabled": boolean, "canModifyServiceList": boolean, "canHaveFoodMenus": boolean, "hasPendingEdits": boolean, "hasPendingVerification": boolean, "canOperateHealthData": boolean, "canOperateLodgingData": boolean } |
الحقول | |
---|---|
isGoogleUpdated |
النتائج فقط. يشير هذا الحقل إلى ما إذا كان معرّف المكان المرتبط بهذا الموقع الجغرافي يتضمّن تعديلات أم لا. |
isDuplicate |
النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي مكرّرًا لموقع جغرافي آخر. |
isSuspended |
النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي معلّقًا أم لا. لا تظهر المواقع الجغرافية المعلّقة للمستخدمين النهائيين في منتجات Google. في حال اعتقادك أنّ هذا القرار ناتج عن خطأ، يُرجى الاطّلاع على مقالة مركز المساعدة. |
canUpdate |
النتائج فقط. تشير إلى ما إذا كان يمكن تحديث الموقع أم لا. |
canDelete |
النتائج فقط. يشير إلى ما إذا كان من الممكن حذف الموقع الجغرافي باستخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google". |
isVerified |
النتائج فقط. يشير إلى ما إذا كان قد تم إثبات ملكية الموقع الجغرافي أم لا. |
needsReverification |
النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي يتطلب إعادة إثبات ملكيته. |
isPendingReview |
النتائج فقط. يشير إلى ما إذا كانت مراجعة الموقع الجغرافي في انتظار المراجعة أم لا. |
isDisabled |
النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي معطلًا أم لا. |
isPublished |
النتائج فقط. تشير هذه العلامة إلى ما إذا كان قد تم نشر الموقع الجغرافي أم لا. |
isDisconnected |
النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي غير مرتبط بمكان على "خرائط Google". |
isLocalPostApiDisabled |
النتائج فقط. يشير إلى ما إذا كان قد تم إيقاف accounts.locations.localPosts لهذا الموقع أم لا. |
canModifyServiceList |
النتائج فقط. يشير إلى ما إذا كان يمكن لبطاقة البيانات تعديل قائمة خدمات أم لا. |
canHaveFoodMenus |
النتائج فقط. يشير إلى ما إذا كانت البيانات مؤهلة لقائمة الطعام. |
hasPendingEdits |
النتائج فقط. يشير إلى ما إذا كان أي من خصائص هذا الموقع في حالة انتظار التعديل. |
hasPendingVerification |
النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي يحتوي على طلبات إثبات ملكية في انتظار المراجعة. |
canOperateHealthData |
النتائج فقط. تشير هذه السمة إلى ما إذا كان يمكن تشغيل الموقع الجغرافي على البيانات الصحية أم لا. |
canOperateLodgingData |
النتائج فقط. تشير هذه السمة إلى ما إذا كان يمكن استخدام بيانات الإقامة في الموقع الجغرافي. |
السمة
سمة الموقع الجغرافي. تقدم السمات معلومات إضافية حول الموقع. وقد تختلف السمات التي يمكن ضبطها على موقع جغرافي معيّن استنادًا إلى خصائص ذلك الموقع الجغرافي (مثل الفئة). تحدِّد Google السمات المتاحة، ويمكن إضافتها وإزالتها بدون إجراء تغييرات على واجهة برمجة التطبيقات.
تمثيل JSON | |
---|---|
{ "attributeId": string, "valueType": enum ( |
الحقول | |
---|---|
attributeId |
رقم تعريف السمة. تقدِّم Google أرقام تعريف السمات. |
valueType |
النتائج فقط. تمثّل هذه السمة نوع القيمة التي تحتوي عليها هذه السمة. ويجب استخدامها لتحديد كيفية تفسير القيمة. |
values[] |
قيم هذه السمة. يجب أن يتطابق نوع القيم المقدَّمة مع القيمة المتوقّعة لهذه السمة. يُرجى الاطّلاع على AttributeValueType. هذا حقل متكرّر حيث يمكن تقديم قيم سمات متعددة. تسمح أنواع السمات باستخدام قيمة واحدة فقط. |
repeatedEnumValue |
عندما يكون نوع قيمة السمة REPEATED_ENUM، سيحتوي هذا الحقل على قيمة السمة، ويجب أن تكون حقول القيم الأخرى فارغة. |
urlValues[] |
عندما يكون نوع قيمة السمة هو عنوان URL، يحتوي هذا الحقل على قيم هذه السمة، ويجب أن تكون حقول القيم الأخرى فارغة. |
RepeatedEnumAttributeValue
قيم سمة ذات valueType
بقيمة REPEATED_ENUM ويتألف ذلك من قائمتين من أرقام تعريف القيم: تلك التي تم ضبطها (صحيح) وتلك التي لم يتم ضبطها (خطأ). تعتبر القيم المفقودة غير معروفة. يجب تحديد قيمة واحدة على الأقل.
تمثيل JSON | |
---|---|
{ "setValues": [ string ], "unsetValues": [ string ] } |
الحقول | |
---|---|
setValues[] |
قيم التعداد التي تم تعيينها. |
unsetValues[] |
قيم قيم التعداد التي لم يتم ضبطها |
UrlAttributeValue
قيم سمة تتضمّن valueType
لعنوان URL
تمثيل JSON | |
---|---|
{ "url": string } |
الحقول | |
---|---|
url |
عنوان URL. |
البيانات الوصفية
معلومات إضافية عن الموقع غير قابلة للتعديل من قِبل المستخدم.
تمثيل JSON | |
---|---|
{
"duplicate": {
object ( |
الحقول | |
---|---|
duplicate |
معلومات عن الموقع الذي يكرّره هذا الموقع. لا يتم عرضه إلا عندما تكون قيمة |
mapsUrl |
رابط يؤدي إلى الموقع الجغرافي على "خرائط Google". |
newReviewUrl |
رابط يؤدي إلى صفحة على "بحث Google" يمكن للعميل من خلالها إضافة مراجعة للموقع الجغرافي. |
تكرار
معلومات عن الموقع الذي يكرّره هذا الموقع.
تمثيل JSON | |
---|---|
{
"locationName": string,
"placeId": string,
"access": enum ( |
الحقول | |
---|---|
locationName |
اسم المورد للموقع الذي يكرّره هذا. تتم تعبئة هذا الحقل فقط إذا كان المستخدم الذي تمت مصادقته لديه أذونات الوصول إلى هذا الموقع الجغرافي ولم يتم حذف هذا الموقع الجغرافي. |
placeId |
معرّف المكان للموقع الجغرافي الذي يكرّره هذا العنصر. |
access |
تشير هذه السمة إلى ما إذا كان بإمكان المستخدم الوصول إلى الموقع الجغرافي الذي يتم تكراره. |
إذن الوصول
مستوى وصول المستخدِم إلى الموقع الجغرافي الذي تكرّره. يحل هذا محل الملكية ويجب استخدامه بدلاً من ذلك.
عمليات التعداد | |
---|---|
ACCESS_UNSPECIFIED |
غير محدَّد. |
ACCESS_UNKNOWN |
تعذّر تحديد ما إذا كان يمكن للمستخدم الوصول إلى الموقع الجغرافي الذي يتم تكراره أم لا. |
ALLOWED |
يمكن للمستخدم الوصول إلى الموقع الذي يتم تكراره. |
INSUFFICIENT |
لا يمكن للمستخدم الوصول إلى الموقع الجغرافي الذي يتم تكراره. |
PriceList
مهملة: قائمة بمعلومات أسعار السلع يتم تنظيم قوائم الأسعار في صورة قائمة أسعار واحدة أو أكثر، وتحتوي كل منها على قسم واحد أو أكثر مع عنصر واحد أو أكثر. على سبيل المثال، قد تمثّل قوائم أسعار الأطعمة قوائم طعام للفطور/الغداء/العشاء، مع أقسام للبرغر/شرائح اللحم/المأكولات البحرية.
تمثيل JSON | |
---|---|
{ "priceListId": string, "labels": [ { object ( |
الحقول | |
---|---|
priceListId |
مطلوبة. رقم التعريف لقائمة الأسعار. لا يمكن تكرار قائمة الأسعار والقسم ومعرّفات السلع داخل هذا الموقع الجغرافي. |
labels[] |
مطلوبة. التصنيفات التي تحمل علامات حسب اللغة لقائمة الأسعار. |
sourceUrl |
عنوان URL اختياري للمصدر المصدر الذي تمّ استرداد قائمة الأسعار منه على سبيل المثال، قد يكون هذا هو عنوان URL للصفحة التي تم استخراجها تلقائيًا لتعبئة معلومات القائمة. |
sections[] |
مطلوبة. أقسام قائمة الأسعار هذه. يجب أن تحتوي كل قائمة أسعار على قسم واحد على الأقل. |
التصنيف
تصنيف يُستخدم عند عرض قائمة الأسعار أو القسم أو السلعة.
تمثيل JSON | |
---|---|
{ "displayName": string, "description": string, "languageCode": string } |
الحقول | |
---|---|
displayName |
مطلوبة. الاسم المعروض لقائمة الأسعار أو القسم أو السلعة. |
description |
اختياريّ. وصف قائمة الأسعار أو القسم أو السلعة. |
languageCode |
اختياريّ. رمز اللغة BCP-47 الذي تنطبق عليه هذه السلاسل. يمكن ضبط مجموعة واحدة فقط من التصنيفات لكل لغة. |
القسم
قسم من قائمة الأسعار يحتوي على عنصر واحد أو أكثر.
تمثيل JSON | |
---|---|
{ "sectionId": string, "labels": [ { object ( |
الحقول | |
---|---|
sectionId |
مطلوبة. رقم التعريف للقسم. لا يمكن تكرار قائمة الأسعار والقسم ومعرّفات السلع داخل هذا الموقع الجغرافي. |
labels[] |
مطلوبة. التصنيفات التي تحمل علامات لغة للقسم ننصح بأن يكون طول أسماء الأقسام وأوصافها 140 حرفًا أو أقل. مطلوب مجموعة واحدة على الأقل من التصنيفات. |
sectionType |
اختياريّ. نوع قسم قائمة الأسعار الحالية القيمة التلقائية هي "طعام". |
items[] |
السلع التي يتضمّنها هذا القسم من قائمة الأسعار |
SectionType
نوع القسم
عمليات التعداد | |
---|---|
SECTION_TYPE_UNSPECIFIED |
غير محدَّد. |
FOOD |
يحتوي القسم على عناصر تمثّل الطعام. |
SERVICES |
يحتوي القسم على العناصر التي تمثل الخدمات. |
المنتج/الخدمة
تمثّل هذه السمة عنصر قائمة واحدًا. يجب أن يكون لكل شكل من أشكال السلعة في قائمة الأسعار سلعة خاصة به مع بيانات أسعارها الخاصة.
تمثيل JSON | |
---|---|
{ "itemId": string, "labels": [ { object ( |
الحقول | |
---|---|
itemId |
مطلوبة. معرّف السلعة. لا يمكن تكرار قائمة الأسعار والقسم ومعرّفات السلع داخل هذا الموقع الجغرافي. |
labels[] |
مطلوبة. التصنيفات التي تحمل علامات لغة للعنصر. ننصح بأن يكون طول أسماء العناصر 140 حرفًا أو أقل، وألا يزيد طول الأوصاف عن 250 حرفًا. مطلوب مجموعة واحدة على الأقل من التصنيفات. |
price |
اختياريّ. سعر السلعة. |
مبالغ مالية
تمثّل هذه السمة مبلغًا من المال مع نوع العملة الخاص به.
تمثيل JSON | |
---|---|
{ "currencyCode": string, "units": string, "nanos": integer } |
الحقول | |
---|---|
currencyCode |
تمثّل هذه السمة رمز العملة المكوَّن من ثلاثة أحرف والمحدد في ISO 4217. |
units |
الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة السمة |
nanos |
عدد وحدات النانو (10^-9) من الكمية يجب أن تتراوح القيمة بين -999,999,999 و+999,999,999 ضمنًا. إذا كانت قيمة |
المستقبلي
جميع المعلومات المتعلقة بالملف الشخصي للموقع.
تمثيل JSON | |
---|---|
{ "description": string } |
الحقول | |
---|---|
description |
وصف الموقع الجغرافي بصوتك الخاص، ولا يمكن لأي مستخدم آخر تعديله |
RelationshipData
معلومات عن جميع المواقع الجغرافية للوالدَين والأطفال المرتبطة بهذا الموقع
تمثيل JSON | |
---|---|
{ "parentChain": string } |
الحقول | |
---|---|
parentChain |
اسم مورد السلسلة التي ينتمي إليها هذا الموقع. |
MoreHours
الفترات الزمنية التي يكون فيها الموقع مفتوحًا لأنواع معينة من الأنشطة التجارية.
تمثيل JSON | |
---|---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
الحقول | |
---|---|
hoursTypeId |
مطلوبة. نوع ساعات العمل. وينبغي للعملاء الاتصال بـ {#link businessCategories:BatchGet} للحصول على أنواع ساعات العمل المتاحة لفئات المواقع الجغرافية. |
periods[] |
مطلوبة. مجموعة الأوقات التي يكون فيها هذا الموقع مفتوحًا وتمثّل كل فترة نطاقًا من الساعات يكون فيه الموقع الجغرافي مفتوحًا خلال الأسبوع. |
الطُرق |
|
---|---|
|
لربط موقع جغرافي بمعرّف مكان. |
|
الحصول على جميع المواقع الجغرافية المحدّدة في الحساب المعيّن |
|
تعرض قائمة المراجعات المقسّمة على صفحات لجميع المواقع الجغرافية المحدّدة. |
|
يؤدي إلى محو ارتباط بين موقع جغرافي ومعرّف المكان المرتبط به. |
|
تنشئ location جديدة يملكها الحساب المحدّد، وتعرضها. |
|
حذف موقع جغرافي |
|
تعمل هذه السياسة على الإبلاغ عن جميع خيارات إثبات الملكية المؤهّلة لموقع جغرافي معيّن بلغة معيّنة. |
|
يعثر على جميع المواقع الجغرافية المحتملة التي تتطابق مع الموقع الجغرافي المحدّد. |
|
الحصول على الموقع الجغرافي المحدّد |
|
تعرض قوائم الطعام في موقع جغرافي معيّن. |
|
يمكن الحصول على الإصدار المحدَّث من Google للموقع الجغرافي المحدد. |
|
لعرض سمات مقدّم خدمات الرعاية الصحية لموقع جغرافي محدّد. |
|
احصل على قائمة الخدمات المحدّدة لموقع جغرافي. |
|
يسرد المواقع الجغرافية للحساب المحدّد. |
|
لتعديل الموقع الجغرافي المحدَّد |
|
تعرض تقريرًا يحتوي على إحصاءات حول مقياس واحد أو أكثر حسب الموقع الجغرافي. |
(deprecated) |
ينقل موقعًا جغرافيًا من حساب يملكه المستخدم إلى حساب آخر يشرف عليه المستخدم نفسه. |
|
لتعديل قوائم الطعام في موقع جغرافي محدّد |
|
لتعديل سمات "مقدّمي خدمات الرعاية الصحية" لموقع جغرافي محدّد |
|
لتحديث قائمة الخدمات المحدّدة لأحد المواقع الجغرافية. |
|
بدء عملية إثبات ملكية موقع جغرافي |