提及的媒體

傳回特定 Instagram 媒體的數據。在此類媒體的說明文字中，某個 Instagram 用戶由另一位 Instagram 用戶以 @提及。

建立

不支援這項操作。

讀取

GET /{ig-user-id}?fields=mentioned_media.media_id

傳回特定 Instagram 媒體的數據。在此類媒體的說明文字中，某個 Instagram 用戶由另一位 Instagram 用戶以 @提及。

限制

不支援限時動態上的提及。
不支援在您獲標註的相片上留言。
如果收到留言或獲 @ 提及的影音素材是由設定為私人的帳戶所建立，則系統不會傳送 Webhooks。

必要條件

類型說明

類型	說明
存取憑證	用戶
權限	`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_media.media_id({media-id}){{fields}}
  &access_token={access-token}

查詢字串參數

參數	值
`{access_token}` 必填字串	應用程式用戶的用戶存取憑證。
`{fields}` 逗號分隔清單	您想系統傳回的 Instagram 媒體逗號分隔清單。如果忽略此參數，系統將會傳回預設欄位。
`{media-id}` 必填字串	在說明文字中以 @提及了 Instagram 用戶的 Instagram 媒體之編號。此編號包含在 Webhook 通知裝載中。

欄位

欄位	說明
`caption` 字串	說明文字。除非說明文字所在的 Instagram 媒體物件是由該應用程式用戶所建立，否則使用 @ 提及 Instagram 用戶的說明文字不會包含 `@` 符號。
`comments` 物件	Instagram 媒體的 Instagram 留言清單。如果要使用欄位擴充來獲取留言文字，除非說明文字所在的 Instagram 媒體物件是由該應用程式用戶所建立，否則使用 @ 提及 Instagram 用戶的文字不會包含 `@` 符號。
`comments_count` 字串	Instagram 媒體的 Instagram 留言數量。
`id` 預設字串	Instagram 媒體的編號。
`like_count` 字串	媒體的讚好數目。不包括相簿子媒體的讚好數目，以及使用此媒體建立的推廣帖子所獲得的讚好數目。包括對留言的回覆。 v10.0 版及以下版本的呼叫：如果媒體擁有者已隱藏讚好數目，此值將為 `0`。 v11.0 版及以上版本的呼叫：如果媒體擁有者已隱藏讚好數目，則將省略欄位；如果媒體擁有者已隱藏讚好數目，此值將為 `0`。
`media_type` 字串	Instagram 媒體的類型：`CAROUSEL_ALBUM`、`IMAGE`、`STORY` 或 `VIDEO`。
`media_url` 字串	已發佈 Instagram 媒體的網址。
`owner` 字串	建立了相應 Instagram 媒體的 Instagram 用戶之編號。僅在 Instagram 媒體物件由應用程式用戶建立時傳回，否則將傳回 `username` 欄位。
`timestamp` 字串	以 ISO 8601 格式展示的 Instagram 媒體建立日期。
`username` 字串	建立了相應 Instagram 媒體的 Instagram 用戶之用戶名稱。

要求範例

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

回應範例

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

請注意，在上述範例中，API 去除了原始說明文字（@metricsaurus headquarters!）開頭的 @ 符號，因為此說明文字並非由該應用程式用戶建立。

分頁功能

如果您使用欄位擴充來存取支援游標型分頁的關係連線，當回應包含多頁數據時，回應便將包含 before 和 after 游標。不過，有別於標準的游標型分頁，回應將不會包含 previous 或 next 欄位。因此，您將需要使用 before 和 after 游標手動建立 previous 和 next 查詢字串，以便翻頁瀏覽傳回的資料組合。

更新

不支援這項操作。

刪除

不支援這項操作。