Skip to main content
PATCH
更新使用者
更新社群網路的帳號或使用者資料。目前支援 Google Business Profile 和 WhatsApp。
Google 限制某些 Google Business Profile 地點欄位在 24 小時滾動期間內最多只能更新 5 次。例如,若 phoneNumbers 在 24 小時滾動期間內更新超過 5 次,將會回傳 400 錯誤。此限制僅適用於 Google Business Profile,不適用於 WhatsApp。

標頭參數

路徑參數

string
必填
值:gbp、whatsapp

Body 參數

object
包含客戶可用來聯繫商家的各種電話號碼的物件。
string
此地點的 Google 識別碼。
string
用於 AdWords 地點擴充功能顯示的替代電話號碼,取代該地點的主要電話號碼。
string
此地點的外部識別碼,在指定的帳號中必須唯一。用於將該地點與你自己的紀錄關聯起來。
string
地點名稱應反映商家在真實世界中的名稱,並與店面、網站、文具用品上一致,也是客戶所熟知的名稱。
string
此商家的 URL。
array
一組自由格式的字串,可用來為你的商家加上標籤。這些標籤不對外顯示,僅你自己看得見。每個標籤必須介於 1-255 字元。
object
代表一組經緯度的物件。以一對雙精度浮點數表示緯度與經度(單位為度)。除非另有說明,此物件必須遵循 WGS84 標準。
數值必須位於標準化範圍內。緯度(度),必須介於 [-90.0, +90.0]。經度(度),必須介於 [-180.0, +180.0]。
object
此欄位包含以你自己口吻撰寫的地點描述,其他人無法編輯。

WhatsApp

WhatsApp 處於 Private Beta 階段。 更新 WhatsApp 商家檔案需要已核准使用 WhatsApp 的帳號。若你想搶先取得使用權限,請寄信至 lotty@ayrshare.com。
只需傳送你想變更的欄位。至少需要一個欄位,且傳送此端點無法辨識的欄位會導致整個請求被拒絕。 若要清除某個欄位,請將其以空字串傳送:{"description": ""} 會移除描述,該欄位之後就完全不會再出現在商家檔案中。此做法適用於 description、address 與 email。但不適用於 about,因為 WhatsApp 要求它至少要有一個字元——若要變更它,請直接覆寫。vertical 一旦設定後也無法清除。 回應欄位 messaging_product 與 profile_picture_url(請參閱 WhatsApp 商家檔案)為唯讀:傳回其中任一者都會被視為無法辨識的欄位而拒絕。請使用 profilePictureUrl 設定相片。
string
顯示在商家檔案圖片下方的文字。1-139 字元。這是唯一一個 WhatsApp 不允許清除的文字欄位——請改以覆寫方式變更。
string
商家描述。最多 512 字元。傳送 "" 可清除。
string
商家地址。最多 256 字元。傳送 "" 可清除。
string
聯絡用電子郵件地址。最多 128 字元,且除非你是傳送 "" 來清除它,否則必須是有效的地址。
array
一個非空陣列,最多 2 個 URL,每個都必須以 http:// 或 https:// 開頭。
string
商家類別。WhatsApp 目前接受:OTHER、AUTO、BEAUTY、APPAREL、 EDU、ENTERTAIN、EVENT_PLAN、FINANCE、GROCERY、GOVT、HOTEL、HEALTH、 NONPROFIT、PROF_SERVICES、RETAIL、TRAVEL、RESTAURANT、ALCOHOL、 ONLINE_GAMBLING、PHYSICAL_GAMBLING、OTC_DRUGS、MATRIMONY_SERVICE。此清單由 WhatsApp 制定,且可能隨時間增加——Ayrshare 不會限制此值,因此任何 WhatsApp 接受的類別都可使用。值會被正規化為大寫,因此以 retail 傳送的值會以 RETAIL 回傳。WhatsApp 不允許在類別設定後再清除它,並會拒絕它不接受的值——該拒絕會以 101 回傳,並附上 WhatsApp 自身的訊息,列出目前接受的值。
string
可公開存取的 JPEG 或 PNG,5 MB 或更小。圖片必須為正方形且至少 192×192——建議使用 640×640。沒有最大解析度限制:較大的圖片會被接受並由 WhatsApp 縮小。不是正方形或低於 192×192 的圖片,會在任何內容送至 WhatsApp 之前,以指出問題的 400 拒絕。完整需求請參閱 WhatsApp 媒體規範。