Instagram 容器

代表用於發佈 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>

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

要求語法

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

更新

不支援這項操作。

刪除

不支援這項操作。