Mengonfigurasi Project Konsol API Google untuk Google Ads API

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.

Poin Penting: Jika penagihan diaktifkan, misalnya untuk Google Cloud, Anda harus memilih akun penagihan untuk project baru.

Penggunaan Google Ads API tidak dikenai biaya, tetapi terdapat kuota pada total jumlah project Cloud. Atau, Anda dapat mendaftar untuk membuat Akun Google baru yang mencakup kuota project gratis.

Mengaktifkan Google Ads API di project Anda

Untuk mengaktifkan Google Ads API untuk project Anda, ikuti langkah-langkah berikut:

1. 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.

2. Gunakan penelusuran untuk menemukan Google Ads API jika tidak terlihat dalam daftar.

3. 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	Hanya tersedia untuk project yang terkait dengan Organisasi Google Cloud. Dibatasi hingga 100 pengguna uji coba yang tercantum di layar izin OAuth. Pengguna uji coba harus merupakan pengguna internal di Organisasi Google Cloud yang terkait dengan project. Masa berlaku otorisasi berakhir tujuh hari sejak waktu pemberian izin.
Eksternal	Pengujian	Tersedia untuk semua project. Dibatasi hingga 100 pengguna uji coba yang tercantum di layar izin OAuth. Pengguna uji coba dapat berupa pengguna mana pun yang memiliki Akun Google. Masa berlaku otorisasi berakhir tujuh hari sejak waktu pemberian izin.
Internal	Dalam produksi	Hanya tersedia untuk project yang terkait dengan Organisasi Google Cloud. Memungkinkan pemberian otorisasi kepada pengguna mana pun dalam Organisasi Google Cloud yang terkait dengan project.
Eksternal	Dalam produksi	Tersedia untuk semua project. Memungkinkan memberikan otorisasi kepada pengguna mana pun dengan Akun Google.

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

1. Buka halaman Layar Izin, lalu pilih project Anda di menu dropdown di bagian atas halaman.

2. Pilih User Type dan klik CREATE.

3. Isi formulir layar izin. Anda dapat mengeditnya nanti jika perlu. Klik SAVE AND CONTINUE setelah selesai.

4. 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.

5. Jika Anda tidak berencana untuk segera memublikasikan project, tambahkan alamat email setiap akun pengguna yang akan digunakan untuk pengujian, lalu klik SIMPAN DAN LANJUTKAN.

6. 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	Anda mengelola semua akun Google Ads menggunakan satu akun pengelola tingkat teratas. Anda adalah pengguna pemula, atau ingin memulai cepat dengan penyiapan paling sederhana. Aplikasi Anda hanya akan mengautentikasi pengguna Google dari satu komputer.
Aplikasi web	Anda ingin melakukan autentikasi sebagai pengguna yang dapat memberikan izin ke aplikasi Anda untuk mengakses data akun Google Ads mereka. Anda ingin membuat beberapa kredensial otorisasi dengan mudah, misalnya untuk mengelola akun pihak ketiga. Aplikasi Anda memerlukan URL callback. URL callback tidak didukung dalam alur aplikasi desktop.

Poin Penting: Anda tetap dapat memilih alur aplikasi desktop meskipun sedang mengembangkan aplikasi untuk berjalan di server. Perbedaannya adalah apakah otorisasi OAuth selesai secara lokal atau jarak jauh. Alur desktop memerlukan otorisasi untuk diselesaikan di komputer lokal, sedangkan alur web memungkinkan otorisasi diselesaikan di server otorisasi Google.

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:

1. Buka halaman Credentials. Pilih project yang telah dibuat sebelumnya atau buat yang baru.

2. Pada layar Credentials, klik CREATE CREDENTIALS, lalu pilih OAuth client ID.

   1. Jika belum mengonfigurasi layar izin OAuth untuk project ini sebelumnya, Anda akan diarahkan untuk melakukannya sekarang. Klik KONFIGURASI LAYAR IZIN.

      1. Pilih jenis pengguna, lalu klik CREATE.

      2. Isi formulir awal. Anda dapat mengeditnya nanti jika perlu. Klik Simpan setelah selesai.

   2. Buka kembali Credentials > CREATE CREDENTIALS > OAuth client ID untuk melanjutkan.

3. Pilih Aplikasi desktop atau Aplikasi web sebagai jenis aplikasi, bergantung pada kasus penggunaan Anda.

4. Beri nama, lalu klik Create.

5. 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.

   Catatan: Anda dapat menambahkan nomor port ke URI pengalihan untuk membatasi penggunaan ke port tertentu. Jika port tidak disetel, klien OAuth dapat mengalihkan ke port mana pun.

   Untuk klien aplikasi Desktop, Anda masih akan menggunakan pengalihan IP loopback, tetapi URI-nya tidak dikonfigurasi secara eksplisit di Konsol Cloud.

6. 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.