- منبع: LocalPost
- CallToAction
- نوع اقدام
- LocalPostEvent
- بازه زمانی
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- نوع هشدار
- پیشنهاد LocalPost
- روش ها
منبع: LocalPost
نشان دهنده یک پست محلی برای یک مکان است.
نمایندگی JSON | |
---|---|
{ "name": string, "languageCode": string, "summary": string, "callToAction": { object ( |
فیلدها | |
---|---|
name | فقط خروجی شناسه Google برای این پست محلی به شکل: |
languageCode | زبان پست محلی. |
summary | توضیحات/بدنه پست محلی. |
callToAction | آدرس اینترنتی که کاربران هنگام کلیک کردن از طریق تبلیغات به آن ارسال می شوند. برای نوع موضوع |
createTime | فقط خروجی زمان ایجاد پست مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
updateTime | فقط خروجی زمان آخرین اصلاح پست توسط کاربر. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
event | اطلاعات رویداد. برای انواع موضوع |
state | فقط خروجی وضعیت پست، نشان می دهد که در چه بخشی از چرخه حیات آن قرار دارد. |
media[] | رسانه های مرتبط با این پست sourceUrl تنها فیلد داده پشتیبانی شده برای LocalPost MediaItem است. |
searchUrl | فقط خروجی پیوند پست محلی در جستجوی گوگل. از این لینک می توان برای اشتراک گذاری پست از طریق رسانه های اجتماعی، ایمیل، متن و غیره استفاده کرد. |
topicType | مورد نیاز. نوع موضوع پست: استاندارد، رویداد، پیشنهاد یا هشدار. |
alertType | نوع هشداری که پست برای آن ایجاد شده است. این فیلد فقط برای پستهای topicType Alert قابل استفاده است و بهعنوان یک نوع فرعی از Alerts رفتار میکند. |
offer | داده های اضافی برای پست های پیشنهاد. این تنها زمانی باید تنظیم شود که موضوع نوع OFFER باشد. |
CallToAction
عملی که با کلیک کاربر روی پست انجام می شود
نمایندگی JSON | |
---|---|
{
"actionType": enum ( |
فیلدها | |
---|---|
actionType | نوع عملی که انجام خواهد شد. |
url | URL کاربر پس از کلیک کردن به آن هدایت می شود. این قسمت باید برای Call CTA تنظیم نشده باقی بماند. |
نوع اقدام
نوع عملی که انجام خواهد شد.
Enums | |
---|---|
ACTION_TYPE_UNSPECIFIED | تایپ نامشخص |
BOOK | این پست از یک کاربر می خواهد که یک قرار ملاقات / میز / و غیره رزرو کند. |
ORDER | این پست از کاربر می خواهد چیزی سفارش دهد. |
SHOP | این پست از کاربر می خواهد تا کاتالوگ محصول را مرور کند. |
LEARN_MORE | این پست از یک کاربر می خواهد که اطلاعات بیشتری کسب کند (در وب سایت خود). |
SIGN_UP | این پست از یک کاربر می خواهد که ثبت نام/ثبت نام/به چیزی بپیوندد. |
GET_OFFER | منسوخ شده است. از |
CALL | این پست از یک کاربر می خواهد که با کسب و کار تماس بگیرد. |
LocalPostEvent
تمام اطلاعات مربوط به یک رویداد در یک پست محلی نشان داده شده است.
نمایندگی JSON | |
---|---|
{
"title": string,
"schedule": {
object ( |
فیلدها | |
---|---|
title | نام رویداد. |
schedule | تاریخ/زمان شروع و پایان رویداد. |
بازه زمانی
یک فاصله زمانی، شامل. برای معتبر بودن باید شامل تمام فیلدها باشد.
نمایندگی JSON | |
---|---|
{ "startDate": { object ( |
فیلدها | |
---|---|
startDate | تاریخ شروع این دوره. |
startTime | زمان شروع این دوره. |
endDate | تاریخ پایان این دوره. |
endTime | زمان پایان این دوره. |
TimeOfDay
یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک API ممکن است اجازه دهد ثانیه های کبیسه را مجاز کند. انواع مرتبط عبارتند از google.type.Date
و google.protobuf.Timestamp
.
نمایندگی JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
فیلدها | |
---|---|
hours | ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند. |
minutes | دقیقه از ساعت روز. باید از 0 تا 59 باشد. |
seconds | ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند. |
nanos | کسری از ثانیه در نانوثانیه. باید از 0 تا 999,999,999 باشد. |
LocalPostState
نشان می دهد که پست در چه وضعیتی است
Enums | |
---|---|
LOCAL_POST_STATE_UNSPECIFIED | ایالت مشخص نشده است. |
REJECTED | این پست به دلیل نقض خط مشی محتوا رد شد. |
LIVE | این پست منتشر شده و در حال حاضر در نتایج جستجو نمایش داده می شود. |
PROCESSING | این پست در حال پردازش است و در نتایج جستجو ظاهر نمی شود. |
LocalPostTopicType
نوع موضوع پست محلی، که برای انتخاب الگوهای مختلف برای ایجاد و ارائه یک پست استفاده می شود.
Enums | |
---|---|
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED | هیچ نوع پستی مشخص نشده است. |
STANDARD | پست حاوی اطلاعات اولیه مانند خلاصه و تصاویر است. |
EVENT | پست حاوی اطلاعات اولیه و یک رویداد است. |
OFFER | پست حاوی اطلاعات اولیه، یک رویداد و محتوای مرتبط با پیشنهاد (مانند کد کوپن) است. |
ALERT | اعلامیه های با اولویت بالا و به موقع مربوط به یک رویداد در حال انجام. این نوع پست ها همیشه برای نوشتن در دسترس نیستند. |
نوع هشدار
نوع رویدادی که پست هشدار برای آن ایجاد شده است.
Enums | |
---|---|
ALERT_TYPE_UNSPECIFIED | هیچ هشداری مشخص نشده است. |
COVID_19 | هشدارهای مربوط به همه گیری بیماری کروناویروس 2019. پستهای کووید فقط از یک فیلد خلاصه و یک میدان فراخوان برای اقدام پشتیبانی میکنند. وقتی این هشدارها دیگر مرتبط نباشند، ایجاد پست هشدار جدید برای نوع COVID-19 غیرفعال خواهد شد. با این حال، تاجر همچنان میتواند پستهای COVID-19 موجود خود را مدیریت کند. |
پیشنهاد LocalPost
زمینه های خاص برای پست های پیشنهادی.
نمایندگی JSON | |
---|---|
{ "couponCode": string, "redeemOnlineUrl": string, "termsConditions": string } |
فیلدها | |
---|---|
couponCode | اختیاری. کد پیشنهادی قابل استفاده در فروشگاه یا آنلاین. |
redeemOnlineUrl | اختیاری. پیوند آنلاین برای بازخرید پیشنهاد. |
termsConditions | اختیاری. شرایط و ضوابط را پیشنهاد دهید. |
روش ها | |
---|---|
| یک پست محلی جدید مرتبط با مکان مشخص شده ایجاد می کند و آن را برمی گرداند. |
| یک پست محلی را حذف می کند. |
| پست محلی مشخص شده را دریافت می کند. |
| فهرستی از پستهای محلی مرتبط با یک مکان را برمیگرداند. |
| پست محلی مشخص شده را به روز می کند و پست محلی به روز شده را برمی گرداند. |
| بینش مجموعهای از پستهای محلی مرتبط با یک فهرست را برمیگرداند. |