Alias bersama

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

  • Email kontak Google Ads API: Ini adalah email yang tercantum sebagai kontak di Pusat API di 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 Google Ads pengelola yang Anda akses melalui Google Ads API. Saat membuat token refresh untuk aplikasi Anda, biasanya Anda mengautentikasi aplikasi Google Ads API dengan salah satu email ini.

Sebaiknya gunakan alias tim bersama agar Anda tidak kehilangan akses ke akun ini saat anggota tim individu berpindah tim atau keluar dari perusahaan. Bagian selanjutnya dari 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 berkala. Google menggunakan alamat email ini untuk menghubungi tim Anda selama peninjauan API, permintaan audit, atau situasi 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 Anda.

  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 drop-down 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 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. Baca 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 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 yang melakukan panggilan API.

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.