יצירת פוסטים ב-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}