Pengguna Instagram

Mewakili Akun Bisnis Instagram atau Akun Kreator Instagram.

Di seluruh dokumentasi kami, kami menggunakan "Pengguna Instagram" dan "Akun Instagram" dengan makna yang sama. Keduanya mewakili akun profesional Instagram pengguna aplikasi Anda.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

Membuat

Operasi ini tidak didukung.

Membaca

GET /<IG_USER_ID>

Mendapatkan kolom dan edge pada Akun Instagram Business atau Creator.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Sintaks Permintaan

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parameter Jalur

Placeholder	Nilai
`<API_VERSION>`	Versi API.
`<IG_USER_ID>`	Wajib. ID Pengguna Instagram.

Parameter String Kueri

Kode	Placeholder	Nilai
`access_token`	`<ACCESS_TOKEN>`	Wajib. Token akses Pengguna aplikasi.
`fields`	`<LIST_OF_FIELDS>`	Kolom di daftar pengguna Instagram yang dipisahkan koma yang Anda ingin ditampilkan untuk setiap pengguna Instagram dalam set hasil.

Kolom

Kolom publik dapat ditampilkan oleh edge menggunakan perluasan kolom. Hanya beberapa kolom yang akan tersedia untuk mengakses Akun Instagram yang didukung halaman.

Nama Kolom	Deskripsi
`alt_text` Publik	Teks deskriptif untuk gambar, untuk aksesibilitas.
`biography` Publik	Teks bio profil.
`followers_count` Publik	Jumlah total pengguna Instagram yang mengikuti pengguna.
`follows_count`	Jumlah total pengguna Instagram yang diikuti oleh pengguna.
`has_profile_pic`	Menunjukkan apakah akun Instagram profesional pengguna aplikasi Anda memiliki gambar profil.
`id` Publik	ID Pengguna lingkup aplikasi. Tersedia untuk akun Instagram yang didukung halaman.
`is_published`	Menunjukkan apakah akun Instagram pengguna aplikasi Anda diterbitkan. Tersedia untuk akun Instagram yang didukung halaman.
`legacy_instagram_user_id`	ID Instagram pengguna aplikasi yang dibuat untuk endpoint Marketing API untuk v21.0 dan sebelumnya. Tersedia untuk akun Instagram yang didukung halaman.
`media_count` Publik	Jumlah total Media Instagram yang diterbitkan pada akun pengguna aplikasi Anda.
`name`	Nama profil Instagram pengguna aplikasi Anda.
`profile_picture_url`	URL foto profil Instagram pengguna aplikasi Anda.
`collaborative_media_search`	Mencari media kolaboratif tertentu berdasarkan ID. Akses melalui perluasan kolom. Tersedia untuk Instagram API dengan Facebook Login saja.
`shopping_product_tag_eligibility`	Menampilkan `true` jika pengguna aplikasi Anda telah menyiapkan Toko Instagram sehingga memenuhi syarat untuk pelabelan produk. Jika tidak, akan menampilkan `false`.
`username` Publik	Nama pengguna Instagram pengguna aplikasi Anda.
`website` Publik	URL situs web pengguna aplikasi Anda.

Edge

Edge	Deskripsi
`agencies`	Daftar bisnis yang dapat mengiklankan akun profesional Instagram ini.
`authorized_adaccounts`	Akun iklan yang dapat mengiklankan akun profesional Instagram ini.
`business_discovery`	Mendapatkan data tentang Pengguna Instagram Business atau Kreator Instagram lainnya.
`connected_threads_user`	Mewakili akun Threads yang terhubung ke akun Instagram.
`content_publishing_limit`	Menunjukkan penggunaan penerbitan konten saat ini milik Pengguna Instagram.
`insights`	Mewakili metrik interaksi sosial pada Pengguna Instagram.
`instagram_backed_threads_user`	Mewakili akun Threads yang didukung oleh akun Instagram.
`live_media`	Menunjukkan koleksi Media Instagram video siaran langsung Pengguna Instagram.
`media`	Mewakili koleksi Media Instagram tentang Pengguna Instagram.
`media_publish`	Menerbitkan Kontainer Instagram pada Pengguna Instagram Bisnis Instagram.
`mentions`	Membuat Komentar Instagram di suatu Komentar Instagram atau memberi keterangan di Media Instagram tempat Pengguna Instagram telah @disebut oleh pengguna Instagram lainnya.
`mentioned_comment`	Mendapatkan data Komentar Instagram tempat Pengguna Instagram telah @disebut oleh pengguna Instagram lain.
`mentioned_media`	Mendapatkan data Media Instagram tempat Pengguna Instagram telah @disebut dalam keterangan oleh pengguna Instagram lain.
`recently_searched_hashtags`	Dapatkan Tagar Instagram yang telah dicari Pengguna Instagram dalam 7 hari terakhir.
`stories`	Menunjukkan koleksi cerita objek Media Instagram Pengguna Instagram.
`tags`	Mewakili koleksi Media Instagram tempat Pengguna Instagram telah ditandai oleh pengguna Instagram lain.
`upcoming_events`	Daftar acara yang diselenggarakan akun profesional Instagram ini.
`collaboration_invites`	Mewakili koleksi atribut objek `IG Media` (media_id, media_owner_username, caption, media_url) yang mana pengguna Instagram telah diundang untuk berkolaborasi.
`collaborative_media`	Mewakili koleksi Media IG dengan Pengguna IG sebagai kolaborator yang diterima. Tidak termasuk media yang dimiliki pengguna secara langsung. Tersedia untuk Instagram API dengan Facebook Login saja.

Tanggapan

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

{
  "<FIELD>":"<VALUE>",
  ...
}

Contoh cURL

Permintaan

curl -X GET \
  'https://graph.facebook.com/v25.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Tanggapan

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.