- משאב: LocalPost
- CallToAction
- ActionType
- LocalPostEvent
- TimeInterval
- TimeOfDay
- LocalPostState
- LocalPostTopicType
- AlertType
- LocalPostOffer
- שיטות
משאב: LocalPost
מייצג פוסט מקומי של מיקום.
ייצוג JSON | |
---|---|
{ "name": string, "languageCode": string, "summary": string, "callToAction": { object ( |
שדות | |
---|---|
name |
פלט בלבד. מזהה Google של הפוסט המקומי הזה בטופס: |
languageCode |
השפה של הפוסט המקומי. |
summary |
התיאור/הגוף של הפוסט המקומי. |
callToAction |
כתובת ה-URL שאליה המשתמשים נשלחים כשהם לוחצים על המבצע. המערכת התעלמה מנושא מסוג |
createTime |
פלט בלבד. מועד יצירת הפוסט. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
updateTime |
פלט בלבד. שעת השינוי האחרון שבוצע בפוסט על ידי המשתמש. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
event |
פרטי האירוע. חובה לסוגי הנושאים |
state |
פלט בלבד. מצב הפוסט, שמציין באיזה חלק במחזור החיים הוא נמצא. |
media[] |
המדיה המשויכת לפוסט. sourceUrl היא שדה הנתונים הנתמך היחיד ל-LocalPost MediaItem. |
searchUrl |
פלט בלבד. הקישור לפוסט המקומי בחיפוש Google. אפשר להשתמש בקישור הזה כדי לשתף את הפוסט ברשתות חברתיות, באימייל, בהודעת טקסט וכו'. |
topicType |
חובה. סוג הנושא של הפוסט: רגיל, אירוע, מבצע או התראה. |
alertType |
סוג ההתראה שעבורה נוצר הפוסט. השדה הזה רלוונטי רק לפוסטים עם topicType Alert, והוא פועל כסוג משנה של התראות. |
offer |
נתונים נוספים לפוסטים על מבצעים. יש להגדיר זאת רק כאשר topicType הוא OFFER. |
CallToAction
פעולה שמתבצעת כשהמשתמש לוחץ כדי לעבור על הפוסט
ייצוג JSON | |
---|---|
{
"actionType": enum ( |
שדות | |
---|---|
actionType |
סוג הפעולה תבוצע. |
url |
כתובת ה-URL שאליה המשתמש יופנה לאחר לחיצה. אין להגדיר את השדה הזה לקריאה לפעולה מסוג שיחה. |
ActionType
סוג הפעולה תבוצע.
טיפוסים בני מנייה (enums) | |
---|---|
ACTION_TYPE_UNSPECIFIED |
הסוג לא צוין. |
BOOK |
בפוסט הזה ברצונך שמשתמש יקבע פגישה/שולחן וכו'. |
ORDER |
פוסט זה מבקש שמשתמש יזמין משהו. |
SHOP |
בפוסט הזה ברצונך שמשתמש יעיין בקטלוג מוצרים. |
LEARN_MORE |
בפוסט הזה אתם רוצים שהמשתמש יקבל מידע נוסף (באתר שלו). |
SIGN_UP |
פוסט זה מבקש שמשתמש יירשם/יירשם/יהצטרף למשהו. |
GET_OFFER |
הוּצא משימוש. כדי ליצור פוסט עם תוכן של מבצעים צריך להשתמש בתוסף |
CALL |
בפוסט הזה נשלחה בקשה שמשתמש יתקשר לעסק. |
LocalPostEvent
כל המידע שקשור לאירוע שמופיע בפוסט מקומי.
ייצוג JSON | |
---|---|
{
"title": string,
"schedule": {
object ( |
שדות | |
---|---|
title |
שם האירוע. |
schedule |
תאריך/שעת ההתחלה והסיום של האירוע. |
TimeInterval
מרווח זמן, כולל. כדי שהוא יהיה חוקי, הוא צריך לכלול את כל השדות.
ייצוג JSON | |
---|---|
{ "startDate": { object ( |
שדות | |
---|---|
startDate |
תאריך ההתחלה של תקופה זו. |
startTime |
שעת ההתחלה של פרק הזמן הזה. |
endDate |
תאריך הסיום של תקופה זו. |
endTime |
מועד הסיום של תקופה זו. |
TimeOfDay
מייצג את השעה ביום. התאריך ואזור הזמן אינם משמעותיים או מצוינים במקום אחר. ממשק API עשוי לבחור לאפשר שניות מעבר. הסוגים הקשורים הם google.type.Date
ו-google.protobuf.Timestamp
.
ייצוג JSON | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
שדות | |
---|---|
hours |
שעות ביום בפורמט 24 שעות. צריך להיות בין 0 ל-23. ממשק API עשוי לאפשר את הערך '24:00:00' בתרחישים כמו שעת הסגירה של העסק. |
minutes |
דקות בשעה ביום. הערך חייב להיות בין 0 ל-59. |
seconds |
שניות של דקות מזמן. בדרך כלל צריך להיות מספר בין 0 ל-59. ממשק API עשוי להתיר את הערך 60 אם הוא מאפשר שניות מדלגות. |
nanos |
שברים של שניות בננו-שניות. חייב להיות בין 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 |
אפשרות. קוד מבצע שאפשר להשתמש בו בחנות או באינטרנט. |
redeemOnlineUrl |
אפשרות. קישור אונליין למימוש המבצע. |
termsConditions |
אפשרות. התנאים וההגבלות של המבצע. |
שיטות |
|
---|---|
|
יוצרת פוסט מקומי חדש שמשויך למיקום שצוין ומחזירה אותו. |
|
מוחק פוסט מקומי. |
|
הפונקציה מקבלת את הפוסט המקומי שצוין. |
|
מחזירה רשימה של פוסטים מקומיים המשויכים למיקום. |
|
מעדכנת את הפוסט המקומי שצוין ומחזירה את הפוסט המקומי המעודכן. |
|
מחזירה תובנות לגבי קבוצה של פוסטים מקומיים המשויכים לדף עסקי אחד. |