用戶

代表 Instagram 用戶的個人檔案。

11.0 版本的 API 已推出應用程式範圍用戶編號 (ASID)。您可以繼續透過原始用戶編號或對應的 ASID 來查詢用戶，但 11.0 及以上版本的調用將在回應中接收 ASID。

10.0 版本大約會在兩年後停用，屆時 ASID 將取代原始用戶編號，因此我們建議您開始將您的應用程式用戶對應至其相應的 ASID。

建立

不支援這項操作。

GET /{user-id}

獲取用戶的欄位和關係連線。

不支援 Instagram 舊版 API 用戶編號。

類型	必要條件
存取憑證	Instagram 用戶
權限	`instagram_graph_user_profile`。`media_count`欄位還需要 `instagram_graph_user_media`。

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

預留位置	值
`{api-version}` 字串	API 版本。
`{user-id}` 必要項目字串	應用程式用戶的應用程式範圍用戶編號（v11.0 及以上版本）或原始用戶編號（所有版本）。

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

鍵	值
`access_token` 必要項目字串	應用程式用戶的 Instagram 用戶存取憑證。
`fields` 逗號分隔清單	您想系統傳回的欄位和關係連線逗號分隔清單。如果忽略此參數，系統將會傳回預設欄位。

您可以使用 fields 查詢字串參數，以要求獲取用戶的以下欄位。

欄位名稱	說明
`account_type`	用戶的帳戶類型。可以是 `BUSINESS`、`MEDIA_CREATOR` 或 `PERSONAL`。
`id`	應用程式用戶的應用程式範圍編號（v11.0 及以上版本）或原始用戶編號（v10.0 及以下版本）。
`media_count`	用戶的媒體數量。此欄位需要 `instagram_graph_user_media` 權限。
`username`	用戶的用戶名稱。

您能夠以路徑參數形式或使用 fields 查詢字串參數，以要求獲取以下關係連線。

關係連線	說明
`media`	獲取用戶的媒體清單。

JSON 格式的物件包含預設和要求獲取的欄位和關係連線。

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

curl -X GET \
  'https://graph.instagram.com/v21.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

不支援這項操作。

不支援這項操作。