IG 容器

代表發佈 Instagram 貼文的影音素材容器。如需完整的發佈步驟,請參閱內容發佈指南。

建立

不支援執行此作業。

讀取

GET /{instagram-container-id}

取得 IG 容器的欄位關係連線

需求

類型說明

存取權杖

用戶

權限

instagram_basic
instagram_content_publish
pages_read_engagement


如果應用程式用戶是透過企業管理平台在粉絲專頁上獲得角色,也需有下列任一權限:


ads_management
business_management

要求語法

GET https://graph.facebook.com/{instagram-container-id}
  ?fields={fields}
  &access_token={access-token}

查詢字串參數

參數

access_token
必要
字串

應用程式用戶的用戶存取權杖。

fields
逗號分隔清單

您想傳回的欄位關係連線逗號分隔清單。如果省略這項,會傳回預設欄位。

欄位

欄位名稱說明

copyright_check_status

用於判定上傳的影片是否違反著作權。傳回的鍵值組包括:

  • matches_found 設為下列其中一項:
    • true – 影片違反著作權
    • false – 影片未違反著作權
  • status 設為下列其中一項:
    • completed – 偵測程序已完成
    • error – 偵測程序期間發生錯誤
    • in_progress – 偵測程序進行中
    • not_started – 偵測程序尚未開始

id

Instagram 容器編號,在程式碼範例中以 {instagram-container-id} 表示

status

發佈狀態。如果 status_codeERROR,此值將是錯誤子代碼

status_code

容器的發佈狀態。可能值:


  • EXPIRED - 容器未在 24 小時內發佈且已失效。
  • ERROR - 容器無法完成發佈程序。
  • FINISHED - 容器及其媒體物件已準備好發佈。
  • IN_PROGRESS - 容器仍在發佈程序中。
  • PUBLISHED - 容器的媒體物件已發佈。

關係連線

此節點沒有關係連線。

回應

JSON 格式物件,包含預設和要求的欄位

{
  "{field}":"{value}",
  ...
}

要求範例

curl -X GET \
  'https://graph.facebook.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

回應範例

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

更新

不支援執行此作業。

刪除

不支援執行此作業。