類型	說明
存取權杖	用戶
功能	不適用。
權限	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` 如果提供此權杖的用戶是透過企業管理平台獲得粉絲專頁角色，則也須具備下列任一權限：`ads_management`、`business_management` 或 `pages_read_engagement`。
任務	應用程式用戶必須能依應用程式要求的權限在粉絲專頁上執行適當的任務。

要求語法

GET https://graph.facebook.com/{ig-user-id}/tags
  ?fields={fields}
  &access_token={access-token}

查詢字串參數

加入下列查詢字串參數，以擴充要求。

索引鍵	值
`access_token` 必要字串	應用程式用戶的 Instagram 用戶存取權杖。
`fields` 逗號分隔清單	您想包含在回應中的欄位和關係連線逗號分隔清單。如果省略這項，會傳回預設欄位。

欄位

使用 fields 查詢字串參數，指定您希望傳回的 IG 影音內容物件包含哪些欄位。

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

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

關係連線

使用 fields 查詢字串參數，指定您希望傳回的 IG 影音內容物件包含哪些關係連線。

回應

包含 IG 影音內容物件的 JSON 格式物件。

{
  "{field}":"{value}",
  ...
}

分頁

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

要求範例

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

回應範例

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

更新

不支援執行此作業。

刪除