提及 IG 用戶的留言

傳回一則 IG 留言的資料，有某位 Instagram 用戶在這則留言中加註 @ 提及另一位 IG 用戶。

建立

不支援執行此作業。

讀取

GET /{ig-user-id}?fields=mentioned_comment.comment_id

傳回一則 IG 留言的資料，有某位 Instagram 用戶在這則留言中加註 @ 提及另一位 IG 用戶。

限制

如果加註 @ 提及某位 IG 用戶的 IG 影音內容已停用留言功能，則這個端點會傳回錯誤。

需求

類型說明

類型	說明
存取權杖	用戶
權限	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` 如果應用程式用戶是透過企業管理平台在粉絲專頁上獲得角色，您還需要下列其中一項： `ads_management` `business_management`
任務	`MANAGE`、`CREATE_CONTENT` 或 `MODERATE`

存取權杖

用戶

權限

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list

如果應用程式用戶是透過企業管理平台在粉絲專頁上獲得角色，您還需要下列其中一項：

ads_management
business_management

任務

MANAGE、CREATE_CONTENT 或 MODERATE

要求語法

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_comment.comment_id({comment-id}){{fields}}
  &access_token={access-token}

查詢字串參數

參數	值
`{access_token}` 必要字串	應用程式用戶的用戶存取權杖。
`{comment-id}` 必要字串	加註 @ 提及某位 IG 用戶的 IG 留言編號。這個編號包含在 Webhook 通知承載中。
`{fields}` 逗號分隔清單	您想傳回的 IG 留言欄位逗號分隔清單。如果省略，將傳回預設欄位。

欄位

欄位	說明
`id` 預設字串	IG 留言的編號。
`like_count` 字串	IG 留言的按讚次數。
`media` 字串	IG 留言發表處所在 IG 影音內容的編號。請使用欄位擴充功能取得所傳回 IG 影音內容項目的其他欄位。
`text` 預設字串	IG 留言的文字。
`timestamp` 預設字串	IG 留言的建立日期，格式為 ISO 8601。

回應

要求範例

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,id}&access_token=IGQVJ...'

回應範例

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

欄位擴充

您可以使用 IG 影音內容欄位清單擴充 media 欄位，用於取得留言發表處所在 IG 影音內容項目的其他資料。例如：

media{id,media_url}

直到 2021 年 9 月 7 日的 10.0 及以上版本呼叫：IG 影音內容的 like_count 欄位若遇到下列情況會傳回 0：影音內容擁有者已隱藏按讚數。

11.0 以上版本呼叫和在 2021 年 9 月 7 日的所有版本：如果透過另一個端點或欄位擴充功能間接查詢 IG 影音內容，當影音內容擁有者已隱藏按讚數時，系統將會省略 API 回應中的 like_count 欄位。不過，即使已隱藏影音內容的按讚數，直接查詢 IG 影音內容（只能由 IG 影音內容擁有者執行）仍會傳回實際按讚數。

欄位擴充要求範例

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_comment.comment_id(17873440459141021){timestamp,like_count,text,media{id,media_url}}&access_token=IGQVJ...'

欄位擴充回應範例

{
  "mentioned_comment": {
    "timestamp": "2017-05-03T16:09:08+0000",
    "like_count": 185,
    "text": "Shout out to @metricsaurus",
    "id": "17873440459141021",
    "media": {
      "id": "17895695668004550",
      "media_url": "https://scont..."
    }
  },
  "id": "17841405309211844"
}

分頁

如果您使用欄位擴充存取支援游標型分頁的關係連線，因此在回應含多頁資料的情況下，回應會包含 before 和 after 游標。但與標準游標分頁不同的是，回應不會包含 previous 或 next 欄位，因此您必須使用 before 和 after 游標手動建構 previous 和 next 查詢字串，才能將傳回的資料集分頁。

更新

不支援執行此作業。

刪除

不支援執行此作業。