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 الموسّع. (hh:mm) القيم الصالحة هي 00:00-24:00، حيث تمثل 24:00 منتصف الليل في نهاية حقل اليوم المحدد. يجب تحديدها إذا كانت قيمة isClosed خطأ.
endDate

object (Date)

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

string

وقت الجدار في endDate عند إغلاق أحد المواقع الجغرافية، ويتم التعبير عنه بتنسيق ISO 8601 الموسّع. (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_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

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

النتائج فقط. يشير إلى ما إذا كان يمكن لبطاقة البيانات تعديل قائمة خدمات أم لا.
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 true. مهملة: لم نعد نتيح استخدام معلومات تفصيلية عن التكرارات.
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)

اختياريّ. نوع قسم قائمة الأسعار الحالية القيمة التلقائية هي "طعام".
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 businessCategories: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

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