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 ke Google, sehingga Anda dapat membuat token OAuth untuk mengelola Google Ads pelanggan. Akses ke kredensial Google OAuth2 dikelola dari Konsol API Google.

Tonton video ini untuk mengetahui beberapa praktik terbaik project Cloud

Verifikasi OAuth Google

Semua aplikasi Google Cloud yang digunakan untuk mendapatkan kredensial untuk cakupan Google Ads API harus untuk menjalani pelatihan Google OAuth verifikasi untuk menghindari layar UI yang belum diverifikasi untuk pelanggan. Dalam konteks ini, aplikasi ditetapkan sebagai Client ID OAuth 2.0 yang unik atau komponen lainnya di Google Cloud.

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

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

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

Membuat project

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

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

Penggunaan Google Ads API tidak dikenai biaya, tetapi ada total kuota jumlah project Cloud tertentu. Atau, Anda dapat mendaftar untuk Akun 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 API Library di Konsol API Google. Jika diminta, pilih atau membuat yang baru. Library API mencantumkan semua daftar yang tersedia API, 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 kemudian harus menentukan User type dan Status publikasi. Tabel berikut menyoroti beberapa atribut utama dan batasan dari setiap kombinasi setelan ini. Untuk detail selengkapnya, lihat Google Cloud Platform dokumentasi tambahan.

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

Tidak menyelesaikan Google OAuth verifikasi menghasilkan hal berikut, terlepas dari Jenis pengguna atau Publikasi status project Anda:

• Selama proses otorisasi, pengguna akan melihat UI yang belum terverifikasi layar.

• Anda hanya dapat memberikan otorisasi kepada 100 pengguna.

Mengonfigurasi layar izin OAuth

1. Buka Halaman Layar Izin, dan pilih proyek Anda dari menu {i>dropdown<i} di bagian atas halaman.

2. Pilih User Type dan klik CREATE.

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

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

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

     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 dan klik KEMBALI KE DASBOR.

Setelah menguji aplikasi dan proses otorisasi, Anda dapat kembali ke dasbor dan klik PUBLIKASIKAN APLIKASI untuk mengubah Publikasi status 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 Anda inginkan untuk membangun:

Pilih jenis aplikasi ini	Jika ...
Aplikasi desktop	Anda mengelola semua akun Google Ads menggunakan satu akun tingkat teratas akun pengelola. Anda adalah pengguna pemula, atau ingin mulai secara cepat dengan cara penyiapan. 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, untuk mengelola akun pihak ketiga. Aplikasi Anda memerlukan URL callback. URL callback tidak didukung dalam aplikasi desktop.

Poin Penting: Anda tetap dapat memilih alur aplikasi desktop bahkan jika Anda mengembangkan aplikasi untuk berjalan di server. Perbedaannya adalah apakah otorisasi OAuth diselesaikan secara lokal atau jarak jauh. Alur desktop membutuhkan otorisasi untuk diselesaikan di komputer lokal, sedangkan aliran web memungkinkan otorisasi untuk 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 ID klien 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 Anda 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 jika sudah selesai.

   2. Kembali ke Credentials > BUAT KREDENSIAL > Client ID OAuth untuk melanjutkan.

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

4. Beri nama, lalu klik Create.

5. Jika jenis klien Anda adalah Aplikasi web, tambahkan setidaknya satu jenis klien yang diotorisasi URI pengalihan.

   Untuk pengujian lokal yang kompatibel dengan konfigurasi default pada contoh library klien, gunakan http://127.0.0.1.

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

   Untuk klien aplikasi Desktop, Anda akan tetap menggunakan pengalihan IP loopback, tetapi URI tersebut tidak dikonfigurasi secara eksplisit di Cloud Console.

6. Pada halaman konfirmasi, salin Client ID Anda dan Rahasia Klien Anda ke papan klip, karena Anda akan memerlukannya saat mengonfigurasi klien library. Anda juga dapat kembali ke halaman kredensial nanti untuk mengambil kredensial tersebut spesifikasi pendukung.