Alias bersama

Saat menggunakan Google Ads API, ada beberapa tempat yang menggunakan alamat email untuk pengelolaan kontak dan akses, yang paling penting adalah berikut:

  • Email kontak Google Ads API: Ini adalah email yang tercantum sebagai kontak di Pusat API di UI Google Ads.
  • Email akun Google Cloud Console: Ini adalah email yang memiliki akses administrator ke akun Google Cloud Console 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 ini.

Sebaiknya gunakan alias tim bersama agar Anda tidak kehilangan akses ke akun ini saat setiap anggota tim beralih tim atau meninggalkan perusahaan. Bagian selanjutnya dari panduan ini menjelaskan setiap email yang tercantum sebelumnya dan cara memperbaruinya untuk 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 berkala. 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:

  1. Login ke Akun Pengelola Google Ads.

  2. Klik Admin di kiri bawah layar.

  3. Di bagian Setelan akun pengelola, klik Pusat API.

  4. Di bagian Detail developer, catat email kontak API. Klik panah bawah dan edit email. Klik Save.

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 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 untuk mengelola akun menggunakan Google Ads API adalah dengan menautkan semua akun Anda di akun pengelola umum, 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_id sebagai ID pelanggan akun pengelola Google Ads, dan header customer_id sebagai ID pelanggan akun tempat panggilan API dilakukan.

Salah satu potensi risiko 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 menerbitkan token refresh guna melakukan panggilan API.