ユーザー

Instagramユーザープロフィールを表します。

APIバージョン11.0で、アプリスコープのユーザーID (ASID)が導入されました。ユーザーのクエリは生のユーザーID、またはそれに相当するASIDによって引き続き実行できますが、バージョン11.0以降の呼び出しでは応答でASIDを受け取ることになります。

約2年後にバージョン10.0が廃止される時点で、生ユーザーIDに代わってASIDが使用されるようになります。アプリユーザーをそれに相当するASIDにマッピングする作業を開始するようおすすめします。

作成

この操作はサポートされていません。

GET /{user-id}

ユーザーのフィールドおよびエッジを取得します。

InstagramレガシーAPIユーザーIDはサポートされません。

型	要件
アクセストークン	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}` 必須文字列	アプリユーザーのapp-scoped user ID (バージョン11.0以降)または生ユーザーID (すべてのバージョン)。

リクエストに以下のクエリ文字列パラメーターを追加します。

キー	値
`access_token` 必須文字列	アプリユーザーのInstagramユーザーアクセストークン。
`fields` コンマ区切りリスト	結果として返すフィールドとエッジのコンマ区切りリスト。省略した場合、デフォルトのフィールドが返されます。

ユーザーの以下のフィールドをリクエストするには、fieldsクエリ文字列パラメーターを使用することができます。

フィールド名	説明
`account_type`	ユーザーのアカウントのタイプ。`BUSINESS`、`MEDIA_CREATOR`、または`PERSONAL`を指定できます。
`id`	アプリユーザーのapp-scoped ID (バージョン11.0以降)または生ユーザーID (バージョン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"
}

この操作はサポートされていません。

この操作はサポートされていません。