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

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

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.

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 على أنّه الموقع الجغرافي المغلق طوال اليوم.

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" بدلاً من رقم الهاتف الأساسي للموقع الجغرافي

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 في "BatchGetCategories".
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. يمكن ضبط مجموعة واحدة فقط من التصنيفات لكل لغة.

الطُرق

create

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

list

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