提及的影音內容

傳回一項 IG 影音內容的相關資料，其中某位 Instagram 用戶在影音內容描述中加註 @ 提及另一位 IG 用戶。

建立

不支援執行此作業。

讀取

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

傳回一項 IG 影音內容的相關資料，其中有某位 Instagram 用戶在影音內容描述中加註 @ 提及另一位 IG 用戶。

限制

不支援限時動態的提及功能。
不支援在標註了您的相片上留言。
如果顯示留言或提及內容的影音內容是由設為不公開的帳號所建立，系統不會傳送 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}` 逗號分隔清單	您想傳回的 IG 影音內容欄位逗號分隔清單。如果省略這項，會傳回預設欄位。
`{media-id}` 必要字串	描述中加註 @ 提及某位 IG 用戶的 IG 影音內容編號。這個編號包含在 Webhook 通知承載中。

欄位

欄位	說明
`caption` 字串	描述文字。除非應用程式用戶依據所產生的描述建立 IG 影音內容物件，否則提及 IG 用戶的描述並不會包含 `@` 符號。
`comments` 物件	IG 影音內容的 IG 留言清單。在使用欄位擴充功能取得留言文字的情況下，除非應用程式用戶依據所產生的描述建立 IG 影音內容物件，否則提及 IG 用戶的文字並不會包含 `@` 符號。
`comments_count` 字串	IG 影音內容的 IG 留言數。
`id` 預設字串	IG 影音內容的編號。
`like_count` 字串	影音內容的按讚次數。不含相簿子影音內容的按讚次數，也不含以影音內容製作之推廣貼文的按讚次數。包含對留言的回覆次數。 10.0 和更舊版本：如果影音素材擁有者已隱藏按讚數，值會顯示 `0`。 11.0 或更新版本：如果影音內容擁有者已隱藏其中的按讚數，將會省略欄位。如果影音內容擁有者已隱藏按讚數，值會顯示 `0`。
`media_type` 字串	IG 影音內容的類型包括：`CAROUSEL_ALBUM`、`IMAGE`、`STORY` 或 `VIDEO`。
`media_url` 字串	已發佈 IG 影音內容的網址。
`owner` 字串	建立 IG 影音內容的 IG 用戶編號。只會在應用程式用戶建立了 IG 影音內容物件的情況下傳回，若非如此，就會傳回 `username` 欄位。
`timestamp` 字串	IG 影音內容的建立日期，格式為 ISO 8601。
`username` 字串	建立 IG 影音內容之 IG 用戶的用戶名稱。

要求範例

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 查詢字串，才能將傳回的資料集分頁。

更新

不支援執行此作業。

刪除

不支援執行此作業。