Google My Business API מאפשר לכם ליצור פוסטים בחיפוש Google בכמה קטגוריות, כמו חדשות, אירועים ומבצעים.
במדריך הזה תלמדו איך:
- ליצור פוסטים על אירועים.
- ליצור פוסטים עם קריאה לפעולה.
- יוצרים פוסטים של מבצעים.
- עריכת פוסטים.
- מחיקת פוסטים.
לפני שמתחילים
לפני שמשתמשים ב-API של 'Google לעסק שלי', צריך לרשום את האפליקציה ולקבל פרטי כניסה ל-OAuth 2.0.
מידע נוסף על תחילת העבודה עם Google My Business API זמין במאמר הגדרה בסיסית.
פוסטים על אירועים
אתם יכולים להודיע ללקוחות על האירוע הבא בעסק באמצעות פוסט. הפוסט של האירוע כולל את התאריכים והשעות של ההתחלה והסיום, שמוצגים במקום בולט בפוסט.
כדי לפרסם פוסט בחשבון שמשויך למשתמש, משתמשים ב-API של accounts.locations.localPosts
.
כדי ליצור פוסט למשתמש מאומת, משתמשים בקוד הבא:
$ 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}