Cara membuat dan mengonfigurasi project Konsol API Google bergantung pada skenario otorisasi OAuth 2.0 aplikasi Anda. Pilih skenario otorisasi untuk menyesuaikan panduan ini.
Anda memerlukan project Konsol API Google untuk membuat kredensial OAuth 2.0 dan mengaktifkan Google Ads API untuk aplikasi Anda.
Kredensial ini mengautentikasi dan mengizinkan aplikasi atau pengguna Google Ads Anda di server Google dan memungkinkan Anda membuat token OAuth untuk digunakan dalam panggilan ke API.
Pilih atau buat project Konsol API Google
Untuk menyiapkan project baru, ikuti panduan untuk membuat project Konsol API Google. Mengaktifkan penagihan untuk project Anda bersifat opsional. Jika penagihan diaktifkan, pilih akun penagihan untuk project baru. Tidak ada biaya untuk menggunakan Google Ads API, meskipun project Cloud tunduk pada batas kuota project standar.
Aktifkan Google Ads API di project Anda
Untuk mengaktifkan Google Ads API di project Anda, ikuti langkah-langkah berikut:
Buka API Library di Konsol API Google. Jika diminta, pilih project Anda atau buat project baru. Library API menampilkan daftar semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.
Gunakan penelusuran untuk menemukan Google Ads API jika tidak terlihat dalam daftar.
Pilih Google Ads API, lalu klik tombol Aktifkan.
Mengajukan permohonan akses API
Selanjutnya, buka halaman Ringkasan Google Ads API untuk memeriksa tingkat akses API Anda saat ini. Jika tingkat akses API Anda saat ini adalah Test, luaskan bagian Upgrade access level. Ikuti petunjuk untuk mengajukan permohonan tingkat akses Explorer.
Setelah Anda menyelesaikan permohonan, Google akan otomatis meninjau permohonan Anda dan mengupgradenya ke akses Penjelajah dalam sebagian besar kasus.
Mengonfigurasi layar izin OAuth
Saat Anda menggunakan OAuth 2.0 untuk otorisasi, Google akan menampilkan layar izin kepada pengguna, termasuk ringkasan project Anda, kebijakannya, dan cakupan akses otorisasi yang diminta. Mengonfigurasi layar izin OAuth aplikasi Anda akan menentukan apa yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi Anda agar dapat dipublikasikan nanti.
Konfigurasikan layar izin OAuth untuk aplikasi Anda dan tambahkan https://www.googleapis.com/auth/adwords sebagai cakupan OAuth.
Pertimbangan penting untuk jenis pengguna dan status publikasi
Saat mengonfigurasi layar izin OAuth, perhatikan setelan Jenis pengguna dan Status publikasi.
- Jenis pengguna: Menentukan apakah aplikasi Anda dibatasi untuk pengguna dalam organisasi Anda (Internal) atau tersedia untuk pengguna Google mana pun (Eksternal). Internal hanya tersedia jika project Anda adalah bagian dari organisasi Google Workspace.
- Status publikasi: Menentukan apakah aplikasi dalam mode Pengujian (terbatas untuk penguji tertentu yang Anda tambahkan) atau Dalam produksi (tersedia untuk audiens yang ditentukan oleh Jenis pengguna, yang mungkin memerlukan verifikasi aplikasi oleh Google).
Untuk membuat pilihan terbaik bagi aplikasi Anda, tinjau penjelasan dan implikasi mendetail dari setelan ini dalam dokumentasi dukungan resmi Google Cloud:
Memahami setelan ini sangat penting untuk memastikan aplikasi Anda dapat diakses oleh pengguna yang dituju.
Membuat client ID dan rahasia klien
Buat client ID dan secret klien. Anda dapat memilih aplikasi desktop atau aplikasi web sebagai jenis aplikasi. Setelah Anda membuat klien OAuth 2.0, download file JSON klien dengan mengklik tombol Download JSON pada dialog konfirmasi.