Menyiapkan project Konsol API Google

Anda memerlukan project Konsol API Google untuk membuat kredensial OAuth 2.0, mengonfigurasi layar izin pengguna, dan mengaktifkan Google Ads API untuk aplikasi Anda.

Kredensial diperlukan untuk autentikasi dan otorisasi pengguna Google Ads oleh server Google. Kredensial ini memungkinkan Anda membuat token OAuth untuk digunakan dalam panggilan ke API.

Pilih atau buat project Konsol API Google

Jika sudah memiliki project Konsol API Google dan ingin menggunakannya untuk membuat kredensial, Anda dapat langsung ke bagian Membuat client ID dan rahasia klien.

Untuk membuat proyek,

  • Buka Konsol API Google
  • Klik Buat project
  • Masukkan nama atau terima saran yang dihasilkan
  • Konfirmasi atau edit kolom yang tersisa
  • Klik Buat

Jika Anda telah mengaktifkan penagihan, pilih akun penagihan untuk project baru. Penggunaan Google Ads API tidak dikenai biaya, tetapi ada kuota untuk total jumlah project Cloud.

Jika Anda menggunakan project Konsol API Google yang sudah ada dan telah mengonfigurasi layar izin OAuth sebelumnya, Anda dapat melewati langkah ini dan mengubah layar izin dengan menambahkan cakupan Google Ads API OAuth 2.0.

Jika Anda menggunakan OAuth 2.0 untuk otorisasi, Google akan menampilkan layar izin kepada pengguna, termasuk ringkasan project Anda, kebijakannya, dan cakupan otorisasi yang diminta. Mengonfigurasi layar izin OAuth aplikasi Anda akan menentukan apa saja yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi agar Anda dapat memublikasikannya nanti.

  1. Buka halaman Layar Izin, lalu pilih project Anda dari menu drop-down 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.
  5. Scroll ke bawah dan masukkan baris berikut pada kolom di bagian Tambahkan cakupan secara manual:

    https://www.googleapis.com/auth/adwords

  6. Klik ADD TO TABLE.
  7. Tambahkan cakupan lain yang mungkin diperlukan project Anda, lalu klik UPDATE.
  8. Klik SIMPAN DAN LANJUTKAN.
  9. Jika Anda tidak berencana untuk segera memublikasikan project, tambahkan alamat email setiap akun pengguna yang mungkin digunakan untuk pengujian, lalu klik SIMPAN DAN LANJUTKAN.
  10. Tinjau halaman ringkasan dan klik KEMBALI KE DASBOR.
  1. Buka halaman Layar Izin, lalu pilih project Anda dari menu drop-down di bagian atas halaman.
  2. Klik EDIT APLIKASI.
  3. Klik SAVE AND CONTINUE di formulir OAuth consent screen.
  4. Di halaman berikutnya, klik TAMBAHKAN ATAU HAPUS SCOPE.
  5. Scroll ke bawah dan masukkan baris berikut pada kolom di bagian Tambahkan cakupan secara manual:

    https://www.googleapis.com/auth/adwords

  6. Klik ADD TO TABLE.
  7. Klik SIMPAN DAN LANJUTKAN.
  8. Klik SIMPAN DAN LANJUTKAN di formulir Pengguna pengujian.
  9. Tinjau halaman ringkasan dan klik KEMBALI KE DASBOR.

Membuat client ID dan rahasia klien

Langkah ini dapat dilewati jika Anda menggunakan project Konsol API Google yang sudah ada, yang sudah memiliki client ID dan rahasia yang dihasilkan.

Setelah menentukan jenis aplikasi, ikuti petunjuk di bawah untuk membuat client ID dan rahasia klien OAuth 2.0:

  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.

    • Jika Anda belum pernah mengonfigurasi layar izin OAuth untuk project ini, klik KONFIGURASI LAYAR IZIN.

      • Pilih jenis pengguna, lalu klik CREATE.

      • Isi formulir awal. Anda dapat mengeditnya nanti jika perlu. Klik Save setelah selesai.

    • 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. Panduan ini menggunakan aplikasi Desktop sebagai jenis aplikasi.

  4. Isi nama aplikasi, lalu klik Create.

  5. Di halaman konfirmasi, salin Client ID Anda dan Rahasia Klien Anda ke papan klip untuk mengonfigurasi library klien nanti. Selain itu, download kredensial dalam format JSON ke file bernama credentials.json.

Mengaktifkan Google Ads API di project Anda

Untuk mengaktifkan Google Ads API di 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.