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 Alert, והוא פועל כסוג משנה של התראות.
offer

object (LocalPostOffer)

נתונים נוספים לפוסטים על מבצעים. יש להגדיר זאת רק כאשר topicType הוא OFFER.

CallToAction

פעולה שמתבצעת כשהמשתמש לוחץ כדי לעבור על הפוסט

ייצוג JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
שדות
actionType

enum (ActionType)

סוג הפעולה תבוצע.
url

string

כתובת ה-URL שאליה המשתמש יופנה לאחר לחיצה. אין להגדיר את השדה הזה לקריאה לפעולה מסוג שיחה.

ActionType

סוג הפעולה תבוצע.

טיפוסים בני מנייה (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)

תאריך/שעת ההתחלה והסיום של האירוע.

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 הודעות עם עדיפות גבוהה ועדכניות לגבי אירוע מתמשך. לא תמיד אפשר לכתוב פוסטים כאלה.

AlertType

סוג האירוע שעבורו נוצר פוסט ההתראה.

טיפוסים בני מנייה (enums)
ALERT_TYPE_UNSPECIFIED לא צוינה התראה.
COVID_19 התרעות הקשורות למגפת הקורונה (COVID-19) ב-2019. פוסטים בנושא קורונה תומכים רק בשדה סיכום ובשדה קריאה לפעולה. כשההתראות האלה לא יהיו רלוונטיות יותר, תושבת יצירה של פוסטים חדשים לשליחת התראות עבור סוג נגיף הקורונה (COVID-19). עם זאת, המוכר עדיין יוכל לנהל את הפוסטים הקיימים שלו שקשורות לנגיף הקורונה (COVID-19).

LocalPostOffer

שדות ספציפיים לפוסטים על מבצעים.

ייצוג JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
שדות
couponCode

string

אפשרות. קוד מבצע שאפשר להשתמש בו בחנות או באינטרנט.
redeemOnlineUrl

string

אפשרות. קישור אונליין למימוש המבצע.
termsConditions

string

אפשרות. התנאים וההגבלות של המבצע.

שיטות

create

 יוצרת פוסט מקומי חדש שמשויך למיקום שצוין ומחזירה אותו.

delete

 מוחק פוסט מקומי.

get

 הפונקציה מקבלת את הפוסט המקומי שצוין.

list

 מחזירה רשימה של פוסטים מקומיים המשויכים למיקום.

patch

 מעדכנת את הפוסט המקומי שצוין ומחזירה את הפוסט המקומי המעודכן.

reportInsights

 מחזירה תובנות לגבי קבוצה של פוסטים מקומיים המשויכים לדף עסקי אחד.