Instagram 平台

Instagram 留言

表示 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>

獲取 Instagram 留言上的欄位和關係連線。

限制

  • 除非要求由留言擁有者提出，否則無法對透過提及 API 發現的留言執行要求，而需改為使用提及的留言節點。
  • 系統不會傳回在設有年齡限制的影音內容上的留言。
  • 除非 Instagram 用戶不受限制且留言已獲批准，否則系統將不會傳回受應用程式用戶限制的 Instagram 用戶所建立的留言。
  • 僅在留言所在的 Instagram 影音內容正在直播時，才可讀取直播視像 Instagram 影音內容的留言。

要求語法

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>

此為必要項目。Instagram 留言編號。

查詢字串參數

鍵值預留位置值

access_token

<ACCESS_TOKEN>

此為必要項目。應用程式用戶的用戶存取憑證。

fields

<LIST_OF_FIELDS>

您希望系統傳回的 Instagram 留言欄位逗號分隔清單，當中列有結果組合中每則 Instagram 留言的欄位。

欄位

欄位名稱說明

from

物件包括：

  • id—建立 Instagram 留言的 Instagram 用戶之 Instagram 範圍編號（IGSID）。
  • from.username—建立 Instagram 留言的 Instagram 用戶之用戶名稱。

hidden

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

id

Instagram 留言編號。

like_count

Instagram 留言讚好次數。

legacy_instagram_comment_id

為 v21.0 或更舊版本的推廣 API 端點建立的 Instagram 留言編號。

media

物件包括：


parent_id

如果此留言在另一則 Instagram 留言上建立（即另一則留言的回覆），則這個代碼為其上層 Instagram 留言的編號。

replies

Instagram 留言上的回覆（Instagram 留言）之清單。

text

Instagram 留言文字。

timestamp

ISO 8601 格式的時戳，表示 Instagram 留言的建立時間。


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

user

建立 Instagram 留言的 Instagram 用戶之編號。僅在 Instagram 留言由應用程式用戶建立時傳回，否則將傳回 username 欄位。

username

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

由 2024 年 8 月 27 日起，如果您想就 Instagram 用戶對應用程式用戶 Instagram 專業帳戶的影音內容留言，存取回應者的 username 欄位，您必須具備 instagram_manage_comments 權限（如果應用程式使用 Facebook 登入功能）和 instagram_business_manage_comments 權限（如果應用程式使用 Instagram 登入功能）。

關係連線

關係連線說明

replies

獲取 Instagram 留言上的 Instagram 留言清單；在 Instagram 留言上建立 Instagram 留言。

回應

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，系統亦會一律顯示相關留言。
  • 不支援在直播視像 Instagram 影音內容上的留言。

存取憑證

收到留言的影音內容物件擁有者的用戶存取憑證。

要求範例

隱藏留言：

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

回應範例

{
  "success": true
}

刪除

刪除留言

DELETE <HOST_URL>/<IG_COMMENT_ID>

存取憑證

建立留言的用戶之用戶存取憑證。

限制

  • 即使留言建立者想刪除自己的留言，留言也只能由留言所在的物件之擁有者刪除。
  • 不支援在直播視像 Instagram 影音內容上的留言。

要求範例

DELETE graph.instagram.com
  /17873440459141021

回應範例

{
  "success": true
}