Instagram 開放平台

Instagram（IG）留言

代表 Instagram 影音素材物件上的留言。

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

新推出下列欄位：

  • legacy_instagram_comment_id

不支援下列欄位：

  • comment_type
  • mentioned_instagram_users

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram 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_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • 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_COMMENT_ID>?fields=<LIST_OF_FIELDS>

取得 IG 留言的欄位和關係連線。

限制

  • 除非留言擁有者提出要求，否則無法對透過 Mentions API 發現的留言執行要求。或者，您可以改用提及的留言節點。
  • 不會傳回經年齡審核媒體的留言。
  • 不會傳回受到應用程式用戶限制的 IG 用戶建立的留言，除非 IG 用戶解除限制且留言通過批准。
  • 只有當留言發表處所在 IG 影音素材正在進行直播，您才能讀取直播影片 IG 影音素材的留言。

要求語法

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

路徑參數

預留位置值

<API_VERSION>

API 版本。

<HOST_URL>

API 版本。

<IG_COMMENT_ID>

必要項目。IG 留言編號。

查詢字串參數

索引鍵預留位置值

access_token

<ACCESS_TOKEN>

必要項目。應用程式用戶的用戶存取權杖。

fields

<LIST_OF_FIELDS>

在結果集中，您想傳回的每個 IG 留言之 IG 留言欄位的逗號分隔清單。

欄位

欄位名稱說明

from

包含以下項目的物件：

hidden

表示留言是（true）否（false）已隱藏。

id

IG 留言編號。

like_count

IG 留言的按讚數。

legacy_instagram_comment_id

為 21.0 和以下版本行銷 API 端點建立的 Instagram 留言編號。

media

包含以下項目的物件：


  • id - IG 留言發表處所在 IG 影音素材的編號。
  • media_product_type - IG 留言發表處所在 IG 影音素材的發佈介面（即 IG 影音素材出現的地方）。

parent_id

若此留言建立在另一個 IG 留言上（即回覆另一個留言），此為父系 IG 留言的編號。

replies

IG 留言的回覆次數（IG 留言次數）清單。

text

IG 留言文字。

timestamp

ISO 8601 格式的時間戳記，用來表示 IG 留言建立的時間。


範例：2017-05-19T23:27:28+0000。

user

建立 IG 留言的 IG 用戶編號。只會在應用程式用戶建立了 IG 留言的情況下傳回，若非如此，就會傳回 username。

username

建立 IG 留言之 Instagram 用戶的用戶名稱。

自 2024 年 8 月 27 日起，若 Instagram 用戶在應用程式用戶的 Instagram 專業帳號之影音素材上留言，而您想要存取其 username 欄位時，將需要 instagram_manage_comments 權限（如果您的應用程式使用 Facebook 登入）和 instagram_business_manage_comments 權限（如果您的應用程式使用 Instagram 登入）。

關係連線

關係連線說明

replies

取得 IG 留言的 IG 留言次數清單；建立 IG 留言的 IG 留言次數。

回應

JSON 格式物件，包含預設和要求的欄位和關係連線。

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

cURL 範例

要求

curl -i -X GET \
 "https://graph.instagram.com/v25.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

回應

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

更新

隱藏／取消隱藏留言

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

查詢字串參數

  • {hide}（必要）- 設定為 true 以隱藏留言，或設定為 false 以顯示留言。

限制

  • 媒體物件擁有者對自己媒體物件的留言，一律都會顯示，即使留言已設定為 hide=true 亦同。
  • 不支援直播影片 IG 影音素材的留言。

存取權杖

來自用戶的用戶存取權杖，該用戶擁有獲留言的媒體物件。

要求範例

隱藏留言：

POST graph.instagram.com
  /17873440459141021?hide=true

回應範例

{
  "success": true
}

刪除

刪除留言

DELETE <HOST_URL>/<IG_COMMENT_ID>

存取權杖

由建立留言的用戶提供的用戶存取權杖。

限制

  • 留言只能由在其上建立留言之物件的擁有者刪除，即使是留言的作者也無法刪除。
  • 不支援直播影片 IG 影音素材的留言。

要求範例

DELETE graph.instagram.com
  /17873440459141021

回應範例

{
  "success": true
}