Mengonfigurasi Project Konsol API Google untuk Google Ads API

Kredensial untuk mengakses server OAuth2 Google diperlukan untuk mengautentikasi dan memberi 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 OAuth2 Google dikelola dari Konsol API Google.

Tonton video ini untuk mengetahui beberapa praktik terbaik project Cloud

Verifikasi Google OAuth

Setiap aplikasi Google Cloud yang digunakan untuk mendapatkan kredensial untuk cakupan Google Ads API harus melakukan verifikasi Google OAuth untuk menghindari layar UI yang tidak terverifikasi bagi penggunanya. Dalam konteks ini, aplikasi ditentukan sebagai Client ID OAuth 2.0 unik di Google Cloud.

Verifikasi ini bersifat independen dan merupakan tambahan dari peninjauan apa pun yang dilakukan sebagai bagian dari proses persetujuan token developer, dan diperlukan karena cakupan Google Ads API adalah cakupan sensitif.

Verifikasi Google tidak dikenai biaya, dan biasanya selesai dalam 3 hingga 5 hari kerja. Kebijakan ini berlaku untuk semua aplikasi.

Sebaiknya semua aplikasi menjalani proses verifikasi OAuth Google sesegera mungkin untuk menghindari gangguan bisnis.

Membuat project

Buka Konsol Google API. Klik Buat project, masukkan nama, dan klik Buat.

Poin Penting: Jika Anda telah mengaktifkan penagihan—misalnya untuk Google Cloud—Anda harus memilih akun penagihan untuk project baru.

Penggunaan Google Ads API tidak dikenai biaya, tetapi ada kuota untuk jumlah total project Cloud. Atau, Anda dapat mendaftar ke Akun Google baru yang menyertakan kuota project gratis.

Mengaktifkan Google Ads API di project Anda

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

1. Buka Library API di Konsol API Google. Jika diminta, pilih project atau buat project baru. Library API menampilkan daftar 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 Aktifkan.

Memilih jenis pengguna dan status publikasi

Setelah mengaktifkan API, Anda harus menentukan Jenis pengguna dan Status publikasi project. Tabel berikut menyoroti beberapa atribut utama dan batasan dari setiap kombinasi setelan ini. Untuk mengetahui detail selengkapnya, lihat 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 pengujian yang tercantum di layar izin OAuth. Pengguna pengujian harus merupakan pengguna internal di Organisasi Google Cloud yang terkait dengan project. Masa berlaku otorisasi berakhir tujuh hari sejak waktu persetujuan.
Eksternal	Pengujian	Tersedia untuk semua project. Dibatasi hingga 100 pengguna pengujian yang tercantum di layar izin OAuth. Pengguna pengujian dapat berupa pengguna mana pun yang memiliki Akun Google. Masa berlaku otorisasi berakhir tujuh hari sejak waktu persetujuan.
Internal	Dalam produksi	Hanya tersedia untuk project yang terkait dengan Organisasi Google Cloud. Memungkinkan otorisasi pengguna dalam Organisasi Google Cloud yang terkait dengan project.
Eksternal	Dalam produksi	Tersedia untuk semua project. Memungkinkan otorisasi pengguna mana pun dengan Akun Google.

Tidak menyelesaikan verifikasi Google OAuth akan menghasilkan hal berikut, 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 Consent Screen, lalu pilih project Anda di menu dropdown di bagian atas halaman.

2. Pilih User Type, lalu klik CREATE.

3. Isi formulir layar izin. Anda dapat mengeditnya nanti jika perlu. Klik SIMPAN DAN LANJUTKAN setelah selesai.

4. Di halaman berikutnya, klik TAMBAHKAN ATAU HAPUS LINGKUP.

   • Scroll ke bawah dan masukkan informasi berikut di kolom di bagian Tambahkan cakupan secara manual:

     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 Anda gunakan untuk pengujian, lalu klik SIMPAN DAN LANJUTKAN.

6. Tinjau halaman ringkasan, lalu klik KEMBALI KE DASBOR.

Setelah menguji aplikasi dan proses otorisasi, Anda dapat kembali ke dasbor dan mengklik PUBLISH APP untuk mengubah Publishing status dari Testing menjadi In production.

Memilih 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 build:

Pilih jenis aplikasi ini	Jika ...
Aplikasi desktop	Anda mengelola semua akun Google Ads menggunakan satu akun pengelola tingkat atas. Anda adalah pengguna pertama kali, atau ingin memulai dengan cepat dengan penyiapan yang paling sederhana. Aplikasi Anda hanya akan mengautentikasi pengguna Google dari satu mesin.
Aplikasi web	Anda ingin melakukan autentikasi sebagai pengguna yang dapat memberikan izin ke aplikasi Anda untuk mengakses data akun Google Ads-nya. 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 masih dapat memilih alur aplikasi desktop meskipun sedang mengembangkan aplikasi untuk dijalankan di server. Perbedaannya adalah apakah otorisasi OAuth selesai secara lokal atau jarak jauh. Alur desktop memerlukan otorisasi untuk selesai di komputer lokal, sedangkan alur web memungkinkan otorisasi untuk selesai di server otorisasi Google.

Untuk mengetahui detail selengkapnya, lihat dokumentasi OAuth Platform Google Identity 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 secret klien OAuth2:

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

2. Di layar Kredensial, 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 CONFIGURE CONSENT SCREEN.

      1. Pilih jenis pengguna, lalu klik CREATE.

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

   2. Kembali ke Credentials > CREATE CREDENTIALS > OAuth client ID untuk melanjutkan.

3. Pilih Desktop app atau Web application 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 diotorisasi.

   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 ditetapkan, klien OAuth dapat mengalihkan ke port apa pun.

   Untuk klien Aplikasi desktop, Anda masih akan menggunakan pengalihan IP loopback, tetapi URI 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 memerlukannya saat mengonfigurasi library klien. Anda juga dapat kembali ke halaman kredensial nanti untuk mengambil detail ini.