Bagian kredensial di API Explorer memungkinkan Anda menguji dengan kredensial dan cakupan yang berbeda. Fitur ini berguna untuk memastikan Anda menggunakan kredensial dan cakupan minimum yang diperlukan untuk memanggil endpoint API.
Uji dengan kredensial yang berbeda
Secara default, jenis kredensial OAuth 2 dan Kunci API dicentang. Jika Anda hanya ingin menguji dengan satu kredensial, centang jenis kredensial yang akan digunakan (dan hapus centang jenis kredensial lainnya). Berikut adalah aturan umum untuk memilih kredensial yang akan diuji:
Jika Anda menggunakan metode untuk mengakses data publik, seperti data Google Maps, Anda dapat menggunakan kunci API sebagai kredensial Anda. Centang kunci API dan hapus centang Google OAuth 2.0.
Jika Anda menggunakan metode untuk mengakses data pribadi, seperti data Google Drive pengguna, Anda harus menggunakan kredensial OAuth 2. Hapus centang kunci API dan centang Google OAuth 2.0.
Jika Anda menerima hasil 200, kredensial sudah cukup untuk mengakses data. Jika menerima hasil 401, Anda harus menggunakan kredensial OAuth 2 untuk mengakses data.
Menguji dengan cakupan yang berbeda
Cakupan adalah string, seperti
https://www.googleapis.com/auth/drive.metadata.readonly, yang menentukan tingkat
akses ke resource yang diperlukan oleh aplikasi Anda, seperti tingkat akses ke data
yang dimiliki oleh pengguna. Idealnya, Anda ingin aplikasi Anda menggunakan cakupan dengan tingkat akses yang paling sempit ke data pengguna. Metode yang berbeda mungkin memerlukan cakupan yang berbeda. Misalnya, metode dalam API mungkin memerlukan
cakupan hanya baca, sementara metode lain mungkin memerlukan cakupan
baca-tulis.
Secara default, semua cakupan OAuth 2.0 Google untuk API diaktifkan di APIs Explorer. Untuk menguji dengan cakupan tertentu:
- Di bagian Credentials Google OAuth 2.0, klik show scopes.
- Periksa cakupan yang akan digunakan saat memanggil metode.
- Klik Execute untuk mengeksekusi API hanya menggunakan cakupan yang dipilih. API Explorer menampilkan layar otorisasi yang meminta Anda memberikan akses untuk menggunakan cakupan.
- Klik Izinkan. Hasilnya akan muncul di bawah tombol Jalankan.
Jika API Explorer menampilkan hasil 200 di bagian "application/json", maka cakupan sudah cukup untuk memanggil metode. Jika API Explorer menampilkan hasil 403, berarti Anda telah memilih cakupan yang tidak memadai untuk memanggil metode. Coba cakupan yang lebih luas.
Untuk informasi tambahan tentang pemilihan cakupan, lihat bagian autentikasi dan otorisasi dokumentasi untuk Google API tertentu Anda.
Mencabut akses yang diotorisasi untuk melakukan pengujian dengan cakupan baru
Setelah Anda menggunakan layar otorisasi Google untuk menyetujui otorisasi, APIs Explorer tetap diizinkan untuk membuat permintaan yang terautentikasi selama kredensial belum habis masa berlakunya. Membatalkan centang cakupan tidak akan mereset kredensial dan cakupan yang sebelumnya disetujui. Jika ingin menguji dengan konfigurasi cakupan baru, Anda harus mencabut kredensial yang sebelumnya disetujui.
Untuk mencabut kredensial yang digunakan oleh APIs Explorer:
- Buka Aplikasi yang dapat mengakses akun Anda.
- Di bagian Aplikasi pihak ketiga dengan akses akun, klik Google APIs Explorer.
- Klik Hapus Akses.
- (opsional) Muat ulang halaman dokumentasi untuk mereset APIs Explorer.