Saat menggunakan Google Ads API, alamat email digunakan di beberapa tempat untuk pengelolaan kontak dan akses. Yang paling penting di antaranya adalah:
- Email kontak Google Ads API: Alamat email yang diberi peran Pemilik atau Editor di project Google Cloud Anda, yang digunakan Google untuk mengirim Pengumuman Layanan Wajib (MSA) dan notifikasi administratif.
- Email akun Konsol Google Cloud: Email yang memiliki akses administrator ke project Google Cloud yang digunakan untuk aplikasi OAuth 2.0 Anda.
- Akses akun pengelola Google Ads: Akun layanan (direkomendasikan) atau alias email bersama yang memiliki izin akses di akun pengelola Google Ads yang diakses melalui Google Ads API.
Bagian selanjutnya dari panduan ini menguraikan setiap akun yang tercantum sebelumnya dan cara mengonfigurasinya agar integrasi Anda tidak bergantung pada alamat email pengguna perorangan.
Email kontak Google Ads API
Google mengirimkan notifikasi administratif, info terbaru peninjauan API, permintaan audit, Email Pengumuman Layanan (MSA), dan komunikasi darurat produksi ke alamat email yang terkait dengan peran Pemilik dan Editor project Google Cloud Anda (lihat Email kontak API baru, karena setelan email kontak Pusat API lama di UI Google Ads telah dihentikan).
Untuk memperbarui email kontak dan memastikan seluruh tim Anda menerima notifikasi ini, berikan peran Pemilik atau Editor ke alias tim bersama di project Google Cloud Anda dan pantau email yang dikirim ke alias tersebut secara rutin.
Akun Konsol Google Cloud
Project Konsol Google Cloud berisi kredensial OAuth aplikasi Anda dan mengontrol akses ke Google Ads API. Pastikan akses ke project ini dengan memberikan peran Owner (atau Editor) kepada alias tim bersama.
Ikuti langkah-langkah berikut untuk menambahkan alias bersama sebagai pemilik project Google Cloud:
- Login ke Konsol Google Cloud.
- Pilih project Anda dari pemilih project di bagian atas halaman.
- Di menu navigasi, buka IAM & Admin > IAM.
- Klik Grant Access.
- Di bagian Add principals, masukkan alamat email bersama di kolom New principals.
- Di bagian Assign roles, klik Select a role, lalu pilih Basic > Owner (atau Basic > Editor).
- Klik Simpan. Jika Anda memberikan peran Pemilik ke alamat email di luar organisasi Google Cloud Anda (atau pada project tanpa organisasi), Google Cloud akan mengirimkan email undangan ke alias bersama yang harus diterima sebelum peran tersebut berlaku. Lihat dokumentasi Cloud untuk mempelajari lebih lanjut cara memberikan dan mencabut akses.
akun pengelola Google Ads
Metode umum untuk mengelola akun menggunakan Google Ads API adalah dengan menautkan semua akun Anda di bawah akun pengelola umum, dan melakukan panggilan API ke semua akun menggunakan kredensial akun pengelola teratas. Dalam konfigurasi ini, developer menetapkan header permintaan login-customer-id
(atau setelan konfigurasi library klien login_customer_id) ke ID pelanggan
10 digit (tanpa tanda hubung) akun pengelola Google Ads, dan menetapkan customer_id
target ke akun operasi tempat panggilan API dilakukan.
Direkomendasikan: Menggunakan akun layanan
Menggunakan akun layanan adalah pendekatan yang lebih disukai untuk mengautentikasi dan mengakses akun pengelola Google Ads. Tidak seperti akun pengguna perorangan, akun layanan dikelola dalam project Google Cloud Anda dan tidak terkait dengan orang tertentu, sehingga mencegah pemadaman layanan saat anggota tim berganti peran atau keluar dari perusahaan. Ikuti panduan akun layanan untuk membuat akun layanan dan memberinya akses ke akun pengelola Google Ads Anda.
Alternatif: Menggunakan alias email bersama
Jika integrasi Anda tidak dapat menggunakan akun layanan dan mengandalkan alur kerja autentikasi pengguna tunggal, pengguna yang memiliki akses ke akun pengelola Google Ads akan menerbitkan token refresh OAuth 2.0.
Untuk menghindari skenario ini saat menggunakan kredensial pengguna:
- Undang alias email bersama (didukung oleh Akun Google aktif dengan verifikasi kunci sandi diaktifkan) untuk mengelola akun pengelola Google Ads ini dengan tingkat akses yang sesuai.
- Terima undangan menggunakan alias email bersama.
- Gunakan alias email bersama ini untuk menerbitkan token refresh OAuth guna melakukan panggilan API.