REST Resource: accounts.locations

المرجع: الموقع الجغرافي

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

تمثيل JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
الحقول
name

string

معرّف Google لهذا الموقع الجغرافي بالصيغة: accounts/{accountId}/locations/{locationId}

في سياق المطابقات، لن تتم تعبئة هذا الحقل.
languageCode

string

لغة الموقع الجغرافي. يتم ضبط القيمة أثناء الإنشاء ولا يمكن تعديلها.
storeCode

string

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

string

يجب أن يعكس اسم الموقع الجغرافي الاسم الفعلي لنشاطك التجاري، كما هو معروف لدى العملاء على واجهة متجرك وموقعك الإلكتروني وأدواتك المكتبية. يمكن تضمين أي معلومات إضافية، عند الاقتضاء، في حقول أخرى من المورد (على سبيل المثال، Address وCategories). لا تضِف معلومات غير ضرورية إلى اسمك (مثلاً، يمكنك استخدام "Google" بدلاً من "Google Inc. - مقر شركة ماونتن فيو"). لا تُدرِج الجُمل الترويجية التسويقية أو رموز المتاجر أو الرموز الخاصة أو ساعات العمل أو حالة الإغلاق/الفتح أو أرقام الهواتف أو عناوين URL للمواقع الإلكترونية أو معلومات الخدمة/المنتجات أو الموقع الجغرافي/العنوان أو الاتجاهات أو معلومات الاحتواء (مثل "ماكينة الصراف الآلي للبنك الأهلي في دبي").
primaryPhone

string

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

string

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

object (PostalAddress)

عنوان دقيق ودقيق لوصف الموقع الجغرافي لنشاطك التجاري ولا يتم قبول صناديق البريد الواقعة في مواقع جغرافية نائية. في الوقت الحالي، يمكنك تحديد خمس قيم كحد أقصى للحقل "addressLines" في العنوان.
primaryCategory

object (Category)

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

object (Category)

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

string

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

object (BusinessHours)

ساعات العمل للنشاط التجاري.
specialHours

object (SpecialHours)

ساعات العمل الخاصة للنشاط التجاري. ويشمل ذلك عادةً ساعات العمل خلال العطلات وأوقات أخرى خارج ساعات العمل العادية. ويلغي ذلك ساعات العمل العادية.
serviceArea

object (ServiceAreaBusiness)

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

object (LocationKey)

مجموعة من المفاتيح التي تربط هذا النشاط التجاري بخدمات أخرى من Google، مثل صفحة على +Google وأماكن على "خرائط Google"
labels[]

string

هي مجموعة من السلاسل الحرة التي تتيح لك الإشارة إلى نشاطك التجاري. هذه التصنيفات لا تكون موجّهة للمستخدمين، لا يمكن لأحد سواك رؤيتها. يقتصر على 255 حرفًا (لكل تصنيف).
adWordsLocationExtensions

object (AdWordsLocationExtensions)

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

object (LatLng)

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

object (OpenInfo)

علامة تشير إلى ما إذا كان الموقع الجغرافي مفتوحًا حاليًا للنشاط التجاري.
locationState

object (LocationState)

النتائج فقط. مجموعة من القيم المنطقية التي تعكس حالة موقع جغرافي
attributes[]

object (Attribute)

سمات هذا الموقع.
metadata

object (Metadata)

النتائج فقط. معلومات إضافية غير قابلة للتعديل من قِبل المستخدم
priceLists[]
(deprecated)

object (PriceList)

متوقّفة نهائيًا: معلومات قائمة الأسعار لهذا الموقع الجغرافي
profile

object (Profile)

تصف نشاطك التجاري بأسلوبك الخاص ويشارك مع المستخدمين القصة الفريدة لنشاطك التجاري وعروضك.
relationshipData

object (RelationshipData)

جميع المواقع والسلسلة ذات الصلة بهذا الموقع.
moreHours[]

object (MoreHours)

ساعات عمل إضافية للأقسام المختلفة في النشاط التجاري أو لعملاء محددين.

BusinessHours

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

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

object (TimePeriod)

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

TimePeriod

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

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

enum (DayOfWeek)

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

string

الوقت بتنسيق 24 ساعة وفقًا لمعيار ISO 8601 الموسّع (hh:mm). القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد.
closeDay

enum (DayOfWeek)

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

string

الوقت بتنسيق 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 (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": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
الحقول
startDate

object (Date)

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

string

وقت الجدار على startDate عند فتح موقع جغرافي، ويتم التعبير عنه بتنسيق ISO 8601 الممتد لمدة 24 ساعة. (hh:mm) القيم الصالحة هي 00:00-24:00، حيث تشير 24:00 إلى منتصف الليل في نهاية حقل اليوم المحدّد. يجب تحديدها إذا كانت السمة isClosed خاطئة.
endDate

object (Date)

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

string

تمثّل هذه السمة مدّة الحائط في endDate عند إغلاق موقع جغرافي، ويتم التعبير عنه بتنسيق ISO 8601 الممتد لمدة 24 ساعة. (hh:mm) القيم الصالحة هي 00:00-24:00، حيث تشير 24:00 إلى منتصف الليل في نهاية حقل اليوم المحدّد. يجب تحديدها إذا كانت السمة isClosed خاطئة.
isClosed

boolean

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

ServiceAreaBusiness

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

تمثيل JSON 
{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
الحقول
businessType

enum (BusinessType)

تشير هذه السمة إلى type للنشاط التجاري ضمن منطقة نطاق الخدمة.
حقل الاتحاد coverageArea. تشير إلى منطقة التغطية التي يقدّم فيها النشاط التجاري الخدمة. يمكن أن يكون coverageArea واحدًا فقط مما يلي:
radius

object (PointRadius)

النتائج فقط. تتمحور المنطقة التي يخدمها هذا النشاط التجاري حول نقطة ما.
places

object (Places)

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

BusinessType

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

عمليات التعداد
BUSINESS_TYPE_UNSPECIFIED النتائج فقط. لم يتم تحديده.
CUSTOMER_LOCATION_ONLY تقدّم الخدمة في المنطقة المحيطة فقط (وليس في عنوان النشاط التجاري).
CUSTOMER_AND_BUSINESS_LOCATION تتوفّر الخدمة في عنوان النشاط التجاري والمنطقة المحيطة.

PointRadius

نصف قطر حول نقطة معينة (خط العرض/خط الطول).

تمثيل JSON 
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
الحقول
latlng

object (LatLng)

خط العرض/خط الطول الذي يحدد مركز المنطقة الذي يحدده نصف القطر.
radiusKm

number

المسافة بالكيلومترات في المنطقة المحيطة بالنقطة.

LatLng

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

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

number

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

number

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

الأماكن

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

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

object (PlaceInfo)

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

PlaceInfo

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

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

string

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

string

رقم تعريف المكان. يجب أن يكون النص متوافقًا مع منطقة.

LocationKey

الإشارات الرئيسية البديلة/البديلة لأحد المواقع:

تمثيل JSON 
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
الحقول
plusPageId

string

النتائج فقط. إذا كانت صفحة Google+ مرتبطة بهذا الموقع الجغرافي، ستتم تعبئته بمعرّف صفحة Google+ الخاص بهذا الموقع.
placeId

string

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

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

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

وتؤهّل قيمة منطقية explicitNoPlaceId الإضافية ما إذا كان رقم تعريف المكان الذي لم يتم تحديده متعمّدًا أم لا.
explicitNoPlaceId

boolean

النتائج فقط. تشير القيمة true إلى أنّ رقم تعريف المكان الذي لم يتم ضبطه متعمّد، وهي قيمة مختلفة عن عدم إجراء أيّ عملية ربط بعد.
requestId

string

النتائج فقط. رقم requestId المُستخدَم لإنشاء هذا الموقع الجغرافي قد تكون فارغة إذا تم إنشاء هذا الموقع الجغرافي خارج واجهة برمجة تطبيقات "نشاطي التجاري على Google" أو المواقع الجغرافية للملف التجاري.

AdWordsLocationExtensions

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

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

string

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

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 يشير إلى أن الموقع الجغرافي قد تم إغلاقه مؤقتًا. يمكن تطبيق هذه القيمة على المواقع الجغرافية المنشورة فقط (مثل locationState.is_publication = 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

boolean

النتائج فقط. تشير إلى ما إذا كان رقم تعريف المكان المرتبط بهذا الموقع الجغرافي يتضمّن تعديلات.
isDuplicate

boolean

النتائج فقط. يشير إلى ما إذا كان الموقع نسخة طبق الأصل من موقع آخر.
isSuspended

boolean

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

boolean

النتائج فقط. تشير إلى ما إذا كان يمكن تعديل الموقع الجغرافي.
canDelete

boolean

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

boolean

النتائج فقط. تشير إلى ما إذا كان قد تم التحقق من الموقع.
needsReverification

boolean

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

boolean

النتائج فقط. تشير إلى ما إذا كانت مراجعة الموقع الجغرافي في انتظار المراجعة.
isDisabled

boolean

النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي غير مفعّل.
isPublished

boolean

النتائج فقط. تشير إلى ما إذا كان الموقع الجغرافي قد تم نشره أم لا.
isDisconnected

boolean

النتائج فقط. تشير إلى ما إذا كان الموقع غير مرتبط بمكان على خرائط Google.
isLocalPostApiDisabled

boolean

النتائج فقط. يشير إلى ما إذا تم إيقاف accounts.locations.localPosts لهذا الموقع الجغرافي.
canModifyServiceList

boolean

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

boolean

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

boolean

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

boolean

النتائج فقط. يشير إلى ما إذا كان الموقع الجغرافي يحتوي على طلبات إثبات ملكية في انتظار المراجعة.
canOperateHealthData

boolean

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

boolean

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

السمة

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

تمثيل JSON 
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
الحقول
attributeId

string

رقم تعريف السمة. توفِّر Google أرقام تعريف السمات.
valueType

enum (AttributeValueType)

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

value (Value format)

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

object (RepeatedEnumAttributeValue)

عندما يكون نوع قيمة السمة هو REPEATED_ENUM، يجب أن تحتوي القيمة على قيمة السمة، ويجب أن تكون حقول القيم الأخرى فارغة.
urlValues[]

object (UrlAttributeValue)

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

RepeatedEnumAttributeValue

قيم لسمة تحتوي على valueType بقيمة REPEATED_ENUM. يتألف هذا الإجراء من قائمتين من أرقام تعريف القيم: تلك التي تم ضبطها (صحيح) وتلك التي لم يتم ضبطها (خطأ). تُعتبر القيم غير المتوفِّرة غير معروفة. يجب تحديد قيمة واحدة على الأقل.

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

string

قيم التعداد التي يتم تعيينها.
unsetValues[]

string

قيم التعداد التي لم يتم ضبطها

UrlAttributeValue

يشير إلى قيم سمة تتضمّن valueType لعنوان URL.

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

string

عنوان URL

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

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

تمثيل JSON 
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
الحقول
duplicate
(deprecated)

object (Duplicate)

معلومات حول الموقع الجغرافي الذي يتكرّر هذا الموقع الجغرافي فيه لا يُقدَّم هذا العرض إلا عندما تكون السمة locationState.is_duplicate صحيحة. مهملة: لم نعُد نوفّر معلومات تفصيلية بشأن التكرارات.
mapsUrl

string

رابط إلى الموقع الجغرافي على "خرائط Google"
newReviewUrl

string

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

تكرار

معلومات حول الموقع الجغرافي الذي يتكرّر هذا الموقع الجغرافي فيه

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

string

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

string

رقم تعريف المكان للموقع الجغرافي الذي تكراره.
access

enum (Access)

تشير إلى ما إذا كان المستخدم لديه حق الوصول إلى الموقع الذي يكرره.

إذن الوصول

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

عمليات التعداد
ACCESS_UNSPECIFIED لم يتم تحديده.
ACCESS_UNKNOWN يتعذّر تحديد ما إذا كان المستخدم يملك إذن الوصول إلى الموقع الجغرافي الذي يكرّره أم لا.
ALLOWED يمكن للمستخدم الوصول إلى الموقع الجغرافي المكرّر.
INSUFFICIENT لا يمكن للمستخدم الوصول إلى الموقع الجغرافي المكرّر.

PriceList

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

تمثيل JSON 
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
الحقول
priceListId

string

مطلوب. معرّف لقائمة الأسعار. لا يمكن تكرار قائمة الأسعار والأقسام ومعرّفات السلع داخل هذا الموقع الجغرافي.
labels[]

object (Label)

مطلوب. التصنيفات التي تحمل علامات لغوية لقائمة الأسعار
sourceUrl

string

عنوان URL اختياري للمصدر الذي تم استرداد قائمة الأسعار منه. على سبيل المثال، يمكن أن يكون هذا عنوان URL للصفحة التي تم استخراجها تلقائيًا لملء معلومات القائمة.
sections[]

object (Section)

مطلوب. أقسام قائمة الأسعار هذه يجب أن تحتوي كل قائمة أسعار على قسم واحد على الأقل.

التصنيف

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

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

string

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

string

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

string

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

القسم

قسم من قائمة الأسعار يحتوي على سلعة واحدة أو أكثر

تمثيل JSON 
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
الحقول
sectionId

string

مطلوب. تمثّل هذه السمة رقم تعريف القسم. لا يمكن تكرار قائمة الأسعار والأقسام ومعرّفات السلع داخل هذا الموقع الجغرافي.
labels[]

object (Label)

مطلوب. التصنيفات التي تم وضع علامات لغة للقسم عليها. ننصح بأن يكون طول أسماء الأقسام وأوصافها 140 حرفًا أو أقل. مطلوب مجموعة واحدة على الأقل من التصنيفات.
sectionType

enum (SectionType)

اختياريّ. نوع قسم قائمة الأسعار الحالية. القيمة التلقائية هي FOOD.
items[]

object (Item)

المنتجات المضمّنة في هذا القسم من قائمة الأسعار

SectionType

نوع القسم.

عمليات التعداد
SECTION_TYPE_UNSPECIFIED لم يتم تحديده.
FOOD يحتوي القسم على عناصر تمثّل الطعام.
SERVICES يحتوي القسم على عناصر تمثل الخدمات.

المنتج/الخدمة

عنصر قائمة واحد. يجب أن يكون لكل خيار سلعة في قائمة الأسعار سلعة خاصة بها مع بيانات أسعارها.

تمثيل JSON 
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
الحقول
itemId

string

مطلوب. معرّف السلعة لا يمكن تكرار قائمة الأسعار والأقسام ومعرّفات السلع داخل هذا الموقع الجغرافي.
labels[]

object (Label)

مطلوب. التصنيفات التي تحمل علامات لغة للعنصر. ننصح بأن تتضمن أسماء العناصر 140 حرفًا أو أقل، وأن تتضمّن الأوصاف 250 حرفًا أو أقل. مطلوب مجموعة واحدة على الأقل من التصنيفات.
price

object (Money)

اختياريّ. سعر السلعة

المال

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

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

الملف الشخصي

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

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

string

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

RelationshipData

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

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

string

اسم مورد السلسلة الذي ينتمي إليه هذا الموقع الجغرافي. How to find Chain ID

MoreHours

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

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

string

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

object (TimePeriod)

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

الطُرق

associate

 ربط موقع جغرافي برقم تعريف مكان

batchGet

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

batchGetReviews

 لعرض قائمة مراجعات مقسّمة على صفحات لجميع المواقع الجغرافية المحدّدة.

clearAssociation

 يؤدي إلى محو الارتباط بين موقع جغرافي ورقم تعريف المكان.

create

 ينشئ location جديدًا يملكه الحساب المحدّد، ويعرضه.

delete

 يؤدي هذا الإجراء إلى حذف موقع جغرافي.

fetchVerificationOptions

 تعمل هذه السياسة على إعداد تقارير عن جميع خيارات إثبات الملكية المؤهَّلة لموقع جغرافي معيّن بلغة معيّنة.

findMatches

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

get

 الحصول على الموقع المحدد.

getFoodMenus

 عرض قوائم الطعام من موقع معين.

getGoogleUpdated

 الحصول على النسخة المعدّلة من Google للموقع الجغرافي المحدّد

getHealthProviderAttributes

 تعرض سمات مقدّم الخدمات الصحية لموقع جغرافي محدّد.

getServiceList

 يمكنك الحصول على قائمة الخدمات المحدّدة لموقع جغرافي.

list

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

patch

 لتعديل الموقع الجغرافي المحدّد.

reportInsights

 تعرض تقريرًا يحتوي على إحصاءات عن مقياس واحد أو أكثر حسب الموقع الجغرافي.

transfer
(deprecated)

 نقل موقع من حساب يمتلكه المستخدم إلى حساب آخر يديره المستخدم نفسه.

updateFoodMenus

 لتعديل قوائم الطعام في موقع جغرافي معيّن

updateHealthProviderAttributes

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

updateServiceList

 لتعديل قائمة الخدمات المحدّدة لموقع.

verify

 لبدء عملية إثبات ملكية الموقع الجغرافي.