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)

نوع التنبيه الذي يتم إنشاء المشاركة من أجله. لا ينطبق هذا الحقل إلا على مشاركات "تنبيه نوع topic"، ويعمل كنوع فرعي من التنبيهات.
offer

object (LocalPostOffer)

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

CallToAction

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

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

enum (ActionType)

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

string

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

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 تنبيهات ذات صلة بجائحة مرض فيروس كورونا المستجد (كوفيد-2019) لعام 2019 تتيح المشاركات المرتبطة بفيروس كورونا المستجد (كوفيد-19) حقل ملخّص وحقل عبارة تحث المستخدم على اتخاذ إجراء فقط. وعندما لا تصبح هذه التنبيهات ذات صلة، سيتم إيقاف إنشاء مشاركات تنبيهات جديدة للنوع "كوفيد-19". وسيظل بإمكان التاجر إدارة المشاركات الحالية المتعلّقة بفيروس كورونا المستجد (كوفيد-19).

LocalPostOffer

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

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

string

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

string

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

string

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

الطُرق

create

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

delete

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

get

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

list

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

patch

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

reportInsights

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