Saat menggunakan Google Ads API, ada beberapa tempat yang menggunakan alamat email untuk mengelola kontak dan akses, 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: Email ini 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 Google Ads pengelola yang Anda akses melalui Google Ads API. Saat membuat token refresh untuk aplikasi, Anda biasanya mengautentikasi aplikasi Google Ads API dengan salah satu email tersebut.
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 selanjutnya dalam panduan ini menguraikan setiap email yang tercantum sebelumnya dan cara memperbaruinya menjadi menggunakan alias tim bersama, bukan alamat email pengguna individual.
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 Tools & Settings > API Center.
- Klik tanda panah di bagian Email kontak API.
- Perbarui alamat email dan 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 menjadikan 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 pojok kiri atas halaman.
- Buka IAM dan admin > IAM dari menu kiri.
- Klik tombol Grant Access.
- Masukkan alamat email yang dibagikan 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 untuk 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 mengeluarkan 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 menjadi tujuan panggilan API.
Salah satu potensi risiko dari penyiapan ini adalah jika pengguna yang diberi otorisasi kehilangan akses ke akun pengelola Google Ads, token refresh tidak lagi valid 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 mengeluarkan token refresh untuk melakukan panggilan API.