Saat menggunakan Google Ads API, ada beberapa tempat penggunaan alamat email untuk pengelolaan akses dan kontak, yang paling penting adalah sebagai berikut:
- Email kontak Google Ads API: Ini adalah email yang tercantum sebagai kontak di Pusat API UI Google Ads.
- Email akun Konsol Google Cloud: Ini adalah email yang memiliki akses administrator ke akun Konsol Google Cloud yang digunakan untuk aplikasi OAuth 2.0 Anda.
- Email akun pengelola Google Ads: Ini adalah email yang memiliki izin administrator di akun pengelola Google Ads yang Anda akses melalui Google Ads API. Saat membuat token refresh untuk aplikasi, Anda biasanya mengautentikasi aplikasi Google Ads API dengan salah satu email ini.
Sebaiknya Anda menggunakan alias tim bersama agar Anda tidak kehilangan akses ke akun ini saat setiap anggota tim beralih tim atau keluar dari perusahaan. Bagian lainnya dalam panduan ini menguraikan setiap email yang tercantum sebelumnya dan cara memperbaruinya agar menggunakan alias tim bersama, bukan alamat email pengguna perorangan.
Email kontak Google Ads API
Email kontak Google Ads API adalah alamat email yang Anda berikan saat mendaftar ke Google Ads API. Anda harus memastikan akses ke alias ini dan memantau email yang dikirim ke alamat ini secara rutin. Google menggunakan alamat email ini untuk menghubungi tim Anda selama peninjauan API, permintaan audit, atau keadaan darurat produksi yang memerlukan perhatian segera. Gunakan alias tim bersama sebagai email kontak untuk memastikan bahwa seluruh tim menerima notifikasi ini.
Ikuti langkah-langkah berikut untuk memperbarui email kontak API:
- Login ke akun pengelola Google Ads yang Anda gunakan saat mengajukan permohonan akses Google Ads API. Akun ini sama dengan akun tempat token developer Anda berada.
- Buka Alat & Setelan > Pusat API.
- Klik tanda panah di bagian email kontak API.
- Perbarui alamat email, lalu klik tombol Simpan.
Akun Konsol Google Cloud
Project Konsol API Google berisi kredensial OAuth aplikasi Anda dan mengontrol akses ke Google Ads API. Pastikan akses ke akun ini dengan membuat alias bersama sebagai pemilik akun.
Ikuti langkah-langkah berikut untuk memperbarui pemilik project Konsol API Google:
- Login ke Konsol API Google.
- Pilih project Anda dari menu drop-down di sudut kiri atas halaman.
- Buka IAM and admin > IAM dari menu kiri.
- Klik tombol Grant Access.
- Masukkan alamat email bersama di bagian Tambahkan akun utama.
- Tetapkan peran Pemilik.
- Klik tombol Simpan. Lihat dokumentasi Cloud untuk mempelajari lebih lanjut cara memberikan dan mencabut akses.
akun pengelola Google Ads
Metode umum dalam mengelola akun menggunakan Google Ads API adalah dengan menautkan semua akun Anda dalam satu akun pengelola yang sama, dan melakukan panggilan API ke semua akun menggunakan kredensial akun pengelola teratas. Dalam konfigurasi ini:
- Developer menerbitkan token refresh menggunakan kredensial pengguna yang memiliki akses ke akun pengelola Google Ads.
- Developer menetapkan header
login_customer_idsebagai ID pelanggan akun pengelola Google Ads, dan headercustomer_idsebagai ID pelanggan akun yang digunakan untuk melakukan panggilan API.
Salah satu risiko potensial dari penyiapan ini adalah jika pengguna yang diotorisasi kehilangan akses ke akun pengelola Google Ads, token refresh tidak akan valid lagi dan semua panggilan API akan gagal. Untuk menghindari skenario ini, Anda dapat mengundang alias email bersama untuk mengelola akun pengelola Google Ads ini dengan tingkat akses yang sesuai. Gunakan alias email bersama ini untuk menerbitkan token refresh untuk melakukan panggilan API.