Instagram 平台

協作者

代表獲加為 Instagram 媒體物件協作者的用戶名單。

適用於 Facebook 登入 Instagram API。

建立

不支援這項操作。

讀取

獲取 Instagram 媒體物件上為協作者的 Instagram 用戶名單及其邀請狀態。

GET /<IG_MEDIA_ID>

限制

  • 最多可將 5 個 Instagram 帳戶加為協作者
  • 回應只會傳回已啟用協作者標註功能的 Instagram 用戶
  • 協作者標註功能支援動態消息圖片、Reels 和輪播內容，不支援限時動態

必要條件

類型說明

存取憑證

用戶：用戶必須已建立 Instagram 媒體物件

權限

instagram_basic
pages_read_engagement

如果應用程式用戶透過企業管理平台在專頁上獲授予角色，您還將需要以下權限之一：

ads_management
ads_read

要求語法

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/collaborators&<USER_ACCESS_TOKEN>

回應範例

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    }
  ]
}

路徑參數

預留位置值

<API_VERSION>

API 版本。

<IG_MEDIA_ID>

此為必要項目。應用程式用戶 Instagram 媒體的編號。

查詢字串參數

鍵值預留位置值

access_token

<USER_ACCESS_TOKEN>

此為必要項目。應用程式用戶的用戶存取憑證。

回應欄位

欄位名稱說明

id

潛在協作者 Instagram 帳戶的應用程式範圍編號

invite_status

傳送給潛在協作者的邀請之狀態，可以是下列其中一項：

  • Accepted
  • Pending

username

潛在協作者的 Instagram 個人檔案用戶名稱

更新

不支援這項操作。

刪除

不支援這項操作。