- משאב: 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 |
פלט בלבד. השעה שבה נוצר הפוסט. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
updateTime |
פלט בלבד. השעה של השינוי האחרון של הפוסט על ידי המשתמש. חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
event |
פרטי האירוע. חובה לסוגים של נושאים |
state |
פלט בלבד. המצב של הפוסט, שמציין באיזה שלב במחזור החיים הוא נמצא. |
media[] |
המדיה המשויכת לפוסט. sourceUrl הוא שדה הנתונים היחיד שנתמך ב-MediaItem של LocalPost. |
searchUrl |
פלט בלבד. הקישור לפוסט המקומי בחיפוש Google. אפשר להשתמש בקישור הזה כדי לשתף את הפוסט ברשתות חברתיות, באימייל, בהודעת טקסט וכו'. |
topicType |
חובה. סוג הנושא של הפוסט: רגיל, אירוע, מבצע או התראה. |
alertType |
סוג ההתראה שעבורה נוצר הפוסט. השדה הזה רלוונטי רק לפוסטים מסוג topicType Alert, והוא פועל כסוג משנה של התראות. |
offer |
נתונים נוספים לפוסטים של מבצעים. צריך להגדיר את השדה הזה רק כשהערך של topicType הוא OFFER. |
CallToAction
פעולה שמתבצעת כשהמשתמש לוחץ על הפוסט
ייצוג ב-JSON | |
---|---|
{
"actionType": enum ( |
שדות | |
---|---|
actionType |
סוג הפעולה שתתבצע. |
url |
כתובת ה-URL שאליה המשתמש יועבר כשילחץ. לא צריך להגדיר את השדה הזה לקריאה לפעולה מסוג 'שיחה'. |
ActionType
סוג הפעולה שתתבצע.
טיפוסים בני מנייה (enum) | |
---|---|
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
מציין את המצב של הפוסט
טיפוסים בני מנייה (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 |
זה שינוי אופציונלי. קוד מבצע שאפשר להשתמש בו בחנות או באינטרנט. |
redeemOnlineUrl |
זה שינוי אופציונלי. קישור אונליין למימוש המבצע. |
termsConditions |
זה שינוי אופציונלי. התנאים וההגבלות של המבצע. |
Methods |
|
---|---|
|
הפונקציה יוצרת פוסט מקומי חדש שמשויך למיקום שצוין ומחזירה אותו. |
|
מחיקת פוסט מקומי. |
|
הפונקציה מקבלת את הפוסט המקומי שצוין. |
|
הפונקציה מחזירה רשימה של פוסטים מקומיים שמשויכים למיקום מסוים. |
|
הפונקציה מעדכנת את הפוסט המקומי שצוין ומחזירה את הפוסט המקומי המעודכן. |
|
הפונקציה מחזירה תובנות לגבי קבוצה של פוסטים מקומיים שמשויכים לדף עסקי יחיד. |