Instagram 用戶提及的留言

傳回特定 Instagram 留言的數據，而這個留言建立在特定 Instagram 用戶被另一位 Instagram 用戶以 @提及的內容之上。

建立

不支援這項操作。

讀取

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

傳回特定 Instagram 留言的數據，而這個留言建立在特定 Instagram 用戶被另一位 Instagram 用戶以 @提及的內容之上。

限制

如果以 @提及了 Instagram 用戶的 Instagram 媒體之留言功能被停用，此端點將會傳回錯誤。

必要條件

類型說明

類型	說明
存取憑證	用戶
權限	`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}` 必填字串	以 @提及了 Instagram 用戶的 Instagram 留言之編號。此編號包含在 Webhook 通知承載中。
`{fields}` 逗號分隔清單	您想系統傳回的 Instagram 留言欄位逗號分隔清單。如果忽略此參數，則系統會傳回預設欄位。

欄位

欄位	說明
`id` 預設字串	Instagram 留言的編號。
`like_count` 字串	Instagram 留言的讚好次數。
`media` 字串	Instagram 留言所在的 Instagram 媒體之編號。請使用欄位擴充以就傳回的 Instagram 媒體條目獲取其他欄位。
`text` 預設字串	Instagram 留言的文字。
`timestamp` 預設字串	以符合 ISO 8601 的格式表示 Instagram 留言的建立日期。

回應

要求範例

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"
}

欄位擴充

您可以借助 Instagram 媒體欄位清單來擴充 media 欄位，以就留言所在的 Instagram 媒體條目獲取其他數據。例如：

media{id,media_url}

在 2021 年 9 月 7 日前，針對 10.0 版和更舊版本的調用：如果影音素材擁有者已隱藏相關內容的讚好次數，Instagram 影音素材的 like_count 欄位將傳回 0。

在 2021 年 9 月 7 日前，針對 11.0 及以上版本的調用和所有版本：如果透過另一個端點或欄位擴充間接查詢 Instagram 影音素材，而且影音素材擁有者已隱藏相關內容的讚好次數，API 回應將省略 like_count 欄位。若是直接查詢 Instagram （只能由 Instagram 影音素材擁有者提出），即使擁有者隱藏了影音素材的讚好次數，系統仍會傳回實際的讚好次數。

欄位擴充要求範例

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 查詢字串，以便翻頁瀏覽傳回的資料組合。

更新

不支援這項操作。

刪除

不支援這項操作。