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

Google My Business API מאפשר ליצור פוסטים חיפוש 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}