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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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). في المقابل، سيظل بإمكان التاجر إدارة المشاركات الحالية المتعلّقة بفيروس كورونا المستجد (كوفيد-19).

LocalPostOffer

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

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

string

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

string

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

string

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

الطُرق

create

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

delete

 يؤدي هذا الإجراء إلى حذف مشاركة محلية.

get

 للحصول على المشاركة المحلية المحدّدة

list

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

patch

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

reportInsights

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