Jika aplikasi Anda meminta izin untuk menggunakan Google API guna mengakses data pengguna Google data, Anda mungkin memiliki untuk menyelesaikan proses verifikasi sebelum Anda membuat aplikasi Anda tersedia secara publik untuk yang pertama baik.
Apakah persyaratan ini berlaku untuk aplikasi Anda sebagian besar bergantung pada dua faktor:
- Jenis data pengguna yang Anda akses—informasi profil publik, entri kalender, file di Drive, data kesehatan dan kebugaran tertentu, dll.
- Tingkat akses yang Anda butuhkan—hanya baca, baca dan tulis, dll.
Saat Anda menggunakan OAuth 2.0 untuk mendapatkan izin dari Akun Google guna mengakses data mereka, Anda menggunakan string yang disebut cakupan untuk menentukan jenis data yang ingin Anda akses atas nama mereka. Jika aplikasi Anda meminta cakupan yang dikategorikan sebagai sensitif atau dibatasi, Anda mungkin perlu menyelesaikan proses verifikasi, kecuali jika penggunaan aplikasi Anda memenuhi syarat untuk pengecualian.
Contoh cakupan sensitif mencakup membaca acara yang disimpan di Google Kalender, menyimpan kontak baru di Google Kontak, atau menghapus video YouTube. Untuk mengetahui informasi selengkapnya tentang cakupan yang tersedia dan klasifikasinya, lihat dokumentasi referensi API endpoint yang dipanggil oleh aplikasi Anda dan panduan otorisasi terkait yang dipublikasikan untuk API.
Anda harus meminta cakupan yang memerlukan akses paling sedikit ke data pengguna yang diperlukan untuk menyediakan fungsi tersebut. Misalnya, aplikasi yang hanya membaca data tidak boleh meminta akses untuk membaca, menulis, dan menghapus konten jika cakupan yang lebih sempit tersedia untuk API dan endpoint terkaitnya. Data yang Anda terima dari Google API hanya boleh digunakan sesuai dengan kebijakan API dan dengan cara yang kepada pengguna dalam tindakan aplikasi dan kebijakan privasi Anda.
Pastikan untuk memperhitungkan waktu yang diperlukan guna menyelesaikan verifikasi dalam rencana peluncuran untuk atau fitur baru apa pun yang memerlukan ruang lingkup baru. Proses verifikasi cakupan sensitif biasanya memerlukan waktu 3-5 hari kerja. Perhatikan bahwa aplikasi Anda mungkin memenuhi syarat untuk diselesaikan merek verifikasi sebagai bagian dari permintaan verifikasi cakupan sensitif Anda.
Memahami cakupan sensitif
Cakupan sensitif perlu ditinjau oleh Google sebelum Akun Google dapat memberikan akses. Kebijakan Privasi Administrator organisasi Workspace mungkin membatasi akses ke cakupan sensitif untuk mencegah akses oleh client ID OAuth yang tidak dapat diakses oleh organisasi secara eksplisit tandai sebagai tepercaya.
Memahami penggunaan cakupan
- Tinjau cakupan yang digunakan atau ingin digunakan aplikasi Anda. Untuk menemukan penggunaan cakupan yang ada, periksa kode sumber aplikasi Anda untuk cakupan apa pun yang dikirim dengan permintaan otorisasi.
- Menentukan apakah setiap cakupan yang diminta diperlukan untuk tindakan yang dimaksudkan fitur aplikasi Anda dan menggunakan hak istimewa terendah yang diperlukan untuk menyediakan fitur tersebut. Google API biasanya memiliki dokumentasi referensi tentang atribut Halaman Developer Google untuk endpoint-nya yang menyertakan cakupan yang diperlukan untuk memanggil endpoint atau properti tertentu di dalamnya. Untuk informasi selengkapnya tentang cakupan untuk titik akhir API yang dipanggil aplikasi Anda, baca dokumentasi referensi tersebut endpoint.
- Data yang Anda terima dari Google API hanya boleh digunakan dengan mematuhi kebijakan API dan dengan cara yang Anda tunjukkan kepada pengguna dalam tindakan aplikasi dan dalam kebijakan privasi Anda.
- Lihat dokumentasi API untuk mempelajari lebih lanjut setiap cakupan, termasuk potensi status sensitive or restricted -nya.
- Deklarasikan semua cakupan yang digunakan oleh aplikasi Anda di API Console Layar izin OAuth halaman cakupan konfigurasi Google Cloud. Cakupan yang Anda tentukan dikelompokkan menjadi sensitif atau dibatasi kategori untuk menyoroti verifikasi tambahan yang diperlukan.
- Temukan cakupan terbaik yang cocok dengan data yang digunakan oleh integrasi Anda, pahami penggunaannya, konfirmasi ulang bahwa semuanya masih berfungsi di lingkungan pengujian, lalu bersiaplah untuk mengirimkannya verifikasi.
Langkah-langkah untuk mempersiapkan verifikasi
Semua aplikasi yang menggunakan Google API untuk meminta akses ke data harus melakukan langkah-langkah berikut untuk selesaikan verifikasi merek:
- Pastikan aplikasi Anda tidak termasuk dalam salah satu kasus penggunaan di Bagian Pengecualian untuk persyaratan verifikasi.
- Pastikan aplikasi Anda mematuhi persyaratan branding API terkait atau Google. Misalnya, lihat pedoman branding untuk cakupan Login dengan Google.
- Verifikasi kepemilikan domain resmi project Anda dalam Google Search Console. Gunakan Akun Google yang terkait dengan project API Console Anda sebagai Pemilik atau Editor.
- Pastikan semua informasi branding di layar izin OAuth, seperti nama aplikasi, email dukungan, URI halaman beranda, URI kebijakan privasi, dll., mewakili identitas aplikasi secara akurat.
Persyaratan halaman beranda aplikasi
Pastikan halaman beranda Anda memenuhi persyaratan berikut:
- Halaman beranda Anda harus dapat diakses secara publik, dan tidak hanya dapat diakses oleh pengguna yang login ke situs Anda pelanggan.
- Relevansi halaman beranda Anda dengan aplikasi yang sedang dalam peninjauan harus jelas.
- Link ke listingan aplikasi Anda di Google Play Store atau halaman Facebook-nya tidak dipertimbangkan halaman beranda aplikasi yang valid.
Persyaratan link kebijakan privasi aplikasi
Pastikan kebijakan privasi aplikasi Anda memenuhi persyaratan berikut:
- Kebijakan privasi harus terlihat oleh pengguna, dihosting dalam domain yang sama dengan halaman beranda aplikasi, dan ditautkan ke layar izin OAuth di Google API Console. Perhatikan bahwa laman beranda harus menyertakan deskripsi fungsi aplikasi, serta tautan ke kebijakan privasi dan persyaratan layanan opsional.
- Kebijakan privasi harus mengungkapkan cara aplikasi Anda mengakses, menggunakan, menyimpan, atau membagikan data pengguna Google. Anda harus membatasi penggunaan data pengguna Google oleh praktik yang Anda publikasikan terungkap oleh kebijakan privasi.
Cara mengirimkan aplikasi Anda untuk verifikasi
ProjectGoogle API Console mengatur semua resource API Console Anda. Sebuah proyek terdiri dari sekumpulan elemen yang saling terkait Akun Google yang memiliki izin untuk menjalankan operasi project, sekumpulan API yang diaktifkan, dan setelan penagihan, autentikasi, dan pemantauan untuk API tersebut. Misalnya, sebuah proyek dapat berisi satu atau beberapa klien OAuth, mengonfigurasi API untuk digunakan oleh klien tersebut, dan Layar izin OAuth yang ditampilkan kepada pengguna sebelum mereka mengizinkan akses ke aplikasi Anda.
Jika salah satu klien OAuth Anda belum siap untuk produksi, sebaiknya hapus klien tersebut dari proyek yang meminta verifikasi. Anda dapat melakukannya di Google API Console.
Untuk mengirimkan verifikasi, ikuti langkah-langkah berikut:
- Pastikan aplikasi Anda mematuhi Persyaratan Layanan Google API, dan Kebijakan Data Pengguna Layanan Google API.
- Pastikan peran pemilik dan editor untuk akun terkait project Anda tetap aktual, serta Email dukungan pengguna dan informasi kontak developer layar izin OAuth, di API Console. Hal ini memastikan bahwa anggota tim yang tepat diberi tahu tentang persyaratan baru.
- Buka API Console OAuth Consent Screen pageAnda.
- Klik tombol Project selector.
-
Pada dialog Select from yang muncul, pilih project Anda. Jika tidak dapat menemukan project, tetapi mengetahui project ID, Anda dapat membuat URL di browser dalam format berikut:
https://console.developers.google.com/apis/credentials/consent?project=[PROJECT_ID]
Ganti [PROJECT_ID] dengan project ID yang ingin Anda gunakan.
- Pilih tombol Edit Aplikasi.
- Masukkan informasi yang diperlukan di halaman layar izin OAuth, lalu pilih tombol Simpan lalu lanjutkan.
- Gunakan tombol Tambahkan atau hapus cakupan untuk mendeklarasikan semua cakupan yang diminta oleh aplikasi Anda. Set cakupan awal yang diperlukan untuk Login dengan Google telah diisi otomatis di bagian Cakupan non-sensitif. Cakupan yang ditambahkan diklasifikasikan sebagai tidak sensitif, sensitive, or restricted.
- Berikan hingga tiga link ke dokumentasi yang relevan untuk fitur terkait di aplikasi Anda.
-
Berikan informasi tambahan yang diminta tentang aplikasi Anda di langkah berikutnya.
- Prepare a detailed justification for each requested sensitive scope, as well as an explanation
for why a narrower scope isn't sufficient. For example: "My app will use
https://www.googleapis.com/auth/calendarto show a user's Google calendar data on the scheduling screen of my app. This lets users manage their schedules through my app and sync the changes with their Google calendar." -
Prepare a video that fully demonstrates how a user initiates and grants access to the requested scopes and shows, in detail, the usage of the granted sensitive and restricted scopes in the app. Upload the video to YouTube Studio and set its Visibility as Unlisted. You need to provide a link to the demonstration video in the YouTube link field.
- Show the OAuth grant process that users will experience, in English. This includes the consent flow and, if you use Google Sign-In, the sign-in flow.
- Show that the OAuth consent screen correctly displays the App Name.
- Show that the browser address bar of the OAuth consent screen correctly includes your app's OAuth client ID.
- To show how the data will be used, demonstrate the functionality that's enabled by each sensitive scope that you request.
- Prepare a detailed justification for each requested sensitive scope, as well as an explanation
for why a narrower scope isn't sufficient. For example: "My app will use
- Jika konfigurasi aplikasi yang Anda berikan memerlukan verifikasi, Anda memiliki kesempatan untuk mengirimkan aplikasi untuk diverifikasi. Lengkapi kolom yang wajib diisi, lalu klik Kirim untuk memulai proses verifikasi Anda.
Setelah Anda mengirimkan aplikasi, tim Kepercayaan & Keamanan Google akan menghubungi Anda melalui email untuk meminta informasi tambahan yang diperlukan atau langkah-langkah yang harus Anda selesaikan. Periksa alamat email Anda di bagian Informasi kontak developer dan email dukungan layar izin OAuth Anda untuk melihat permintaan informasi tambahan. Anda juga dapat melihat izin OAuth project Anda halaman layar untuk mengonfirmasi status tinjauan proyek Anda saat ini, termasuk apakah proses peninjauan dijeda sementara kami menunggu respons Anda.
Pengecualian untuk persyaratan verifikasi
Jika aplikasi Anda akan digunakan dalam salah satu skenario yang dijelaskan di bagian berikut, Anda tidak perlu mengirimkannya untuk ditinjau.
Penggunaan pribadi
Salah satu kasus penggunaannya adalah jika Anda adalah satu-satunya pengguna aplikasi atau jika aplikasi Anda digunakan hanya oleh beberapa pengguna, yang mereka semua dikenal secara pribadi oleh Anda. Anda dan jumlah pengguna yang terbatas mungkin tidak keberatan melewati berbagai tahap aplikasi belum diverifikasi layar dan memberi akun pribadi Anda akses ke aplikasi.
Project yang digunakan dalam Pengembangan, Pengujian, atau Staging tingkatan
Untuk mematuhi Kebijakan Google OAuth 2.0, sebaiknya Anda memiliki project yang berbeda untuk lingkungan pengujian dan produksi. Sebaiknya Anda hanya mengirimkan aplikasi untuk verifikasi jika Anda ingin membuat aplikasi Anda tersedia untuk semua pengguna yang memiliki Akun Google. Oleh karena itu, jika aplikasi Anda sedang dalam tahap pengembangan, pengujian, atau staging, verifikasi tidak diperlukan.
Jika aplikasi berada dalam fase pengembangan atau pengujian, Anda dapat membiarkan Status Publikasi di pengaturan {i>default <i}dari Pengujian. Setelan ini berarti bahwa aplikasi Anda masih dalam pengembangan dan hanya untuk pengguna yang Anda tambahkan ke daftar pengguna uji coba. Anda harus mengelola daftar Akun Google yang terlibat dalam pengembangan atau pengujian aplikasi Anda.
Khusus data milik layanan
Jika aplikasi Anda menggunakan akun layanan untuk mengakses datanya sendiri, dan tidak mengakses pengguna mana pun data (ditautkan ke Akun Google), maka Anda tidak perlu mengirimkannya untuk verifikasi.
Untuk memahami akun layanan, lihat Akun layanan di dokumentasi Google Cloud. Untuk petunjuk cara menggunakan akun layanan, lihat Menggunakan OAuth 2.0 untuk server ke server aplikasi.
Khusus penggunaan internal
Artinya, aplikasi hanya digunakan oleh pengguna Google Workspace atau Cloud Identity Anda organisasi. Project harus dimiliki oleh organisasi, dan layar izin OAuth-nya harus dikonfigurasi untuk jenis pengguna Internal. Dalam hal ini, aplikasi Anda mungkin memerlukan persetujuan dari administrator organisasi. Sebagai informasi selengkapnya, lihat Tambahan untuk Google Workspace.
- Pelajari lebih lanjut cara publik dan aplikasi internal.
- Pelajari cara menandai aplikasi sebagai internal di FAQ Bagaimana cara menandai aplikasi saya sebagai khusus internal?
Penginstalan di seluruh domain
Jika Anda ingin aplikasi hanya menargetkan pengguna Google Workspace atau Cloud Identity organisasi dan selalu menggunakan seluruh domain penginstalan, maka aplikasi Anda tidak akan memerlukan verifikasi aplikasi. Hal ini karena domain di seluruh memungkinkan administrator domain memberikan akses kepada aplikasi internal dan pihak ketiga ke pengguna Anda layanan otomatis dan data skalabel. Administrator organisasi adalah satu-satunya akun yang dapat menambahkan aplikasi ke yang diizinkan untuk digunakan di domain mereka.
Pelajari cara membuat aplikasi Anda menjadi Penginstalan di Seluruh Domain dalam FAQ Ada pengguna di aplikasi saya akun perusahaan dari Domain Google Workspace lainnya.