Panduan Graph API Explorer

Penggunaan Umum

• Membuat token akses dengan cepat
• Mendapatkan contoh kode untuk kueri Anda
• Membuat informasi debug untuk disertakan dalam permintaan dukungan
• Menguji kueri API dengan pengaturan aplikasi produksi Anda termasuk izin, fitur, dan pengaturan untuk kasus penggunaan Anda
• Menguji kueri API dengan aplikasi pengujian atau pengembangan Anda menggunakan izin dan fitur pada pengguna uji atau data uji

Persyaratan

• Akun Developer Meta
• Aplikasi yang Anda berperan sebagai admin, developer, atau penguji

Komponen

Token Akses

Ketika Anda mendapatkan token akses, token akan ditampilkan di sisi kanan atas fitur. Ini adalah token yang diikutsertakan dalam kueri Graph API Anda. Anda dapat menyalin token ini dan menggunakannya di aplikasi Anda untuk menguji kode Anda.

Klik ikon informasi untuk melihat informasi tentang token saat ini, termasuk aplikasi yang berhubungan dengan token tersebut, beserta izin apa pun yang telah diberikan oleh Pengguna aplikasi tersebut (yaitu Anda).

Anda dapat membuat token akses baru jika token telah kedaluwarsa atau jika Anda menambahkan izin baru.

Aplikasi Meta

Menu pilihan Aplikasi Meta di sisi kanan atas menampilkan semua aplikasi yang Anda berperan sebagai admin, developer, atau penguji. Gunakan menu pilihan untuk memilih pengaturan aplikasi yang ingin Anda uji.

Pengguna atau Halaman

Menu pilihan Pengguna atau Halaman memungkinkan Anda untuk memperoleh dan menukarkan token akses Aplikasi, Pengguna, dan Halaman untuk aplikasi yang dipilih pada saat ini. Anda juga dapat menggunakannya untuk menghapus instalan aplikasi Anda dari node Pengguna, yang nantinya menghapus token akses pada saat ini.

Izin

Kapan pun Anda meminta token akses Pengguna, hanya satu izin yang diberikan secara default, yaitu public_profile. Menu pilihan Izin memungkinkan Anda memilih Izin Data Pengguna, seperti email dan user_photos, Acara, Grup, dan Izin Halaman, misalnya manage_pages dan ads_management, serta izin lainnya, misalnya izin instagram_basic dan publish_video. Ini membuat Pengguna aplikasi pada saat ini (yaitu Anda) untuk memberikan izin aplikasi tertentu. Hanya berikan izin yang benar-benar dibutuhkan oleh aplikasi Anda.

Jika aplikasi Anda dalam pengembangan, Anda dapat memberikan izin apa pun ke aplikasi Anda dan kueri Anda akan menghormati izin tersebut untuk data milik orang-orang yang berperan dalam aplikasi Anda. Jika aplikasi Anda sudah terbit, memberikan izin yang belum disetujui untuk aplikasi Anda berdasarkan proses Tinjauan Aplikasi akan menyebabkan kueri Anda gagal setiap kali Anda mengirimkannya.

Kolom string kueri

Ketika Anda pertama kali masuk ke fitur, kueri default akan muncul. Anda dapat mengedit kueri dengan mengetikkan kueri yang baru, atau dengan mencari dan memilih kolom di penampil kolom setelah mengeksekusi kueri. Anda juga dapat menggunakan menu pilihan untuk beralih antara metode operasi yang ada, dan menargetkan berbagai versi Graph API.

Jika Anda mengeklik ikon bintang di akhir kolom kueri, kueri akan disimpan sebagai favorit. Anda dapat melihat kueri favorit dengan mengeklik ikon buku.

Penampil Kolom Node

Ketika Anda mengirimkan kueri GET pada node, penampil kolom yang terletak di sisi kiri jendela akan menampilkan nama node dan kolom yang dihasilkan oleh Graph API. Anda dapat memodifikasi kueri dengan cara mencari dan memilih kolom baru, mengklik ikon plus, dan memilih kolom yang tersedia, atau menghapus centang untuk kolom yang tidak diperlukan. Tindakan ini otomatis memperbarui kueri Anda di kolom string kueri.

Jendela Tanggapan

Tanggapan, terletak di bawah string kueri, menunjukkan hasil dari kueri terakhir yang Anda kirimkan.

Mendapatkan Kode

Jika Anda puas dengan kueri Anda, klik tombol Dapatkan Kode yang terletak di pusat tombol di bawah tanggapan, untuk membuat contoh kode berdasarkan kueri. Pada umumnya, Anda tidak akan dapat menyalin dan menempel kode contoh secara langsung di basis kode, tetapi langkah ini merupakan titik awal yang berguna bagi Anda.

Menyalin Informasi Debug

Jika kueri terus-menerus gagal tanpa Anda mengetahui penyebabnya, dan Anda memutuskan untuk menghubungi Dukungan Developer, klik tombol ini, yang terletak di bagian tengah bawah, untuk menyalin kueri dan detail tanggapan Anda ke papan klip. Anda dapat mengirimkan informasi ini bersama-sama dengan permintaan dukungan Anda guna membantu penyelidikan kami.

Menyimpan Sesi

Klik tombol Simpan Sesi, yang terletak di bagian tengah bawah, untuk menyimpan status kueri Anda, dengan token akses dihapus. Sertakan tautan ke sesi ini jika Anda memutuskan untuk menghubungi Dukungan Developer.

Contoh Kueri

Cobalah mengeksekusi kueri default yang muncul pada saat Anda memuat Graph API Explorer untuk pertama kalinya. Jika Anda belum melakukannya, buka Graph API Explorer di jendela baru, pilih aplikasi yang ingin Anda uji dari menu pilihan aplikasi, dan dapatkan token akses Pengguna.

Kueri default muncul dalam kolom string kueri:

GET https://developers.facebook.com/v21.0/me?fields=id,name

Kueri default meminta kolom id dan name di node /me, yang merupakan node khusus yang mengarah ke node /User dan /Page yang diidentifikasi oleh token. Karena Anda menggunakan token akses Pengguna, maka node Pengguna Andalah yang dipetakan.

Kolom id dan name tersedia secara publik dan dapat ditampilkan jika Pengguna telah memberikan izin default atau public_profile kepada aplikasi Anda. Izin tersebut disetujui sebelumnya untuk semua aplikasi (Anda dapat mengonfirmasinya dengan mengklik ikon informasi di Kolom Token Akses), sehingga Anda tidak perlu memberikan izin tambahan kepada aplikasi Anda agar kueri dapat berfungsi. Klik Dapatkan Token Akses dan konfirmasi bahwa Anda ingin memberikan akses aplikasi Anda ke informasi Pengguna Anda yang tersedia secara publik.

Kirimkan kueri Anda, dan Anda akan melihat ID Pengguna lingkup aplikasi dan nama Anda di jendela tanggapan.