Kredensial untuk mengakses server OAuth2 Google diperlukan untuk mengautentikasi dan memberikan otorisasi kepada pengguna Google Ads. Kredensial ini mengidentifikasi aplikasi Anda ke Google, sehingga Anda dapat membuat token OAuth untuk mengelola pengguna Google Ads. Akses ke kredensial Google OAuth2 dikelola dari Konsol API Google.
Tonton video ini untuk mengetahui beberapa praktik terbaik project Cloud
Verifikasi OAuth Google
Setiap aplikasi Google Cloud yang digunakan untuk mendapatkan kredensial untuk cakupan Google Ads API harus menjalani verifikasi Google OAuth untuk menghindari layar UI yang belum diverifikasi bagi penggunanya. Dalam konteks ini, aplikasi ditetapkan sebagai Client ID OAuth 2.0 yang unik di Google Cloud.
Verifikasi ini bersifat independen dan sebagai tambahan dari peninjauan yang dilakukan sebagai bagian dari proses persetujuan token developer, dan diperlukan karena cakupan Google Ads API merupakan cakupan sensitif.
Tidak ada biaya untuk verifikasi Google, yang biasanya selesai dalam 3 hingga 5 hari kerja. Kebijakan ini berlaku untuk semua aplikasi.
Sebaiknya semua aplikasi menjalani proses verifikasi Google OAuth sesegera mungkin untuk menghindari gangguan bisnis.
Membuat project
Buka Konsol Google API. Klik Buat project, masukkan nama, lalu klik Buat.
Mengaktifkan Google Ads API di project Anda
Untuk mengaktifkan Google Ads API untuk project Anda, ikuti langkah-langkah berikut:
Buka API Library di Konsol API Google. Jika diminta, pilih project Anda atau buat yang baru. Library API mencantumkan 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 Enable.
Pilih jenis pengguna dan status publikasi
Setelah mengaktifkan API, Anda harus menentukan User type dan Status publikasi project. Tabel berikut menyoroti beberapa atribut dan batasan utama dari setiap kombinasi setelan ini. Untuk mengetahui detail selengkapnya, baca dokumentasi Google Cloud Platform.
Jenis pengguna | Status publikasi | Batasan |
---|---|---|
Internal | Pengujian |
|
Eksternal | Pengujian |
|
Internal | Dalam produksi |
|
Eksternal | Dalam produksi |
|
Jika verifikasi Google OAuth tidak diselesaikan, hal berikut akan terjadi, terlepas dari Jenis pengguna atau Status publikasi project Anda:
Selama proses otorisasi, pengguna akan melihat layar UI yang belum diverifikasi.
Anda hanya dapat memberikan otorisasi kepada 100 pengguna.
Mengonfigurasi layar izin OAuth
Buka halaman Layar Izin, lalu pilih project Anda di menu dropdown di bagian atas halaman.
Pilih User Type dan klik CREATE.
Isi formulir layar izin. Anda dapat mengeditnya nanti jika perlu. Klik SAVE AND CONTINUE setelah selesai.
Di halaman berikutnya, klik TAMBAHKAN ATAU HAPUS SCOPES.
Scroll ke bawah dan masukkan hal berikut pada kolom di bagian Manually add scopes:
https://www.googleapis.com/auth/adwords
Klik TAMBAHKAN KE TABEL.
Tambahkan cakupan lain yang akan diminta project Anda, lalu klik UPDATE.
Klik SIMPAN DAN LANJUTKAN.
Jika Anda tidak berencana untuk segera memublikasikan project, tambahkan alamat email setiap akun pengguna yang akan digunakan untuk pengujian, lalu klik SIMPAN DAN LANJUTKAN.
Tinjau halaman ringkasan dan klik KEMBALI KE DASBOR.
Setelah menguji aplikasi dan proses otorisasi, Anda dapat kembali ke dasbor dan mengklik PUBLISH APP untuk mengubah Status Publikasi dari Pengujian ke Dalam produksi.
Pilih jenis aplikasi
Ada dua opsi jenis aplikasi untuk Google Ads API: Desktop atau Web. Lihat tabel berikut untuk menentukan jenis yang paling sesuai untuk aplikasi yang ingin Anda bangun:
Pilih jenis aplikasi ini | Jika ... |
---|---|
Aplikasi desktop |
|
Aplikasi web |
|
Untuk detail selengkapnya, lihat dokumentasi OAuth Google Identity Platform untuk aplikasi desktop atau aplikasi web.
Membuat client ID dan rahasia klien
Setelah menentukan jenis aplikasi, ikuti petunjuk di bawah untuk membuat client ID dan rahasia klien OAuth2:
Buka halaman Credentials. Pilih project yang telah dibuat sebelumnya atau buat yang baru.
Pada layar Credentials, klik CREATE CREDENTIALS, lalu pilih OAuth client ID.
Jika belum mengonfigurasi layar izin OAuth untuk project ini sebelumnya, Anda akan diarahkan untuk melakukannya sekarang. Klik KONFIGURASI LAYAR IZIN.
Pilih jenis pengguna, lalu klik CREATE.
Isi formulir awal. Anda dapat mengeditnya nanti jika perlu. Klik Simpan setelah selesai.
Buka kembali Credentials > CREATE CREDENTIALS > OAuth client ID untuk melanjutkan.
Pilih Aplikasi desktop atau Aplikasi web sebagai jenis aplikasi, bergantung pada kasus penggunaan Anda.
Beri nama, lalu klik Create.
Jika jenis klien Anda adalah Aplikasi web, tambahkan setidaknya satu URI pengalihan yang diberi otorisasi.
Untuk pengujian lokal yang kompatibel dengan konfigurasi default dalam contoh library klien kami, gunakan
http://127.0.0.1
.Untuk klien aplikasi Desktop, Anda masih akan menggunakan pengalihan IP loopback, tetapi URI-nya tidak dikonfigurasi secara eksplisit di Konsol Cloud.
Di halaman konfirmasi, salin Client ID Anda dan Rahasia Klien Anda ke papan klip, karena Anda akan membutuhkannya saat mengonfigurasi library klien. Anda juga dapat kembali ke halaman kredensial nanti untuk mengambil detail ini.