Langkah-langkah yang harus diikuti untuk membuat dan mengonfigurasi project Konsol API Google bergantung pada jenis skenario otorisasi OAuth 2.0 yang Anda buat di aplikasi. Pilih skenario otorisasi yang Anda buat; panduan ini akan disesuaikan berdasarkan pilihan Anda.
Anda memerlukan project Konsol API Google untuk membuat kredensial OAuth 2.0, dan mengaktifkan Google Ads API untuk aplikasi Anda.
Kredensial diperlukan untuk autentikasi dan otorisasi pengguna Google Ads oleh server Google. Kredensial ini memungkinkan Anda membuat token OAuth untuk digunakan dalam panggilan ke API.
Memilih atau membuat project Konsol API Google
Ikuti petunjuk untuk membuat project. Mengaktifkan penagihan untuk project Anda bersifat opsional. Jika penagihan diaktifkan, pilih akun penagihan untuk project baru. Penggunaan Google Ads API tidak dikenai biaya, tetapi ada kuota untuk jumlah total project Cloud.
Mengaktifkan Google Ads API di project Anda
Untuk mengaktifkan Google Ads API di project Anda, ikuti langkah-langkah berikut:
Buka Library API di Konsol API Google. Jika diminta, pilih project Anda atau buat project baru. Library API menampilkan daftar semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.
Gunakan penelusuran untuk menemukan Google Ads API jika tidak terlihat dalam daftar.
Pilih Google Ads API, lalu klik tombol Aktifkan.
Mengajukan permohonan akses API
Selanjutnya, buka halaman Ringkasan Google Ads API. Halaman ini menampilkan tingkat akses API Anda saat ini. Jika tingkat akses API Anda saat ini adalah Tingkat Akses Akun Uji Coba , luaskan bagian Ajukan permohonan tingkat akses berikutnya. Ikuti petunjuk untuk mengajukan permohonan Tingkat Akses Explorer.
Setelah Anda menyelesaikan permohonan, Google akan otomatis meninjau permohonan Anda dan mengupgradenya ke Akses Explorer dalam sebagian besar kasus.
Mengonfigurasi layar izin OAuth
Saat Anda menggunakan OAuth 2.0 untuk otorisasi, Google akan menampilkan layar izin kepada pengguna yang mencakup ringkasan project Anda, kebijakannya, dan cakupan otorisasi akses yang diminta. Mengonfigurasi layar izin OAuth aplikasi Anda menentukan apa yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi Anda sehingga Anda dapat memublikasikannya nanti.
Ikuti petunjuk
untuk mengonfigurasi layar izin OAuth untuk aplikasi Anda dan menambahkan
https://www.googleapis.com/auth/adwords sebagai cakupan OAuth.
Pertimbangan penting untuk jenis pengguna dan status publikasi
Saat mengonfigurasi layar izin OAuth, perhatikan setelan Jenis pengguna dan Status publikasi.
- Jenis pengguna: Menentukan apakah aplikasi Anda hanya tersedia untuk pengguna dalam organisasi Anda ('Internal') atau tersedia untuk pengguna Google mana pun ('Eksternal'). Perhatikan bahwa 'Internal' hanya merupakan opsi jika project Anda adalah bagian dari organisasi Google Workspace.
- Status publikasi: Menentukan apakah aplikasi dalam mode 'Pengujian' (terbatas untuk pengguna pengujian tertentu yang Anda tambahkan) atau 'Dalam produksi' (tersedia untuk audiens yang ditentukan oleh Jenis pengguna, yang berpotensi memerlukan verifikasi aplikasi oleh Google).
Untuk membuat pilihan terbaik bagi aplikasi Anda, tinjau penjelasan dan implikasi mendetail dari setelan ini dalam dokumentasi dukungan Google Cloud resmi:
Memahami setelan ini sangat penting untuk memastikan aplikasi Anda dapat diakses oleh pengguna yang dituju.
Membuat client ID dan rahasia klien
Anda dapat melewati langkah ini jika menggunakan project Konsol API Google yang sudah ada dan telah memiliki client ID dan rahasia klien yang dibuat. Jika tidak, buat client ID dan rahasia klien dengan mengikuti petunjuk. Anda dapat memilih Aplikasi desktop atau Aplikasi web sebagai jenis aplikasi. Setelah membuat klien OAuth 2.0, download file JSON klien dengan mengklik ikon Download klien OAuth terlebih dahulu, lalu tombol DOWNLOAD JSON di layar berikutnya.