יצירת פוסטים ב-Google

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

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

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

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

מידע נוסף על תחילת העבודה עם Google My Business API זמין במאמר הגדרה בסיסית.

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

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

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

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

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}