Sebelum meluncurkan aplikasi yang meminta kredensial pengguna untuk Data Manager API kepada pengguna eksternal, project Google Cloud Anda harus menjalani verifikasi aplikasi Google OAuth.
Panduan ini membahas transisi konfigurasi Audiens yang direkomendasikan selama pengembangan dan langkah-langkah untuk menyelesaikan verifikasi aplikasi OAuth Google.
Fase audiens aplikasi
Bergantung pada tahap pengembangan Anda, konfigurasikan halaman Audiens di Konsol Google Cloud dengan setelan Jenis pengguna dan Status publikasi yang berbeda. Ikuti fase-fase ini untuk transisi yang lancar dari pengujian awal ke peluncuran produksi.
Fase 1: Pengembangan awal (Pengujian)
Saat memulai pengembangan dan pengujian permintaan API dasar:
Status publikasi: Tetapkan ke Pengujian.
Jenis pengguna:
Jika project Google Cloud Anda termasuk dalam organisasi Google Workspace dan hanya pengguna di organisasi Anda yang menggunakan aplikasi, pilih Internal.
Jika tidak, pilih Eksternal.
Pengguna uji coba: Jika Anda menetapkan Jenis pengguna ke Eksternal, klik Tambahkan pengguna untuk menambahkan Akun Google yang Anda gunakan untuk membuat kredensial secara manual. Hanya Akun Google yang tercantum yang dapat mengizinkan aplikasi, dan batas pengujian serta aturan masa berlaku token berlaku.
Verifikasi tidak diperlukan selama pengujian. Jika Anda menggunakan Eksternal, pengguna pengujian akan melihat layar peringatan yang mengonfirmasi bahwa mereka memiliki akses pengujian ke aplikasi yang belum diverifikasi sebelum melanjutkan ke layar izin.
Tahap 2: Menjelang peluncuran (Pengiriman verifikasi)
Setelah integrasi selesai, antarmuka pengguna Anda dibuat, dan Anda berencana untuk meluncurkannya dalam bulan berikutnya:
Perbarui setelan Halaman audiens:
Status publikasi: Transisi ke Dalam produksi.
Jenis pengguna: Tetapkan ke Eksternal jika aplikasi Anda melayani pelanggan di luar organisasi, seperti klien pengiklan.
Kirimkan aplikasi Anda untuk verifikasi. Proses verifikasi aplikasi Google OAuth dapat memerlukan waktu beberapa minggu, jadi kirimkan sesegera mungkin setelah UI Anda siap.
Persyaratan verifikasi aplikasi
Untuk mengirimkan aplikasi Anda untuk diverifikasi di Pusat Verifikasi, konfigurasikan setelan Platform Auth Google dan siapkan materi verifikasi yang diperlukan.
Kebijakan privasi dan branding
Di halaman Branding di konsol Google Cloud, verifikasi detail berikut sebelum mengirimkan:
Halaman beranda aplikasi: Halaman beranda Anda harus dapat diakses secara publik dan menyertakan link yang terlihat ke kebijakan privasi aplikasi Anda.
Link kebijakan privasi: URL kebijakan privasi yang dikonfigurasi di halaman Branding harus cocok dengan URL kebijakan privasi yang ditautkan di halaman beranda aplikasi Anda.
Cakupan verifikasi
Di halaman Akses Data, minta hanya cakupan yang diperlukan aplikasi Anda. Data Manager API menggunakan cakupan sensitif:
https://www.googleapis.com/auth/datamanager(Cakupan utama)https://www.googleapis.com/auth/datamanager.partnerlink(Untuk link partner)
Dalam pengajuan verifikasi, berikan penjelasan tertulis yang mendetail tentang alasan aplikasi Anda memerlukan akses ke cakupan yang diminta.
Informasi kontak
Tim verifikasi Google OAuth mengirimkan semua komunikasi kepada pemilik project dan editor project yang dikonfigurasi di project Google Cloud Anda. Selalu perbarui detail kontak ini di konsol Google Cloud agar Anda tidak melewatkan permintaan informasi.
Jika tim verifikasi mengirimkan pertanyaan lanjutan atau meminta pembaruan (seperti perubahan pada video demonstrasi atau setelan layar izin), peninjauan akan dijeda hingga Anda merespons. Jika pengiriman Anda telah tertunda selama lebih dari beberapa minggu tanpa pembaruan, periksa kotak masuk email (termasuk folder spam dan sampah) semua Project Owner dan editor project.
Video demo
Berikan link ke video demonstrasi yang dapat diakses secara publik (seperti video YouTube tidak publik atau link Google Drive publik) yang menunjukkan cara aplikasi Anda menggunakan cakupan yang diminta.
Pastikan video memenuhi semua Persyaratan video demonstrasi fungsi aplikasi, termasuk pemeriksaan Data Manager API berikut:
Perjalanan pengguna menyeluruh dan pemberian izin OAuth: Tunjukkan perjalanan pengguna lengkap di aplikasi Anda, mulai dari pengguna memulai login atau otorisasi hingga menyelesaikan alur pemberian izin OAuth.
Identitas aplikasi yang cocok: Pastikan nama, logo, dan branding aplikasi yang ditampilkan dalam video cocok dengan konfigurasi halaman Branding di Konsol Google Cloud.
Layar izin OAuth lengkap dalam bahasa Inggris: Tampilkan seluruh layar izin OAuth dengan pemilih bahasa di pojok kiri bawah yang disetel ke English, dan pastikan layar menampilkan cakupan Data Manager API yang tepat yang diminta aplikasi Anda.
Penggunaan cakupan di UI aplikasi Anda: Tunjukkan fitur aplikasi yang menggunakan cakupan yang diminta (misalnya, membuat link partner, membuat daftar audiens, atau mengonfigurasi penyerapan data di UI aplikasi Anda).
Fase 3: Siap diluncurkan (Terverifikasi)
Setelah tim verifikasi Google OAuth memberi tahu Anda bahwa mereka telah menyetujui permintaan verifikasi aplikasi Anda, Anda tidak perlu melakukan tindakan apa pun. Aplikasi Anda kini telah diverifikasi, dan pengguna eksternal dapat mengizinkannya tanpa melihat layar peringatan aplikasi yang belum diverifikasi.