באמצעות ה-API של 'Google לעסק שלי' אפשר ליצור פוסטים בחיפוש Google לפי כמה קטגוריות, כמו חדשות, אירועים ומבצעים.
במדריך הזה תלמדו:
- ליצור פוסטים על אירועים.
- ליצור פוסטים של קריאה לפעולה.
- ליצור פוסטים על מבצעים.
- עריכת פוסטים.
- מחיקת פוסטים.
לפני שמתחילים
לפני שתוכלו להשתמש ב-Google My Business API, עליכם לרשום את האפליקציה ולקבל פרטי כניסה ל-OAuth 2.0.
לפרטים על התחלת השימוש ב-Google My Business API, קראו את המאמר הגדרה בסיסית.
פוסטים לגבי אירועים
אפשר לפרסם פוסט כדי לעדכן את הלקוחות לגבי האירוע הבא בעסק. הפוסט שלך לאירוע כולל תאריכי התחלה וסיום ושעות התחלה וסיום, שמוצגים באופן בולט בפוסט.
כדי ליצור פוסט בחשבון שמשויך למשתמש, משתמשים ב-accounts.locations.localPosts
API.
כדי ליצור פוסט למשתמש מאומת, אפשר להשתמש בשיטות הבאות:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
פוסטים של קריאה לפעולה
פוסטים עם קריאה לפעולה כוללים לחצן. הטקסט בלחצן הקריאה לפעולה נקבע לפי השדה actionType
בפוסט. ללחצן יתווסף קישור לכתובת URL שסיפק המשתמש.
כדי ליצור פוסט עם לחצן קריאה לפעולה, משתמשים באפשרויות הבאות:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
סוגי פעולות
פוסטים של קריאה לפעולה יכולים לכלול סוגי פעולות שונים שקובעים את סוג הפוסט של הקריאה לפעולה.
אלה הסוגים הנתמכים של קריאה לפעולה:
סוגי פעולות | |
---|---|
BOOK |
יצירת פוסט עם בקשה למשתמש לקבוע פגישה, שולחן או משהו דומה. |
ORDER |
יצירת פוסט עם בקשה למשתמש להזמין משהו. |
SHOP |
יצירת פוסט שמעודד משתמש לעיין בקטלוג מוצרים. |
LEARN_MORE |
יצירת פוסט שמבקש ממשתמש לראות פרטים נוספים באתר מסוים. |
SIGN_UP |
יוצר פוסט שקורא למשתמש להירשם, להירשם או להצטרף למשהו. |
CALL |
יצירת פוסט עם בקשה מהמשתמש להתקשר לעסק. |
פוסטים על מבצעים
כדי ליצור פוסט של מבצע, ניתן להשתמש בפעולות הבאות:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
עריכת פוסטים
לאחר יצירת פוסט, אפשר לערוך אותו באמצעות בקשת PATCH
.
כדי לערוך פוסט, משתמשים באפשרויות הבאות:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
מחיקת פוסטים
אחרי שהפוסט נוצר, אפשר למחוק אותו באמצעות בקשת DELETE
.
כדי למחוק פוסט, משתמשים באפשרויות הבאות:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}