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)

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

object (LocalPostOffer)

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

CallToAction

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

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

enum (ActionType)

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

string

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

ActionType

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

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

מציין באיזה מצב נמצא הפוסט

טיפוסים בני מנייה (enum)
LOCAL_POST_STATE_UNSPECIFIED המצב לא צוין.
REJECTED הפוסט הזה נדחה בגלל הפרה של מדיניות התוכן.
LIVE הפוסט הזה פורסם ומופיע כרגע בתוצאות חיפוש.
PROCESSING הפוסט הזה מעובד והוא לא מופיע בתוצאות החיפוש.

LocalPostTopicType

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

טיפוסים בני מנייה (enum)
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED לא צוין סוג פוסט.
STANDARD הפוסט מכיל מידע בסיסי, כמו סיכום ותמונות.
EVENT הפוסט מכיל מידע בסיסי ואירוע.
OFFER הפוסט מכיל מידע בסיסי, אירוע ותוכן שקשור למבצע (למשל, קוד שובר)
ALERT הודעות בעדיפות גבוהה והודעות מתוזמנות שקשורות לאירוע מתמשך. לא תמיד אפשר ליצור פוסטים מהסוגים האלה.

AlertType

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

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

LocalPostOffer

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

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

string

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

string

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

string

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

שיטות

create

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

delete

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

get

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

list

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

patch

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

reportInsights

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