REST Resource: accounts.locations.localPosts

المورد: LocalPost

يمثّل هذا النوع منشورًا محليًا لموقع جغرافي.

تمثيل JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "recurringInstanceTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
الحقول
name

string

النتائج فقط. معرّف Google لهذه المشاركة المحلية بالتنسيق: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
languageCode

string

لغة المنشور المحلي
summary

string

وصف المشاركة المحلية أو نصها
callToAction

object (CallToAction)

عنوان URL الذي يتم توجيه المستخدمين إليه عند النقر على العرض الترويجي. يتم تجاهل هذا الحقل لنوع الموضوع OFFER.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء المشاركة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

النتائج فقط. وقت آخر تعديل أجراه المستخدم على المشاركة.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

في حال ضبطها، تحدّد هذه السمة وقت نشر المشاركة. يمكن للمستخدم ضبط هذا الإعداد لتحديد موعد نشر المشاركات مسبقًا.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

النتائج فقط. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة event.recurring_instance_time بدلاً منها. ستتم إزالة هذا الحقل في إصدار مستقبلي. النتائج فقط. الوقت الذي تم فيه تعديل أحدث نسخة متكررة من المشاركة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
event

object (LocalPostEvent)

معلومات الحدث مطلوب لنوعَي المواضيع EVENT وOFFER.
state

enum (LocalPostState)

النتائج فقط. حالة المشاركة، ما يشير إلى المرحلة التي تمر بها في دورة حياتها
media[]

object (MediaItem)

الوسائط المرتبطة بالمنشور، وsourceUrl هو حقل البيانات الوحيد المتوافق مع LocalPost MediaItem.
searchUrl

string

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

enum (LocalPostTopicType)

الحقل مطلوب. نوع موضوع المشاركة: عادي أو حدث أو عرض أو تنبيه
alertType

enum (AlertType)

نوع التنبيه الذي تم إنشاء المشاركة من أجله لا ينطبق هذا الحقل إلا على المشاركات من النوع topicType Alert، ويعمل كنوع فرعي من التنبيهات.
حقل الربط topic_type_specific_fields حقول محدّدة لنوع موضوع معيّن يمكن أن يكون التعليق topic_type_specific_fields إحدى القيم التالية فقط:
offer

object (LocalPostOffer)

بيانات إضافية لمشاركات العروض يجب ضبط هذا الخيار فقط عندما تكون قيمة topicType هي OFFER.

CallToAction

إجراء يتم تنفيذه عندما ينقر المستخدم على المشاركة

تمثيل JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
الحقول
actionType

enum (ActionType)

نوع الإجراء الذي سيتم تنفيذه.
url

string

عنوان URL الذي سيتم توجيه المستخدم إليه عند النقر يجب ترك هذا الحقل بدون ضبط لزر الحث على اتّخاذ إجراء الخاص بالمكالمة.

ActionType

نوع الإجراء الذي سيتم تنفيذه.

عمليات التعداد
ACTION_TYPE_UNSPECIFIED لم يتم تحديد النوع.
BOOK يهدف هذا المنشور إلى حجز موعد أو طاولة أو غير ذلك.
ORDER يطلب هذا المنشور من المستخدم طلب شيء ما.
SHOP يريد هذا المنشور أن يتصفّح المستخدم كتالوج منتجات.
LEARN_MORE تهدف هذه المشاركة إلى تشجيع المستخدم على الاطّلاع على مزيد من المعلومات (على الموقع الإلكتروني).
SIGN_UP يطلب هذا المنشور من المستخدم التسجيل أو الاشتراك أو الانضمام إلى شيء ما.
GET_OFFER

تمّ الإيقاف. استخدِم OFFER في LocalPostTopicType لإنشاء مشاركة تتضمّن محتوى العرض الترويجي.
CALL يهدف هذا المنشور إلى تشجيع المستخدمين على الاتصال بالنشاط التجاري.

LocalPostEvent

جميع المعلومات المتعلّقة بحدث معروض في مشاركة محلية

تمثيل JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
الحقول
title

string

اسم الحدث
schedule

object (TimeInterval)

تمثّل هذه السمة تاريخ ووقت بدء الحدث وانتهائه.
recurrenceInfo

object (RecurrenceInfo)

اختياريّ. تخزِّن هذه السمة معلومات حول وتيرة نشر مشاركة متكرّرة. سيتم ضبط هذا الحقل فقط إذا كانت المشاركة متكرّرة.
recurringInstanceTime

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

TimeInterval

تمثّل هذه السمة فترة زمنية (مشمولة). يجب أن يحتوي على جميع الحقول ليكون صالحًا.

تمثيل JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
الحقول
startDate

object (Date)

تمثّل هذه السمة تاريخ بدء هذه الفترة.
startTime

object (TimeOfDay)

وقت بدء هذه الفترة.
endDate

object (Date)

تمثّل هذه السمة تاريخ انتهاء هذه الفترة.
endTime

object (TimeOfDay)

وقت انتهاء هذه الفترة

التاريخ

تمثّل هذه السمة تاريخًا كاملاً أو جزئيًا في التقويم، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. يكون التاريخ مرتبطًا بالتقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

الأنواع ذات الصلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

سنة التاريخ يجب أن تتراوح القيمة بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

الشهر من السنة يجب أن يكون الرقم بين 1 و12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وأن يكون صالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون فيه اليوم مهمًا.

TimeOfDay

تمثّل هذه السمة وقتًا من اليوم. لا يكون التاريخ والمنطقة الزمنية مهمَّين أو يتم تحديدهما في مكان آخر. يمكن لواجهة برمجة التطبيقات اختيار السماح بالثواني الكبيسة. تشمل الأنواع ذات الصلة google.type.Date وgoogle.protobuf.Timestamp.

تمثيل JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
الحقول
hours

integer

ساعات اليوم بتنسيق 24 ساعة يجب أن تكون القيمة أكبر من أو تساوي 0، ويجب أن تكون عادةً أقل من أو تساوي 23. يمكن لواجهة برمجة التطبيقات أن تسمح بالقيمة "24:00:00" في سيناريوهات مثل وقت إغلاق النشاط التجاري.
minutes

integer

دقائق الساعة يجب أن تكون القيمة أكبر من أو تساوي 0 وأقل من أو تساوي 59.
seconds

integer

ثواني الدقيقة يجب أن تكون القيمة أكبر من أو تساوي 0، ويجب أن تكون عادةً أقل من أو تساوي 59. قد يسمح أحد واجهات برمجة التطبيقات بالقيمة 60 إذا كان يسمح بالثواني الكبيسة.
nanos

integer

أجزاء من الثانية، بالنانو ثانية يجب أن تكون القيمة أكبر من أو تساوي 0 وأقل من أو تساوي 999,999,999.

RecurrenceInfo

تمثّل هذه السمة معلومات التكرار لمنشور محلي.

تمثيل JSON 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
الحقول
seriesEndTime

string (Timestamp format)

اختياريّ. تمثّل هذه السمة وقت انتهاء سلسلة التكرار.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
حقل الربط occurrence_pattern نمط تكرار المشاركة المتكرّرة يمكن أن يكون التعليق occurrence_pattern إحدى القيم التالية فقط:
dailyPattern

object (DailyOccurrencePattern)

نمط التكرار اليومي
weeklyPattern

object (WeeklyOccurrencePattern)

نمط التكرار الأسبوعي
monthlyPattern

object (MonthlyOccurrencePattern)

نمط التكرار الشهري

DailyOccurrencePattern

لا يتضمّن هذا النوع أي حقول.

تمثّل نمط تكرار يومي.

WeeklyOccurrencePattern

تمثّل نمط تكرار أسبوعي.

تمثيل JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
الحقول
daysOfWeek[]

enum (DayOfWeek)

اختياريّ. تمثّل هذه السمة قائمة بأيام الأسبوع التي يسري فيها العرض أو الحدث. إذا كانت القيمة فارغة، سيتم تكرار المشاركة في اليوم نفسه من الأسبوع الذي يظهر في schedule.start_time للفعالية.

DayOfWeek

تمثّل هذه السمة يومًا من أيام الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED لم يتم تحديد يوم الأسبوع.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

MonthlyOccurrencePattern

تمثّل هذه السمة نمط تكرار شهريًا.

تمثيل JSON 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
الحقول
حقل الربط monthly_option خيار التكرار لنمط التكرار الشهري يمكن أن يكون التعليق monthly_option إحدى القيم التالية فقط:
dayOfMonth

integer

اليوم من الشهر
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

يوم الأسبوع الذي يتكرّر في الشهر يتم تحديد يوم الأسبوع من خلال يوم الأسبوع الذي يبدأ فيه الحدث. على سبيل المثال، إذا بدأ حدث يوم الجمعة وكانت قيمة dayOfWeekOccurrence هي SECOND، سيتكرّر الحدث في ثاني جمعة من كل شهر.

DayOfWeekOccurrence

يوم الأسبوع الذي يتكرّر في الشهر

عمليات التعداد
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED تكرار غير محدّد ليوم من الأسبوع
FIRST اليوم الأول من الأسبوع في الشهر
SECOND اليوم الثاني من الأسبوع في الشهر
THIRD اليوم الثالث من الأسبوع في الشهر
FOURTH اليوم الرابع من الأسبوع في الشهر
LAST آخر يوم من الأسبوع في الشهر

LocalPostState

تشير هذه السمة إلى حالة المشاركة.

عمليات التعداد
LOCAL_POST_STATE_UNSPECIFIED لم يتم تحديد الولاية.
REJECTED تم رفض هذه المشاركة بسبب انتهاك سياسة المحتوى.
LIVE تم نشر هذه المشاركة وهي تظهر حاليًا في نتائج البحث.
PROCESSING جارٍ معالجة هذا المنشور ولا يظهر في نتائج البحث.
SCHEDULED تمت جدولة هذه المشاركة في المستقبل ولا تظهر في نتائج البحث.
RECURRING هذه المشاركة متكرّرة وتظهر حاليًا في نتائج البحث.

LocalPostTopicType

نوع موضوع المشاركة المحلية، والذي يُستخدَم لاختيار نماذج مختلفة لإنشاء مشاركة وعرضها

عمليات التعداد
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED لم يتم تحديد نوع المشاركة.
STANDARD تتضمّن المشاركة معلومات أساسية، مثل الملخّص والصور.
EVENT يحتوي المنشور على معلومات أساسية وحدث.
OFFER يتضمّن المنشور معلومات أساسية ومحتوى ذا صلة بحدث وعرض (مثل رمز قسيمة)
ALERT إشعارات مهمة وفي الوقت المناسب بشأن حدث جارٍ لا تتوفّر هذه الأنواع من المشاركات دائمًا لإنشائها.

AlertType

نوع الحدث الذي تم إنشاء مشاركة التنبيه له

عمليات التعداد
ALERT_TYPE_UNSPECIFIED لم يتم تحديد أي تنبيه.
COVID_19 تنبيهات متعلقة بجائحة فيروس كورونا المستجدّ لعام 2019 تتيح المنشورات المتعلقة بفيروس كورونا حقل ملخّص وحقل عبارة تحثّ على اتّخاذ إجراء فقط. وعندما تصبح هذه التنبيهات غير ذات صلة، سيتم إيقاف إنشاء مشاركات تنبيه جديدة من النوع "فيروس كورونا المستجد (كوفيد-19)". ومع ذلك، سيظل بإمكان التاجر إدارة مشاركاته الحالية المتعلقة بفيروس كورونا المستجد (كوفيد-19).

LocalPostOffer

حقول محدّدة لمشاركات العروض

تمثيل JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
الحقول
couponCode

string

اختياريّ. رمز العرض الترويجي الذي يمكن استخدامه في المتجر أو على الإنترنت
redeemOnlineUrl

string

اختياريّ. رابط على الإنترنت لتحصيل قيمة العرض
termsConditions

string

اختياريّ. أحكام العرض وشروطه

الطُرق

create

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

delete

 تحذف هذه الطريقة مشاركة محلية.

get

 تعرض هذه الطريقة المشاركة المحلية المحدّدة.

list

 تعرض هذه الطريقة قائمة بالمنشورات المحلية المرتبطة بموقع جغرافي.

patch

 تعدّل هذه الطريقة المشاركة المحلية المحدّدة وتعرض المشاركة المحلية المعدَّلة.