Google Business Profile API - Ayrshare API Documentation

發布到 Google Business Profile

透過 Google Business Profile API（前身為 Google My Business）可以建立四種類型的貼文。在下方範例中，post 文字會以更新內容的形式發布到使用者的 Google 商家頁面。進一步了解 Google Business Profile（GBP）。

在將 Google Business Profile 頁面連結到 Ayrshare 之前，你必須先認領你的頁面。授權連結時，請務必選擇管理該 GBP 頁面的 Google 帳號。此外，該商家檔案必須已通過驗證且為公開狀態。你可以在 https://business.google.com/ 存取 GBP 管理主控台並查看驗證狀態。

目前無法透過 Google Business Profile API 建立產品貼文。發布純文字貼文到 GBP 的 JSON 範例，該貼文會出現在 “What’s New” 區塊中：

Google Business Profile Post

{
  "post": "The best GMB ever #best https://www.google.com",
  "platforms": ["gmb"] // Please note to use `gmb`
}

或是發布含圖片的基本貼文到 GBP 的 JSON 範例：

Google Business Profile Post with Image

{
  "post": "The best GMB ever #best https://www.google.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["gmb"]
}

如果你的影片副檔名不是常見的影片格式（例如 mp4），請使用 isVideo 參數。詳情請參閱 /post 端點。
更多資訊請參閱 Google Business Profile 媒體指南與 Google Business Profile 授權。

Google Business Profile 發布規範

請確認你的貼文不包含以下內容。否則 Google 會拒絕該貼文，貼文會顯示為 “This post is no longer available”，或在 Google Console 中顯示 “Rejected” 標籤：

電話號碼。Google 會拒絕所有包含電話號碼的貼文。
垃圾內容、不實聲明或虛假陳述。
與商家業務無關的離題貼文。
重複內容。
不當內容。
冒犯性用語。

更多資訊請參閱 Google Business Profile 的內容政策。

標準貼文（What’s New）

標準的在地貼文會出現在 GBP 的「Posts」區塊，並歸類為 “What’s New”。此類貼文可包含文字、圖片，或行動呼籲按鈕（請見下方）。透過 Google Business Profile API 無法將影片發布到 What’s New 區塊。若要將影片發布到 Google Business Profile，請參閱圖片或影片貼文。 這類貼文會顯示在 GMB 管理主控台的「Posts -> What’s New」區塊。

Google Business Profile Standard Post

{
  "post": "A wonderful post",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional - images only
  "gmbOptions": {
    "callToAction": {
      // optional
      "actionType": "learn_more",
      "url": "https://www.ayrshare.com"
    }
  }
}

圖片或影片貼文

你可以將圖片或影片貼文發布到 Google Business Profile。圖片與影片會顯示在 GBP 管理主控台的「Photos」區塊。

需求

每次只能為 GBP 位置新增一張圖片或一部影片，並會顯示在 GBP 主控台的 “Photos” 區塊。
每則貼文只能包含一張圖片或一部影片。
端點要求必須提供貼文文字，但該文字不會被 GBP 使用。
圖片或影片貼文不支援行動呼籲按鈕。
請務必在 gmbOptions 物件中加入 isPhotoVideo 參數。

Google Business Profile Image Post

{
  "post": "What an image!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // required
  "gmbOptions": {
    "isPhotoVideo": true, //required
    "category": "product" // optional
  }
}

影片處理

Google 有時處理已上傳的影片會花較長的時間。你可以在 Google Business Profile 主控台檢視媒體的狀態：

前往你的 Google Business Profile 主控台。
點擊「See your profile」按鈕，會被導向 GBP 頁面。
點擊「Photos」分頁。
你會看到照片與影片的清單。
點擊你想檢視的照片或影片。

如果你的影片狀態顯示為 “pending”，代表 Google 仍在處理中。請稍候幾分鐘後重新整理頁面。也請確認你的 Google Business Profile 已通過驗證且為公開狀態。如果影片一直卡在 “pending” 狀態，可能是 Google 端的 bug。請聯絡 Google Business 客服尋求協助。

產品類別

你可以為圖片或影片指定產品類別，讓媒體在 GBP 主控台的「Photos」區塊中分類。例如，若圖片的類別為 “product”，就會出現在 Photos 中的「Product」分頁下。某些類別無法用於特定的商家類型。例如，Ayrshare 不能使用 food_and_drink，因為我們並非餐飲業。可用的類別：

cover：封面照片。每個位置只有一張封面照片。
profile：個人檔案照片。每個位置只有一張個人檔案照片。
logo：Logo 照片。
exterior：外觀媒體。
interior：內部空間媒體。
product：產品媒體。
at_work：工作情境媒體。
food_and_drink：餐飲媒體。
menu：菜單媒體。
common_area：公共區域媒體。
rooms：房間媒體。
teams：團隊媒體。

活動貼文

宣傳你的商家活動。活動貼文需要標題、開始與結束日期，並可包含影片。例如，房仲業者可以刊登看屋開放活動。

活動貼文支援行動呼籲按鈕。
可透過 mediaUrls 參數加入選擇性圖片。
活動貼文不支援影片。
活動貼文會顯示在 GBP 管理主控台的「Posts -> Events」區塊。
post 文字會作為活動詳細資訊使用。

Google Business Profile Event Post

{
  "post": "A great event!", // Event Details
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], // optional
  "gmbOptions": {
    "event": {
      "title": "Check this event out.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z" // required
    }
  }
}

優惠貼文

提供你的商家促銷或優惠。優惠貼文需要標題以及開始與結束的日期時間。系統會自動為貼文加上「View offer」行動按鈕。你也可以在貼文中加入照片、說明、優惠代碼、連結與條款細則。例如，玩具店可以刊登為期一週、所有 beanie babies 8 折的優惠。透過 mediaUrls 參數加入圖片。 優惠貼文不支援影片。 這類貼文會顯示在 GBP 管理主控台的「Posts -> Offers」區塊。

Google Business Profile Offers Post

{
  "post": "A great offer for everyone!",
  "platforms": ["gmb"],
  "gmbOptions": {
    "offer": {
      "title": "Great Sale.", // required
      "startDate": "2021-08-12T20:17:46.384Z", // required
      "endDate": "2021-09-12T20:17:46.384Z", // required
      "couponCode": "BOGO-JET-CODE", // required - max 58 characters
      "redeemOnlineUrl": "https://www.ayrshare.com", // required
      "termsConditions": "Offer only valid if you can prove you are a time traveler" // required
    }
  }
}

couponCode 最多 58 個字元。

行動呼籲

提供關於你的商家的一般資訊，並以行動按鈕的形式呈現。例如，網站可能會顯示 Learn More 按鈕，將使用者引導至其官方網站。行動呼籲按鈕可加在標準貼文或活動貼文上，優惠貼文則無法加入行動呼籲按鈕。透過 mediaUrls 參數加入圖片。

Google Business Profile Call to Action Post

{
  "post": "Take this action!",
  "platforms": ["gmb"],
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], //optional
  "gmbOptions": {
    "callToAction": {
      "actionType": "order", // required
      "url": "https://www.ayrshare.com" // required for all action types but "call"
    }
  }
}

actionType 會以按鈕的形式顯示在貼文上。可能的值有：

book：提示使用者預約、訂位或類似操作。
order：提示使用者訂購某項商品。
shop：提示使用者瀏覽產品目錄。
learn_more：提示使用者在網站上查看更多資訊。
sign_up：提示使用者註冊、加入或報名。
call：提示使用者致電商家。使用 call 時不需要 url 欄位，但你必須先在 Google Business Profile 中設定電話號碼，通話動作按鈕才會出現在貼文上。

url 參數是使用者點擊後會被導向的網址。更多 Google Business Profile 資訊。

Google Business Profile 連結

首則留言

Google Business Profile 不支援貼文留言，因此對於僅發布到 Google Business Profile 的貼文，firstComment 參數會被略過。系統會回傳一個 firstComment 的警告/略過物件，但貼文本身仍會發布成功，不會拋出錯誤。

Google Business Profile 提及

雖然你可以在 Google Business Profile 貼文中加入 @handle，但 Google Business Profile 不支援解析貼文文字中的提及。 @handle 將保持為純文字顯示。

字元限制

更多資訊請參閱 Google Business Profile 字元限制。

​發布到 Google Business Profile

​Google Business Profile 發布規範

​標準貼文（What’s New）

​圖片或影片貼文

​需求

​影片處理

​產品類別

​活動貼文

​優惠貼文

​行動呼籲

Google Business Profile 連結

​首則留言

​Google Business Profile 提及

​字元限制

發布到 Google Business Profile

Google Business Profile 發布規範

標準貼文（What’s New）

圖片或影片貼文

需求

影片處理

產品類別

活動貼文

優惠貼文

行動呼籲

首則留言

Google Business Profile 提及

字元限制