- المرجع: LocalPost
- CallToAction
- ActionType
- LocalPostEvent
- TimeInterval
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- AlertType
- LocalPostOffer
- الطُرق
المرجع: LocalPost
تمثِّل مشاركة محلية لموقع جغرافي معيّن.
تمثيل JSON | |
---|---|
{ "name": string, "languageCode": string, "summary": string, "callToAction": { object ( |
الحقول | |
---|---|
name |
النتائج فقط. معرّف Google لهذه المشاركة المحلية بالتنسيق: |
languageCode |
لغة المشاركة المحلية. |
summary |
وصف/نص المشاركة المحلية |
callToAction |
عنوان URL الذي يتم توجيه المستخدمين إليه عند النقر على العرض الترويجي تم تجاهله لنوع الموضوع |
createTime |
النتائج فقط. وقت إنشاء المشاركة طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime |
النتائج فقط. وقت آخر تعديل تم إجراؤه من قِبل المستخدم على المشاركة. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
event |
معلومات عن الأحداث: مطلوبة لنوعَي المواضيع |
state |
النتائج فقط. حالة المشاركة التي تشير إلى جزء من دورة حياتها. |
media[] |
الوسائط المرتبطة بالمشاركة. sourceUrl هو حقل البيانات الوحيد المتوافق مع LocalPost MediaItem. |
searchUrl |
النتائج فقط. الرابط المؤدي إلى المشاركة المحلية في "بحث Google". ويمكن استخدام هذا الرابط لنشر المشاركة عبر وسائل التواصل الاجتماعي أو البريد الإلكتروني أو الرسائل النصية أو غير ذلك. |
topicType |
مطلوبة. نوع موضوع المشاركة: عادي أو حدث أو عرض أو تنبيه. |
alertType |
نوع التنبيه الذي يتم إنشاء المشاركة من أجله. لا ينطبق هذا الحقل إلا على مشاركات "تنبيه نوع topic"، ويعمل كنوع فرعي من التنبيهات. |
offer |
بيانات إضافية لمشاركات العروض يجب ضبط هذا الحقل فقط عندما يكون topicType هو OFFER. |
CallToAction
يشير هذا المصطلح إلى إجراء يتم تنفيذه عندما ينقر المستخدم على المشاركة.
تمثيل JSON | |
---|---|
{
"actionType": enum ( |
الحقول | |
---|---|
actionType |
نوع الإجراء الذي سيتم تنفيذه. |
url |
عنوان URL الذي سيتم توجيه المستخدم إليه عند النقر. يجب ترك هذا الحقل بدون ضبط للاستخدام مع الحثّ على اتّخاذ إجراء (CTA). |
ActionType
نوع الإجراء الذي سيتم تنفيذه.
عمليات التعداد | |
---|---|
ACTION_TYPE_UNSPECIFIED |
لم يتم تحديد النوع. |
BOOK |
تريد هذه المشاركة من المستخدم حجز موعد / جدول أو ما إلى ذلك. |
ORDER |
تريد هذه المشاركة من المستخدِم أن يطلب سلعة. |
SHOP |
تطلب هذه المشاركة من المستخدِم أن يتصفّح كتالوج المنتجات. |
LEARN_MORE |
تريد هذه المشاركة من المستخدِم الاطّلاع على المزيد من المعلومات (على موقعه الإلكتروني). |
SIGN_UP |
تريد هذه المشاركة من المستخدمين أن يقوموا بالتسجيل/الاشتراك/الانضمام إلى شيء ما. |
GET_OFFER |
تمّ الإيقاف. استخدِم |
CALL |
تريد هذه المشاركة من أحد المستخدمين الاتصال بالنشاط التجاري. |
LocalPostEvent
جميع المعلومات المتعلّقة بحدث معيّن واردة في مشاركة محلية
تمثيل JSON | |
---|---|
{
"title": string,
"schedule": {
object ( |
الحقول | |
---|---|
title |
اسم الحدث |
schedule |
تاريخ/وقت بدء الحدث وانتهائه |
TimeInterval
فاصل زمني، شامل. ويجب أن يحتوي على جميع الحقول ليكون صالحًا.
تمثيل JSON | |
---|---|
{ "startDate": { object ( |
الحقول | |
---|---|
startDate |
تاريخ بدء هذه الفترة. |
startTime |
وقت بدء هذه الفترة. |
endDate |
تاريخ انتهاء هذه الفترة. |
endTime |
وقت انتهاء هذه الفترة. |
TimeOfDay
يشير إلى وقت من اليوم. إما أن التاريخ والمنطقة الزمنية ليسا مهمين أو تم تحديدهما في مكان آخر. وقد تختار واجهة برمجة التطبيقات السماح بالثانية. النوعان ذوا الصلة هما google.type.Date
وgoogle.protobuf.Timestamp
.
تمثيل JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
الحقول | |
---|---|
hours |
ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق النشاط التجاري. |
minutes |
دقائق من اليوم. يجب أن تتراوح القيمة بين 0 و59. |
seconds |
ثوانٍ من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. قد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني. |
nanos |
أجزاء من الثانية بالنانو ثانية. يجب أن تتراوح القيمة بين 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 |
اختياريّ. اعرض رمزًا قابلاً للاستخدام في المتجر أو على الإنترنت. |
redeemOnlineUrl |
اختياريّ. رابط على الإنترنت لتحصيل قيمة العرض. |
termsConditions |
اختياريّ. أحكام العرض وشروطه. |
الطُرق |
|
---|---|
|
لإنشاء مشاركة محلية جديدة مرتبطة بالموقع الجغرافي المحدد، وعرضها. |
|
حذف مشاركة محلية. |
|
الحصول على المشاركة المحلية المحددة |
|
تعرض قائمة بالمشاركات المحلية المرتبطة بموقع جغرافي. |
|
لتعديل المشاركة المحلية المحدّدة وعرض المشاركة المحلية المعدَّلة |
|
تعرض إحصاءات لمجموعة من المشاركات المحلية المرتبطة ببطاقة بيانات واحدة. |