Instagram 開放平台

IG 留言

代表 IG 影音素材上的留言。

建立

不支援此作業。

讀取

GET /{ig-comment-id}?fields={fields}

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

限制

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

必備條件

類型條件

存取權杖

用戶

權限

instagram_basic
pages_read_engagement
pages_show_list


如果應用程式用戶是透過連結至目標 IG 用戶之粉絲專頁的企業管理平台獲得角色，您還需要下列其中一項：


ads_management
business_management

要求語法

GET https://graph.facebook.com/{api-version}/{ig-comment-id}
  ?fields={fields}
  &access_token={access-token}

路徑參數

預留位置值

{api-version}

API 版本。

{ig-comment-id}

必要項目。IG 留言編號。

查詢字串參數

索引鍵預留位置值

access_token

{access-token}

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

fields

{fields}

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

欄位

欄位名稱說明

from

包含以下項目的物件：


  • id - 建立 IG 留言之 Instagram 用戶的 IGSID。
  • username - 建立 IG 留言之 Instagram 用戶的用戶名稱。

hidden

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

id

IG 留言編號。

like_count

IG 留言的按讚數。

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 用戶名稱。

關係連線

關係連線說明

replies

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

回應

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

{
  "{field}":"{value}",
  ...
}

cURL 範例

要求

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

回應

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

更新

隱藏／取消隱藏留言

POST /{ig-comment-id}?hide={hide}

查詢字串參數

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

限制

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

權限

由建立留言的 Facebook 用戶提供的用戶存取權杖，具備下列權限：

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

如果此權杖的用戶是透過企業管理平台獲得粉絲專頁角色，也需有下列任一權限：

  • ads_management
  • pages_read_engagement
  • business_management

要求範例

隱藏留言：

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

回應範例

{
  "success": true
}

刪除

刪除留言

DELETE /{ig-comment-id}

權限

由建立留言的用戶提供的用戶存取權杖，具備下列權限：

  • instagram_basic
  • instagram_manage_comments

如果此權杖的用戶是透過企業管理平台獲得粉絲專頁角色，也需有下列任一權限：

  • ads_management
  • pages_read_engagement
  • business_management

限制

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

要求範例

DELETE graph.facebook.com
  /17873440459141021

回應範例

{
  "success": true
}