Instagram Graph API

Instagram 用戶媒體發佈

在 Instagram Business 的 Instagram 用戶上發佈 Instagram 容器。請參閱內容發佈指南，了解完整的發佈步驟。

建立

POST /{ig-user-id}/media_publish

在 Instagram Business 的 Instagram 用戶上發佈 Instagram 容器物件。

限制

  • Instagram 帳戶只可在 24 小時流動週期內透過 API 發佈 25 則帖子。
  • 如果與目標 Instagram 商業帳戶連結的專頁需要專頁發佈授權 (PPA)，則必須完成此授權，否則要求將會失敗。
  • 如果與目標 Instagram 商業帳戶連結的專頁需要雙重驗證，則 Facebook 用戶亦必須已執行雙重驗證，否則要求將會失敗。
  • 不支援發佈至 Instagram TV。

必要條件

類型說明

存取憑證

用戶

企業角色

如要發佈商品標註容器，應用程式用戶必須在擁有此 Instagram 用戶 Instagram 商店的企業管理平台上，取得管理員角色。

Instagram 商店

如要發佈商品標註容器，Instagram 用戶必須擁有已獲批准的 Instagram 商店，以及包含商品的商品目錄。

權限

instagram_basic
instagram_content_publish
pages_read_engagement 或 pages_show_list


如果應用程式用戶透過企業管理平台取得專頁角色，您還將需要以下其中一項：


ads_management
business_management


如要發佈商品標註容器，您還需要以下權限：


catalog_management
instagram_shopping_tag_products

任務

在要求中使用了憑證的應用程式用戶必須能夠在與目標 Instagram 帳戶連結的專頁上執行 MANAGE 和 CREATE_CONTENT 任務。

要求語法

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media_publish
  ?creation_id={creation-id}
  &access_token={access-token}

路徑參數

預留位置值

{api-version}
字串

API 版本。

{ig-user-id}
必要項目
字串

應用程式用戶的應用程式範圍用戶編號。

查詢字串參數

鍵值預留位置說明

access_token

必要項目

{access-token}

應用程式用戶的用戶存取憑證。

creation_id

必要項目

{creation-id}

要發佈的 Instagram 容器之編號。

要求範例

POST graph.facebook.com
  /17841405822304914/media_publish
    ?creation_id=17889455560051444

回應範例

{
  "id": "17920238422030506"
}

讀取

不支援這項操作。

更新

不支援這項操作。

刪除

不支援這項操作。