Instagram 容器

代表用於發佈 Instagram 帖子的媒體容器。請參閱內容發佈指南,了解完整的發佈步驟。

建立

不支援這項操作。

讀取

GET /{instagram-container-id}

獲取 Instagram 容器上的欄位關係連線

必要條件

類型說明

存取憑證

用戶

權限

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"
}

更新

不支援這項操作。

刪除

不支援這項操作。