登入開始免費試用
easyCoexistence 官方 API

透過 API 為 Instagram 貼文標記人物並加入地點

Instagram 的 API 會在媒體容器發布前,於其上設定 user_tags 以標記人物,以及 location_id 以加入地點。user_tags 列出公開的用戶名稱;在圖片上必須提供 x 與 y 座標,範圍為 0.0 至 1.0。Meta 說明此功能適用於圖片、影片與限時動態。location_id 接受透過 Pages Search API 找到、且具有地點資料的 Page ID。

easyCoexistence 可透過 Claude、ChatGPT 或你自己的程式碼,使用 publish_instagram_post 發布相片、輪播、Reels 與限時動態。

0.0 to 1.0

user_tags 中 x 與 y 座標的範圍,從圖片的左邊緣與上邊緣量度。

Images

user_tags 須提供 x 與 y 的情況;限時動態上兩者為選填,且僅適用於圖片與限時動態。

Carousels

Meta 的媒體參考指出,輪播中的圖片或影片不支援 location_id。

USER_TAGGING_FAILURE

媒體發布時未附帶用戶標記所返回的 config_issue 值,Meta 稱之為部分成功。

13 Mar 2018

Meta 先向測試合作夥伴開放,允許在透過 API 發布的相片中標記地點與公開的 Instagram 用戶。

如何在貼文中標記人物?

在容器加入 user_tags。它是一個物件陣列,每個物件包含公開 Instagram 帳戶的 username,若為圖片,還需提供 x 與 y,即以 0.0 至 1.0 之間的浮點數表示標記位置與左邊緣及上邊緣的距離。地點則在同一次呼叫中放入 location_id,之後照常以 media_publish 發布該容器。

An image container with a user tag and a location
POST /<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/team.jpg",
  "caption": "<CAPTION>",
  "user_tags": [
    { "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
  ],
  "location_id": "<PAGE_ID>"
}

哪些貼文可以使用用戶標記及地點?

Meta 的媒體參考說明 user_tags 適用於圖片、影片與限時動態;x 與 y 只適用於圖片與限時動態,並列出各容器接受的參數。在輪播中,地點須加在輪播容器上,因為 location_id 不支援輪播內的圖片或影片:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

如何找到 location_id?

搜尋 Page。location_id 是與某地點相關聯的 Page 之 ID。Meta 的參考指向 Pages Search API,即 GET /pages/search,參數為 q 與 fields=id,name,location,然後檢查所選 Page 是否具有地點資料。沒有地點資料的 Page 會失敗,並返回 INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID。搜尋透過 Meta Graph API 進行,使用你自己的 Meta 應用程式權杖:用戶權杖,或若只需公開的 Page 資訊,則使用具備 Page Public Metadata Access 功能的應用程式權杖。

Searching for a Page with a location
GET /pages/search
  ?q=<PLACE_NAME>
  &fields=id,name,location
  &access_token=<ACCESS_TOKEN>

標記未能成功附加時會怎樣?

貼文仍可正常發布。media_publish 隨後會返回 config_issue,其值為 USER_TAGGING_FAILURE,表示媒體已發布但沒有附帶用戶標記。Meta 稱此為部分成功,並要求應用程式將其視為需要核對的訊號,而非錯誤,因為媒體 ID 仍然有效;若再次發布,會建立第二則貼文。

user_tags 可以與 Instagram Login 一起使用嗎?

Meta 的媒體參考把 user_tags 與 location_id 列為建立容器時可用的參數,但沒有將其綁定於某一種登入方式。不過,其「使用 Instagram Login 的 Instagram API」頁面表示,該設定無法存取廣告或標記功能,卻沒有說明指的是哪種標記。在使用 Instagram Login 依賴任一參數之前,請先發布測試貼文,並檢查回應及貼文本身。

如何透過 easyCoexistence 標記人物?

目前還不能。publish_instagram_post 會自行建立容器,不接受 user_tags 或 location_id,而且 Instagram 權杖不會交出供你自行呼叫。請先以 publish_instagram_post 發布貼文,再於 Instagram 應用程式中,從貼文的編輯選項加入標記和地點。

常見錯誤

  • 圖片標記漏寫 x 與 y。Meta 要求圖片必須提供兩者,只有限時動態可以省略。
  • 以像素或百分比提供座標。x 與 y 是 0.0 至 1.0 的浮點數,從左邊緣與上邊緣量度。
  • 在輪播項目上設定 location_id。Meta 不支援輪播內的圖片或影片使用此參數。
  • 標記私人帳戶。user_tags 只接受公開 Instagram 帳戶的用戶名稱。
使用 EasyCoexistence 完成這項設定

該工具不接受 user_tags 或 location_id,因此人物和地點須在 Instagram 應用程式中,從貼文的編輯選項標記。每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費。

常見問題

能否透過 API 標記私人 Instagram 帳戶?

不能。Meta 的媒體參考說明 user_tags 只接受公開 Instagram 帳戶的用戶名稱,因此私人帳戶無法以此方式標記。

一則貼文最多可以標記多少人?

Meta 的 user_tags 參考未列出上限。其所列的 20 個上限,適用於說明文字中的 @ 標記。

能否透過 API 為限時動態加入地點?

不是。Meta 的限時動態容器語法列出 user_tags,但未列出 location_id。

能否標記產品而非人物?

產品標記是獨立功能。Meta 的概覽列明其支援 Facebook Login 與 Unified Login,但不支援 Instagram Login。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期