類型	說明
存取憑證	用戶
功能	不適用。
權限	`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 查詢字串參數，以指定您希望在任何傳回的 Instagram 媒體物件中包含的欄位。

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

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

關係連線

使用 fields 查詢字串參數，以指定您希望在任何傳回的 Instagram 媒體物件中包含的關係連線。

回應

包含 Instagram 媒體物件的 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..."
    }
  ]
}

更新

不支援這項操作。

刪除