Instagram(IG)容器

代表發佈 Instagram 影音素材物件的影音素材容器。

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

建立

不支援執行此作業。

讀取

GET <HOST_URL>/<IG_CONTAINER_ID>

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

要求語法

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

查詢字串參數

參數

access_token
必要
字串

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

fields
逗號分隔清單

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

欄位

欄位名稱說明

copyright_check_status

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

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

id

Instagram 容器編號,在程式碼範例中以 <IG_CONTAINER_ID> 表示

status

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

status_code

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


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

關係連線

此節點沒有關係連線。

回應

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

{
  "<FIELD>":"<VALUE>",
  ...
}

要求範例

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

回應範例

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

更新

不支援執行此作業。

刪除

不支援執行此作業。