REST Resource: accounts.locations.localPosts

المرجع: LocalPost

يمثّل مشاركة محلية لموقع جغرافي.

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

string

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

string

لغة الرسالة المحلية
summary

string

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

object (CallToAction)

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

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
event

object (LocalPostEvent)

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

enum (LocalPostState)

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

object (MediaItem)

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

string

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

enum (LocalPostTopicType)

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

enum (AlertType)

نوع التنبيه الذي تم إنشاء المشاركة من أجله لا ينطبق هذا الحقل إلّا على المشاركات التي يكون topicType فيها "تنبيه"، ويعمل كنوع فرعي من التنبيهات.
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)
  }
}
الحقول
title

string

اسم الحدث
schedule

object (TimeInterval)

تاريخ ووقت بدء الحدث وانتهائه

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)

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

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.

LocalPostState

يشير إلى حالة المشاركة

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

LocalPostTopicType

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

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

AlertType

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

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

LocalPostOffer

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

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

string

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

string

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

string

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

الطُرق

create

 لإنشاء مشاركة جديدة في المتجر مرتبطة بالموقع الجغرافي المحدّد وإعادتها

delete

 لحذف مشاركة محلية

get

 تحصل على الرسالة المحلية المحدّدة.

list

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

patch

 تعديل المشاركة المحلية المحدّدة وإرجاع المشاركة المحلية المعدّلة

reportInsights

 تعرِض هذه السمة إحصاءات لمجموعة من المشاركات المحلية المرتبطة ببطاقة بيانات واحدة.