REST Resource: accounts.locations.localPosts

משאב: LocalPost

ייצוג של פוסט מקומי במיקום מסוים.

ייצוג JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "recurringInstanceTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
שדות
name

string

פלט בלבד. מזהה Google של הפוסט המקומי הזה בטופס: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
languageCode

string

השפה של הפוסט המקומי.
summary

string

תיאור או תוכן הפוסט המקומי.
callToAction

object (CallToAction)

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

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

אם הערך מוגדר, הוא קובע מתי הפוסט יפורסם. המשתמש יכול להגדיר את האפשרות הזו כדי לתזמן פוסטים מראש.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

פלט בלבד. הוצא משימוש: במקומו, צריך להשתמש ב-event.recurring_instance_time. השדה הזה יוסר בגרסה עתידית. פלט בלבד. השעה שבה עודכן המופע האחרון של הפוסט שחוזר על עצמו.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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, והוא מתנהג כסוג משנה של התראות.
שדה איחוד topic_type_specific_fields. שדות ספציפיים לסוג נושא. הערך topic_type_specific_fields יכול להיות רק אחד מהבאים:
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)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
שדות
title

string

שם האירוע.
schedule

object (TimeInterval)

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

object (RecurrenceInfo)

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

string (Timestamp format)

פלט בלבד. השעה שבה עודכן המופע האחרון של הפוסט שחוזר על עצמו.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

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)

שעת הסיום של התקופה.

תאריך

מייצג תאריך מלא או חלקי ביומן, כמו יום הולדת. השעה ביום ואזור הזמן מצוינים במקום אחר או שהם לא משמעותיים. התאריך הוא ביחס ללוח השנה הגרגוריאני. הערך הזה יכול לייצג את אחת מהאפשרויות הבאות:

  • תאריך מלא, עם ערכים שאינם אפס לשנה, לחודש וליום.
  • חודש ויום, עם שנה אפס (לדוגמה, יום נישואין).
  • שנה לבד, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך התפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך חייב להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

היום בחודש. הערך חייב להיות בין 1 ל-31, והוא צריך להיות תקף לשנה ולחודש, או 0 כדי לציין רק שנה או שנה וחודש שבהם היום לא משמעותי.

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 או שווה לו.

RecurrenceInfo

מייצג את פרטי החזרה של פוסט מקומי.

ייצוג JSON 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
שדות
seriesEndTime

string (Timestamp format)

אופציונלי. שעת הסיום של סדרת החזרות.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
שדה איחוד occurrence_pattern. דפוס החזרה של הפוסט החוזר. הערך occurrence_pattern יכול להיות רק אחד מהבאים:
dailyPattern

object (DailyOccurrencePattern)

דפוס חזרה יומי.
weeklyPattern

object (WeeklyOccurrencePattern)

דפוס של אירועים שמתרחשים מדי שבוע.
monthlyPattern

object (MonthlyOccurrencePattern)

דפוס חזרה חודשי.

DailyOccurrencePattern

בסוג הזה אין שדות.

מייצג דפוס של אירוע יומי.

WeeklyOccurrencePattern

מייצג דפוס של אירוע שמתרחש מדי שבוע.

ייצוג JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
שדות
daysOfWeek[]

enum (DayOfWeek)

אופציונלי. רשימת הימים בשבוע שבהם המבצע או האירוע תקפים. אם השדה ריק, הפוסט יחזור על עצמו באותו יום בשבוע שבו מתקיים האירוע, בהתאם לערך של schedule.start_time.

DayOfWeek

מייצג יום בשבוע.

טיפוסים בני מנייה (enum)
DAY_OF_WEEK_UNSPECIFIED לא צוין יום בשבוע.
MONDAY שני
TUESDAY שלישי
WEDNESDAY רביעי
THURSDAY חמישי
FRIDAY שישי
SATURDAY שבת
SUNDAY ראשון

MonthlyOccurrencePattern

מייצג דפוס של אירוע שמתרחש מדי חודש.

ייצוג JSON 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
שדות
שדה איחוד monthly_option. אפשרות החזרה של דפוס ההתרחשות החודשי. הערך monthly_option יכול להיות רק אחד מהבאים:
dayOfMonth

integer

היום בחודש.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

היום בשבוע שבו האירוע מתרחש בחודש. היום בשבוע משתמע מהיום בשבוע של שעת ההתחלה של האירוע. לדוגמה, אם אירוע מתחיל ביום שישי והערך של dayOfWeekOccurrence הוא SECOND, האירוע יחזור על עצמו ביום שישי השני בכל חודש.

DayOfWeekOccurrence

היום בשבוע שבו האירוע מתרחש בחודש.

טיפוסים בני מנייה (enum)
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED לא צוין היום בשבוע שבו מתרחשת הפעולה.
FIRST היום הראשון בשבוע בחודש.
SECOND ביום השני בשבוע בחודש.
THIRD ביום השלישי בשבוע בחודש.
FOURTH ביום הרביעי בשבוע בחודש.
LAST היום האחרון בשבוע בחודש.

LocalPostState

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

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

LocalPostTopicType

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

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

AlertType

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

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

LocalPostOffer

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

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

string

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

string

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

string

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

Methods

create

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

delete

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

get

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

list

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

patch

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