IG 主題標籤最相關影音內容

代表最熱門且已標註主題標籤的相片和影片 IG 影音素材物件精選集。

熱門程度取決於瀏覽次數和瀏覽者互動的綜合結果，所用方法與在 www.instagram.com 搜尋主題標籤時決定最相關貼文所採的標準相同。

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

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

建立

不支援執行此作業。

讀取

取得最熱門的主題標籤影音內容

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

傳回已標註主題標籤的最熱門相片和影片 IG 影音內容物件。

查詢字串參數

{user_id}（必要）— 執行查詢的 Instagram 商業帳號或創作者帳號的編號。
{fields} — 您想傳回的欄位逗號分隔清單。請參閱可回傳欄位。

限制

此關係連線只會傳回公開相片和影片。
不會傳回推廣／加強推廣／廣告影音內容。
回應會採分頁處理，每頁最大 limit 為 50 筆結果。
您可以查詢 7 天內最多 30 個不重複的主題標籤。
您不能要求傳回影音內容物件的 username 欄位。
此端點只會傳回分頁結果的 after 游標；不包含 before 游標。此外，每頁的 after 游標值一律相同，但仍可用於取得結果集中下一頁的結果。

必備條件

類型說明

類型	說明
功能	`Instagram Public Content Access`
權限	`instagram_basic` 如果此權杖的用戶是透過企業管理平台得到粉絲專頁角色，也需有下列其中一項權限：`ads_management`、`business_management` 或 `pages_read_engagement`。
權杖	已獲准在已連結 Facebook 粉絲專頁執行任務之 Facebook 用戶的用戶存取權杖。

功能

Instagram Public Content Access

權限

instagram_basic

如果此權杖的用戶是透過企業管理平台得到粉絲專頁角色，也需有下列其中一項權限：ads_management、business_management 或 pages_read_engagement。

權杖

已獲准在已連結 Facebook 粉絲專頁執行任務之 Facebook 用戶的用戶存取權杖。

回應

IG 影音內容物件陣列。超出數量範圍的結果會以分頁顯示。

可回傳欄位

您可以使用 fields 參數要求回傳影音內容物件的下列欄位：

caption
children（只會傳回 IG 影音內容相簿）
comments_count
id
like_count（10.0 版及更早的呼叫：如果影音素材擁有者已隱藏按讚計數，則值將為 0。11.0 及以上版本呼叫：如果影音素材擁有者已隱藏按讚計數，則會省略欄位。）
media_type
media_url（不會傳回 IG 影音內容相簿）
permalink
timestamp（只適用於 7.0 或更新版本）

要求範例

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

回應範例

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

更新

不支援執行此作業。

刪除

不支援執行此作業。