在 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 欄位。連結至 使用者提供的網址就會加到按鈕中。

如要建立含有行動號召按鈕的貼文,請使用下列方式:

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}