Instagram 平台

Instagram 留言

表示 Instagram 媒體上的留言。

建立

不支援這項操作。

讀取

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

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

限制

  • 除非要求由留言擁有者提出，否則無法對透過提及 API 發現的留言執行要求。在這種情況下，請改用提及留言節點操作。
  • 系統不會傳回在設有年齡限制的媒體所作的留言。
  • 除非 Instagram 用戶不受限制且留言已獲批准，否則系統將不會傳回受應用程式用戶限制的 Instagram 用戶所建立的留言。
  • 僅在留言所在的 Instagram 媒體正在直播時，才可讀取視像直播 Instagram 媒體的留言。

必要條件

類型必要條件

存取憑證

用戶

權限

instagram_basic
pages_read_engagement
pages_show_list


如果應用程式用戶透過企業管理平台取得連結至目標 Instagram 用戶的專頁角色，您還將需要以下其中一項權限：


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}

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

查詢字串參數

鍵值預留位置值

access_token

{access-token}

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

fields

{fields}

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

欄位

欄位名稱說明

from

物件包括：


  • from.id — 建立 Instagram 留言的 Instagram 用戶之 IGSID。
  • from.username — 建立 Instagram 留言的 Instagram 用戶之用戶名稱。

hidden

表示留言是否已隱藏 (true) 或 (false)。

id

Instagram 留言編號。

like_count

Instagram 留言讚好次數。

media

物件包括：


  • id — Instagram 留言所在的 Instagram 媒體之編號。
  • media_product_type — Instagram 留言所在的 Instagram 媒體發佈平台（即 Instagram 媒體的顯示位置）。

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

關係連線

關係連線說明

replies

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

回應

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

權限

建立留言的 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

限制

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

要求範例

DELETE graph.facebook.com
  /17873440459141021

回應範例

{
  "success": true
}