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 Google OAuth2 dikelola dari Konsol API Google.

Tonton video ini untuk mengetahui beberapa praktik terbaik project Cloud

Verifikasi Google OAuth

Semua aplikasi Google Cloud yang digunakan untuk mendapatkan kredensial untuk cakupan Google Ads API harus menjalani verifikasi OAuth Google agar layar UI yang belum diverifikasi tidak ditampilkan bagi penggunanya. Dalam konteks ini, aplikasi didefinisikan sebagai Client ID OAuth 2.0 unik di Google Cloud.

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

Verifikasi Google tidak dikenai biaya, yang biasanya selesai dalam waktu 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:

  1. Buka API Library di Konsol API Google. Jika diminta, pilih proyek 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 Aktifkan.

Pilih jenis pengguna dan status publikasi

Setelah mengaktifkan API, Anda harus menentukan User type dan Publishing status project Anda. Tabel berikut menyoroti beberapa atribut utama dan batasan dari setiap kombinasi setelan ini. Untuk 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 uji coba yang tercantum di layar izin OAuth.
  • Pengguna pengujian harus merupakan pengguna internal di Organisasi Google Cloud yang terkait dengan project.
  • Otorisasi berakhir tujuh hari setelah tanggal 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.
  • Otorisasi berakhir tujuh hari setelah tanggal pemberian izin.
Internal Dalam produksi
  • Hanya tersedia untuk project yang terkait dengan Organisasi Google Cloud.
  • Memungkinkan pemberian otorisasi kepada setiap pengguna dalam Organisasi Google Cloud yang terkait dengan project.
Eksternal Dalam produksi
  • Tersedia untuk semua project.
  • Memungkinkan pemberian otorisasi kepada setiap pengguna dengan Akun Google.

Jika verifikasi Google OAuth tidak diselesaikan, hal berikut akan terjadi, terlepas dari Jenis pengguna atau Status publikasi project Anda:

  1. Buka halaman Layar Izin, lalu pilih project Anda dari 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 SCOPE.

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

      https://www.googleapis.com/auth/adwords
      
    • Klik ADD TO TABLE.

    • Tambahkan cakupan lain yang akan diminta project Anda, lalu klik PERBARUI.

    • 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 PUBLIKASIKAN APLIKASI untuk mengubah Status publikasi dari Pengujian menjadi 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 pengguna pemula, atau ingin segera memulai dengan penyiapan yang 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 miliknya.
  • Anda ingin dengan mudah membuat beberapa kredensial otorisasi, untuk mengelola akun pihak ketiga.
  • Aplikasi Anda memerlukan URL callback. URL callback tidak didukung dalam alur aplikasi desktop.

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 dibuat sebelumnya atau buat yang baru.

  2. Di layar Kredensial, klik BUAT KREDENSIAL, lalu pilih client ID OAuth.

    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 Save setelah selesai.

    2. Buka kembali Credentials > CREATE KREDENTIALS > 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 diotorisasi.

    Untuk pengujian lokal yang kompatibel dengan konfigurasi default dalam contoh library klien kita, 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 Cloud Console.

  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.