Meminta Cakupan Tambahan

Peringatan: Login dengan Google untuk Android sudah tidak berlaku dan tidak lagi didukung. Untuk memastikan keamanan dan kegunaan aplikasi Anda terus berlanjut, migrasikan ke Pengelola Kredensial sekarang. Pengelola Kredensial mendukung autentikasi kunci sandi, sandi, dan identitas gabungan (seperti Login dengan Google), keamanan yang lebih kuat, dan pengalaman pengguna yang lebih konsisten. Untuk developer Wear: Pengelola Kredensial akan didukung di Wear OS 5.1 dan yang lebih baru di smartwatch tertentu. Developer yang secara aktif mendukung perangkat Wear OS 3, 4, dan 5.0 dengan Login dengan Google harus terus menggunakan Login dengan Google untuk Android untuk aplikasi Wear Anda. Dukungan Login dengan Google akan tersedia di Credential Manager API untuk versi WearOS ini di lain waktu.

Peringatan: Halaman ini sudah tidak berlaku, lihat Memberi Otorisasi Akses ke Data Pengguna untuk mengetahui praktik terbaik terbaru.

Untuk pengalaman pengguna terbaik, Anda harus meminta cakupan sesedikit mungkin saat meminta pengguna login untuk pertama kalinya. Jika fungsi inti aplikasi Anda tidak terikat dengan layanan Google, konfigurasi GoogleSignInOptions.DEFAULT_SIGN_IN sering kali merupakan satu-satunya yang Anda perlukan saat login.

Jika aplikasi Anda memiliki fitur yang dapat menggunakan data Google API, tetapi tidak diperlukan sebagai bagian dari fungsi inti aplikasi, Anda harus mendesain aplikasi agar dapat menangani kasus dengan baik saat data API tidak dapat diakses. Misalnya, Anda dapat menyembunyikan daftar file yang baru disimpan saat pengguna belum memberikan akses Drive.

Anda harus meminta cakupan tambahan yang diperlukan untuk mengakses Google API hanya saat pengguna melakukan tindakan yang memerlukan akses ke API tertentu. Misalnya, Anda dapat meminta izin untuk mengakses Drive pengguna hanya saat pengguna mengetuk tombol "Simpan ke Drive" untuk pertama kalinya.

Dengan menggunakan teknik ini, Anda dapat menghindari membebani pengguna baru, atau membuat pengguna kebingungan karena diminta untuk memberikan izin tertentu.

Meminta izin yang diperlukan oleh tindakan pengguna

Setiap kali pengguna melakukan tindakan yang memerlukan cakupan yang tidak diminta saat login, panggil GoogleSignIn.hasPermissions untuk memeriksa apakah pengguna telah memberikan izin yang diperlukan. Jika tidak, panggil GoogleSignIn.requestPermissions untuk meluncurkan aktivitas yang meminta cakupan tambahan yang diperlukan dari pengguna.

Misalnya, jika pengguna melakukan tindakan yang memerlukan akses ke penyimpanan aplikasi Drive-nya, lakukan hal berikut:

if (!GoogleSignIn.hasPermissions(
        GoogleSignIn.getLastSignedInAccount(getActivity()),
        Drive.SCOPE_APPFOLDER)) {
    GoogleSignIn.requestPermissions(
            MyExampleActivity.this,
            RC_REQUEST_PERMISSION_SUCCESS_CONTINUE_FILE_CREATION,
            GoogleSignIn.getLastSignedInAccount(getActivity()),
            Drive.SCOPE_APPFOLDER);
} else {
    saveToDriveAppFolder();
}

Dalam callback onActivityResult aktivitas, Anda dapat memeriksa apakah izin yang diperlukan berhasil diperoleh, dan jika ya, lakukan tindakan pengguna.

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode == Activity.RESULT_OK) {
        if (RC_REQUEST_PERMISSION_SUCCESS_CONTINUE_FILE_CREATION == requestCode) {
            saveToDriveAppFolder();
        }
    }
}

Anda juga dapat meneruskan GoogleSignInOptionsExtension ke hasPermissions dan requestPermissions untuk memeriksa dan mendapatkan sekumpulan izin dengan lebih mudah.