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 )

آدرس اینترنتی که کاربران هنگام کلیک کردن از طریق تبلیغات به آن ارسال می شوند. برای نوع موضوع 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

فقط خروجی پیوند پست محلی در جستجوی گوگل. از این لینک می توان برای اشتراک گذاری پست از طریق رسانه های اجتماعی، ایمیل، متن و غیره استفاده کرد.

topicType

enum ( LocalPostTopicType )

ضروری. نوع موضوع پست: استاندارد، رویداد، پیشنهاد یا هشدار.

alertType

enum ( AlertType )

نوع هشداری که پست برای آن ایجاد شده است. این فیلد فقط برای پست‌های topicType Alert قابل استفاده است و به‌عنوان یک نوع فرعی از Alerts رفتار می‌کند.

offer

object ( LocalPostOffer )

داده های اضافی برای پست های پیشنهاد. این تنها زمانی باید تنظیم شود که موضوع نوع OFFER باشد.

فراخوانی برای اقدام

عملی که با کلیک کاربر روی پست انجام می شود

نمایندگی JSON
{
  "actionType": enum (ActionType),
  "url": string
}
زمینه های
actionType

enum ( ActionType )

نوع عملی که انجام خواهد شد.

url

string

URL کاربر پس از کلیک کردن به آن هدایت می شود. این قسمت باید برای Call CTA تنظیم نشده باقی بماند.

نوع اقدام

نوع عملی که انجام خواهد شد.

Enums
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 )

تاریخ/زمان شروع و پایان رویداد.

فاصله زمانی

یک فاصله زمانی، شامل. برای معتبر بودن باید شامل تمام فیلدها باشد.

نمایندگی 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

یک زمان از روز را نشان می دهد. تاریخ و منطقه زمانی یا مهم نیستند یا در جای دیگری مشخص شده اند. یک API ممکن است اجازه دهد ثانیه های کبیسه را مجاز کند. انواع مرتبط عبارتند از google.type.Date و google.protobuf.Timestamp .

نمایندگی JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
زمینه های
hours

integer

ساعات روز در قالب 24 ساعته. باید از 0 تا 23 باشد. یک API ممکن است برای سناریوهایی مانند زمان بسته شدن کسب و کار، مقدار "24:00:00" را مجاز کند.

minutes

integer

دقیقه از ساعت روز. باید از 0 تا 59 باشد.

seconds

integer

ثانیه های دقیقه از زمان. معمولاً باید از 0 تا 59 باشد. یک API ممکن است مقدار 60 را مجاز کند اگر ثانیه های کبیسه را مجاز کند.

nanos

integer

کسری از ثانیه در نانوثانیه. باید از 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

string

اختیاری. کد پیشنهادی قابل استفاده در فروشگاه یا آنلاین.

redeemOnlineUrl

string

اختیاری. پیوند آنلاین برای بازخرید پیشنهاد.

termsConditions

string

اختیاری. شرایط و ضوابط را پیشنهاد دهید.

مواد و روش ها

create

 یک پست محلی جدید مرتبط با مکان مشخص شده ایجاد می کند و آن را برمی گرداند.

delete

 یک پست محلی را حذف می کند.

get

 پست محلی مشخص شده را دریافت می کند.

list

 فهرستی از پست‌های محلی مرتبط با یک مکان را برمی‌گرداند.

patch

 پست محلی مشخص شده را به روز می کند و پست محلی به روز شده را برمی گرداند.

reportInsights

 بینش مجموعه‌ای از پست‌های محلی مرتبط با یک فهرست را برمی‌گرداند.