用戶

代表 Instagram 使用者個人檔案。

應用程式範圍用戶編號（ASID）已經與 API 11.0 版一起推出。您可以透過用戶的原始用戶編號或等同的 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}` 必要字串	應用程式用戶的應用程式範圍用戶編號（11.0 以上版本）或原始用戶編號（所有版本）。

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

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

您可用 fields 查詢字串參數要求用戶的下列欄位。

欄位名稱	說明
`account_type`	使用者的帳號類型。可為 `BUSINESS`、`MEDIA_CREATOR` 或 `PERSONAL`。
`id`	應用程式用戶的應用程式範圍用戶編號（11.0 以上版本）或原始用戶編號（10.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"
}

不支援執行此作業。

不支援執行此作業。