יצירה של פוסטים ב-Google

באמצעות ה-API של 'Google לעסק שלי' אפשר ליצור פוסטים בחיפוש Google לפי כמה קטגוריות, כמו חדשות, אירועים ומבצעים.

במדריך הזה תלמדו:

לפני שמתחילים

לפני שתוכלו להשתמש ב-Google My Business API, עליכם לרשום את האפליקציה ולקבל פרטי כניסה ל-OAuth 2.0.

לפרטים על התחלת השימוש ב-Google My Business API, קראו את המאמר הגדרה בסיסית.

פוסטים לגבי אירועים

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

כדי ליצור פוסט בחשבון שמשויך למשתמש, משתמשים ב-accounts.locations.localPosts API.

כדי ליצור פוסט למשתמש מאומת, אפשר להשתמש בשיטות הבאות:

HTTP
$ 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 שסיפק המשתמש.

כדי ליצור פוסט עם לחצן קריאה לפעולה, משתמשים באפשרויות הבאות:

HTTP
$ 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 יצירת פוסט עם בקשה מהמשתמש להתקשר לעסק.

פוסטים על מבצעים

כדי ליצור פוסט של מבצע, ניתן להשתמש בפעולות הבאות:

HTTP
$ 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.

כדי לערוך פוסט, משתמשים באפשרויות הבאות:

HTTP
$ PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary
{
  "summary": "Order your Christmas turkeys now!!"
}

מחיקת פוסטים

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

כדי למחוק פוסט, משתמשים באפשרויות הבאות:

HTTP
$ DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}