Menguji dengan berbagai jenis dan cakupan kredensial
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003eThe API Explorer's credentials section allows testing with different credentials (API key or Google OAuth 2.0) and scopes to ensure minimal access requirements.\u003c/p\u003e\n"],["\u003cp\u003eAPI keys are suitable for accessing public data, while OAuth 2.0 credentials are necessary for private data access.\u003c/p\u003e\n"],["\u003cp\u003eUsing the scopes feature, you can select specific access levels (read-only, read-write, etc.) and verify their sufficiency for invoking API methods.\u003c/p\u003e\n"],["\u003cp\u003eTo test with new scopes, you may need to revoke previously approved credentials through your Google account settings.\u003c/p\u003e\n"]]],[],null,["# Test with different credential types and scopes\n\nThe APIs Explorer's credentials section lets you test with different\ncredentials and scopes. This feature is useful in ensuring you're using the\nminimal required credentials and scope to invoke an API endpoint.\n\nTest with different credentials\n-------------------------------\n\nBy default, both the OAuth 2 and API Key credential types are checked.\nIf you want to test with only one credential, check on the credential type to\nuse (and uncheck the other credential type). Following are the general rules for\npicking a credential to test with:\n\n- If you're using a method to access public data, such as Google Maps data, you\n can use an API key as your credential. Check **API key** and uncheck\n **Google OAuth 2.0**.\n\n- If you're using a method to access private data, such as the user's Google\n Drive data, you must use an OAuth 2 credential. Uncheck **API key** and check\n **Google OAuth 2.0**.\n\nIf you receive a result of 200, the credential is sufficient\nfor accessing the data. If you receive a result of 401, you need\nto use OAuth 2 credential to access the data.\n\nTest with different scopes\n--------------------------\n\nA scope is a string, such as\n`https://www.googleapis.com/auth/drive.metadata.readonly`, defining a level of\naccess to resources required by your app, such as the level of access to data\nowned by the users. Ideally, you want your app to use scopes with\nthe narrowest level of access to the user's data. Different methods might\nrequire different scopes. For example, a method in an API might require\nat least a read-only scope, while other methods might require a read-write\nscope.\n| **Note:** Scopes are only applicable to Google OAuth 2.0. If you're testing with an API key, you won't test with different scopes.\n\nBy default, all Google OAuth 2.0 scopes for an API are enabled in the APIs\nExplorer. To test with a specific scope:\n\n1. In the Credentials Google OAuth 2.0 section, click **show scopes**.\n2. Check the scope to use when invoking the method.\n3. Click **Execute** to execute the API using only the selected scope. The APIs Explorer shows an authorization screen asking you to grant access to use the scope.\n4. Click **Allow**. The results appear below the Execute button.\n\nIf the APIs Explorer shows a result of 200 under an \"application/json\", then the\nscope is sufficient to invoke the method. If the APIs Explorer shows an\nresult of 403, you have chosen an insufficient scope to invoke the method. Try\na broader scope.\n\nFor additional information on scope selection, refer to the authentication and\nauthorization section of documentation for your specific Google API.\n\n### Revoke authorized access to test with new scopes\n\nAfter you have used the Google authorization screen to approve authorization,\nthe APIs Explorer remains authorized to make authenticated requests as long\nas the credentials aren't expired. Unchecking scopes doesn't reset the\npreviously approved credentials and scopes. If you want to test with a new\nscope configuration, you must revoke your previously approved credentials.\n\nTo revoke the credentials used by the APIs Explorer:\n\n1. Navigate to [Apps with access to your account](https://www.google.com/accounts/IssuedAuthSubTokens).\n2. Under **Third-party apps with account access** , click **Google APIs Explorer**.\n3. Click **Remove Access**.\n4. (optional) Reload the documentation page to reset the APIs Explorer."]]
