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)

פלט בלבד. השעה שבה נוצר הפוסט.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

פלט בלבד. השעה של השינוי האחרון של הפוסט על ידי המשתמש.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

event

object (LocalPostEvent)

פרטי האירוע. חובה לסוגים של נושאים EVENT ו-OFFER.

state

enum (LocalPostState)

פלט בלבד. המצב של הפוסט, שמציין באיזה שלב במחזור החיים הוא נמצא.

media[]

object (MediaItem)

המדיה המשויכת לפוסט. sourceUrl הוא שדה הנתונים היחיד שנתמך ב-MediaItem של LocalPost.

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

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

טיפוסים בני מנייה (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 התראות שקשורות למגפת נגיף הקורונה 2019. בפוסט בנושא קורונה אפשר להוסיף רק שדה סיכום ושדה של קריאה לפעולה. כשההתראות האלה לא יהיו רלוונטיות יותר, האפשרות ליצור פוסט חדש של התראה מסוג 'נגיף הקורונה (COVID-19)' תושבת. עם זאת, המוכרים עדיין יוכלו לנהל את הפוסטים הקיימים שלהם בנושא נגיף הקורונה.

LocalPostOffer

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

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

string

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

redeemOnlineUrl

string

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

termsConditions

string

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

Methods

create

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

delete

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

get

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

list

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

patch

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

reportInsights

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