Mengelola akses pengguna

Sebagai administrator, Anda dapat mengelola tingkat akses dan peran pengguna untuk akun Google Ads Anda. Anda dapat mengambil dan memperbarui peran pengguna, mengirim undangan pengguna, dan menghentikan akses pengguna ke akun menggunakan Google Ads API. Pelajari lebih lanjut tingkat akses akun.

Untuk mengelola akses pengguna, akun pengguna atau akun layanan yang memanggil harus memiliki akses ADMIN ke akun target.

Mengundang pengguna

Untuk mengundang pengguna baru agar dapat mengakses akun, gunakan CustomerUserAccessInvitationService untuk membuat dan mengirim undangan (lihat Mengelola undangan akses pengguna). Setelah pengguna menerima undangan, mereka akan muncul sebagai pengguna yang dikonfirmasi di bagian CustomerUserAccess.

Mengambil peran pengguna

Anda bisa mendapatkan daftar pengguna yang memiliki akses ke akun dengan membuat pernyataan Bahasa Kueri Google Ads untuk mengkueri semua entitas CustomerUserAccess yang terkait dengan ID pelanggan. Berikut adalah kueri umum:

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

Mengubah peran pengguna

Untuk memperbarui peran pengguna yang ada, panggil CustomerUserAccessService.MutateCustomerUserAccess menggunakan operasi UPDATE. Saat mengubah peran pengguna, Anda harus memberikan:

• Nama resource entitas CustomerUserAccess yang akan diubah, dalam format customers/{customer_id}/customerUserAccesses/{user_id}.
• Peran pengguna baru di access_role.
• update_mask (FieldMask) yang menentukan access_role.

Hapus pengguna

Untuk menghentikan akses pengguna ke akun, panggil CustomerUserAccessService.MutateCustomerUserAccess dengan operasi REMOVE yang menentukan nama resource (customers/{customer_id}/customerUserAccesses/{user_id}).

Persetujuan banyak pihak untuk perubahan akses

Jika permintaan persetujuan banyak pihak dipicu saat memanggil MutateCustomerUserAccess:

• Objek MutateCustomerUserAccessResult (yang terdapat dalam kolom result dari MutateCustomerUserAccessResponse) akan mengisi kolom multi_party_auth_review dengan nama resource ulasan tertunda yang memerlukan persetujuan.
• Kolom resource_name di MutateCustomerUserAccessResult tidak akan diisi.
• Permintaan peninjauan yang tertunda dapat disetujui atau ditolak oleh administrator kedua menggunakan metode MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Lihat panduan persetujuan banyak pihak untuk mempelajari lebih lanjut.