Pengguna

Mewakili profil pengguna Instagram.

ID pengguna lingkup aplikasi (ASID) telah diperkenalkan bersama API versi 11.0. Anda dapat terus menanyakan pengguna berdasarkan ID pengguna mentah mereka atau ASID yang setara, namun, panggilan versi 11.0+ akan menerima ASID sebagai tanggapan.

ASID akan menggantikan ID pengguna mentah dalam waktu sekitar dua tahun, saat versi 10.0 tidak berlaku lagi, jadi kami rekomendasikan Anda mulai memetakan pengguna aplikasi Anda ke ASID yang setara.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{user-id}

Dapatkan kolom dan edge terkait Pengguna.

Batasan

ID Pengguna API Legasi Instagram tidak didukung.

Persyaratan

Jenis	Persyaratan
Token Akses	Pengguna Instagram
Izin	`instagram_graph_user_profile`. Kolom `media_count` juga membutuhkan `instagram_graph_user_media`.

Sintaksis Permintaan

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

Parameter Jalur

Placeholder	Nilai
`{api-version}` String	Versi API.
`{user-id}` Wajib String	ID pengguna lingkup aplikasi milik pengguna aplikasi (versi 11.0+) atau ID pengguna mentah (semua versi).

Parameter String Kueri

Sertakan parameter string kueri berikut untuk ditambahkan ke permintaan.

Kunci	Nilai
`access_token` Diperlukan String	Token Akses Pengguna Instagram pengguna aplikasi.
`fields` Daftar yang dipisahkan koma	Daftar yang dipisahkan koma berisi kolom dan edge yang ingin dikembalikan. Jika tidak ada, kolom default akan dikembalikan.

Kolom

Anda dapat menggunakan parameter string kueri fields untuk meminta kolom berikut terkait Pengguna.

Nama Kolom	Deskripsi
`account_type`	Jenis akun Pengguna. Dapat berupa `BUSINESS`, `MEDIA_CREATOR`, atau `PERSONAL`.
`id`	ID pengguna lingkup aplikasi milik pengguna aplikasi (versi 11.0+) atau ID pengguna mentah (versi 10.0 ke bawah).
`media_count`	Jumlah Media pada Pengguna. Kolom ini membutuhkan izin `instagram_graph_user_media`.
`username`	Nama pengguna yang digunakan Pengguna.

Edge

Anda dapat meminta edge berikut sebagai parameter jalur atau dengan menggunakan parameter string kueri fields.

Edge	Deskripsi
`media`	Dapatkan daftar Media terkait Pengguna.

Tanggapan

Objek berformat JSON yang berisi kolom dan edge default dan yang diminta.

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

Contoh cURL

Permintaan

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

Tanggapan

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

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.