Graph API

Memulai

Panduan ini menjelaskan cara memulai menerima data dari Grafik Sosial Meta.

Sebelum Memulai

Anda akan memerlukan:

Permintaan Pertama Anda

Langkah 1: Buka fitur Graph API Explorer

Buka Graph API Explorer di jendela browser baru. Ini memungkinkan Anda untuk mengeksekusi contoh saat Anda membaca tutorial ini.

Explorer dimuat bersama kueri default dengan metode GET, versi terbaru Graph API, node /me serta kolom id dan name di Kolom String Kueri, dan Aplikasi Facebook Anda.

Langkah 2. Buat Token Akses

Klik tombol Buat Token Akses. Jendela Masuk dengan Facebook akan muncul. Pop-up ini adalah aplikasi Anda yang meminta izin untuk mendapatkan nama dan gambar profil Anda dari Facebook.

Alur ini adalah produk Facebook Login yang memungkinkan seseorang untuk masuk ke aplikasi menggunakan kredensial Facebook mereka. Facebook Login memungkinkan aplikasi untuk meminta seseorang mengakses data Facebook orang tersebut, dan orang tersebut menerima atau menolak akses. Nama dan gambar profil Anda bersifat publik, untuk memungkinkan orang menemukan Anda di Facebook, jadi tidak diperlukan persyaratan tambahan untuk menjalankan permintaan ini.

Klik Lanjutkan sebagai...

Token Akses Pengguna dibuat. Token ini berisi informasi seperti aplikasi yang membuat permintaan, orang yang menggunakan aplikasi untuk membuat permintaan, apakah token akses masih valid (berlaku sekitar satu jam), masa berlaku, dan lingkup data yang dapat diminta aplikasi. Dalam permintaan ini, ruang lingkupnya adalah public_profile yang menyertakan nama dan gambar profil Anda.

Klik ikon lingkaran informasi di sebelah token akses untuk melihat informasi token.

Langkah 3. Kirim Permintaan

Klik tombol Kirim di pojok kanan atas.

Tampilan yang Seharusnya Anda Lihat

Di Jendela Tanggapan, Anda akan melihat tanggapan JSON dengan ID Pengguna Facebook dan nama Anda.

Jika Anda menghapus ?fields=id,name dari kolom string kueri dan mengeklik Kirim, Anda akan melihat hasil yang sama karena name dan id adalah kolom node Pengguna yang diberikan secara default.

Permintaan Kedua Anda

Langkah 1. Tambahkan Kolom

Buat Permintaan Pertama sedikit lebih rumit dengan menambahkan kolom lain, email. Ada dua cara untuk menambahkan kolom:

  • Klik menu pilihan pencarian di Penampil Kolom Node di sisi kiri jendela tanggapan
  • Mulai mengetik di kolom string kueri.

Tambahkan kolom email dan klik Kirim.

Tampilan yang Seharusnya Anda Lihat

Sementara panggilan tidak gagal, hanya kolom name dan id ditampilkan bersama dengan pesan debug. Klik tautan (Tampilkan) untuk men-debug permintaan.

Hampir semua node dan kolom memerlukan izin khusus untuk mengaksesnya. Pesan debug memberi tahu Anda bahwa Anda perlu memberi aplikasi Anda izin untuk mengakses alamat email yang telah Anda kaitkan dengan akun Facebook Anda.

Langkah 2. Tambahkan Izin

Di panel sisi kanan, di bawah Izin, klik menu pilihan Tambahkan Izin. Klik Izin Data Pengguna dan pilih email.

Buat Token Akses Pengguna Baru

Karena Anda mengubah cakupan token akses, Anda perlu membuat yang baru. Klik Buat Token Akses. Sama seperti permintaan pertama Anda, Anda harus memberi aplikasi Anda izin untuk mengakses email Anda di dialog Facebook Login.

Setelah token baru dibuat, klik Kirim. Sekarang, semua kolom dalam permintaan Anda akan ditampilkan.

Coba dapatkan postingan Facebook Anda.

Lihat langkah-langkahnya.

Tautan di Tanggapan

Perhatikan bahwa nilai id yang ditampilkan di jendela tanggapan adalah tautan. Tautan ini dapat mewakili node, seperti Pengguna, Halaman, atau Postingan. Jika Anda mengeklik tautan, ID akan menggantikan konten kolom string kueri. Sekarang Anda dapat menjalankan permintaan pada node itu. Karena node ini terhubung ke node induk, Postingan Pengguna, Anda mungkin tidak perlu menambahkan izin. Anda dapat mengeklik ID Postingan sekarang karena kami akan menggunakannya dalam contoh berikutnya.

Perhatikan: Beberapa ID adalah kombinasi dari ID induk dan string ID baru. Contoh: Postingan Pengguna akan memiliki ID Postingan yang terlihat seperti ini: 1028223264288_102224043055529 dengan ketentuan 1028223264288 adalah ID Pengguna.

Mari Kita Lihat Edge

Node Pengguna tidak memiliki banyak edge yang dapat memberikan data. Akses ke objek Pengguna hanya dapat diberikan oleh Pengguna yang memiliki objek tersebut. Dalam kebanyakan kasus, Pengguna memiliki objek jika mereka membuatnya.

Contoh: jika Anda menerbitkan sebuah postingan, Anda dapat melihat informasi tentang postingan tersebut seperti kapan postingan tersebut dibuat, teks, foto, dan tautan yang dibagikan dalam postingan tersebut, dan jumlah tanggapan yang diterima postingan tersebut. Jika Anda mengomentari postingan Anda, Anda akan bisa mendapatkan komentar itu, tetapi jika orang lain menerbitkan komentar di postingan Anda, Anda tidak akan dapat melihat komentar atau siapa yang menerbitkannya.

Coba dapatkan jumlah tanggapan untuk salah satu postingan Anda. Anda akan melihat

Referensi Tanggapan Objek.

Lihat langkah-langkahnya.

Mendapatkan Kode untuk Permintaan Anda

Fitur jelajah memungkinkan Anda menguji permintaan dan setelah Anda mendapatkan tanggapan yang berhasil, Anda bisa mendapatkan kode untuk dimasukkan ke dalam kode aplikasi Anda. Di bawah jendela tanggapan, klik Get Code. Explorer menawarkan kode Android, iOS, JavaScript, PHP, dan cURL. Kode sudah dipilih sebelumnya sehingga Anda cukup menyalin dan menempelkannya.

Kami rekomendasikan Anda menerapkan Facebook SDK untuk aplikasi Anda. SDK ini akan menyertakan Facebook Login yang memungkinkan aplikasi Anda meminta izin dan mendapatkan token akses.

Pelajari Selengkapnya

Anda dapat menggunakan Graph API Explorer guna menguji permintaan apa saja untuk Pengguna, Halaman, Grup, dan lainnya. Kunjungi referensi untuk setiap node atau edge untuk menentukan izin dan jenis token akses yang diperlukan.