在 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}