Persetujuan banyak pihak di Google Ads API

Kamis, 25 Juni 2026

Sebagai bagian dari upaya peningkatan keamanan akun Google Ads, Google Ads API akan mulai mewajibkan persetujuan banyak pihak saat melakukan tindakan API sensitif. Perubahan ini merupakan bagian dari perubahan yang lebih luas di Google Ads yang mewajibkan persetujuan banyak pihak untuk melakukan tindakan sensitif di akun Google Ads Anda. Update keamanan penting ini akan mulai diluncurkan pada 27 Juli 2026, dan akan diaktifkan untuk semua pengguna dalam beberapa minggu ke depan.

Apa saja yang berubah?

Saat perubahan ini diterapkan, panggilan API berikut akan mengubah perilakunya.

Mengundang pengguna

Jika Anda menggunakan metode CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation untuk mengundang pengguna baru guna mengelola akun Google Ads, Google Ads API kini akan mengevaluasi apakah persetujuan banyak pihak mungkin diperlukan. Jika server kami menentukan bahwa peninjauan diperlukan, sistem akan menjeda alur kerja standar dan tidak akan langsung membuat CustomerUserAccessInvitation atau mengirim email undangan. Sebagai gantinya, resource MultiPartyAuthReview akan dimulai, dengan nama resource-nya diberikan dalam respons. Setelah peninjauan yang tertunda menerima persetujuan dari administrator akun kedua, CustomerUserAccessInvitation akan dibuat dan pengguna yang diundang akan menerima emailnya. Undangan baru tidak dapat dibuat untuk pengguna hingga peninjauan yang tertunda diselesaikan.

Memperbarui atau menghentikan akses pengguna

Jika Anda menggunakan metode CustomerUserAccessService.MutateCustomerUserAccess untuk menyesuaikan izin pengguna menggunakan operasi update atau mencabut akses menggunakan operasi penghapusan, Google Ads API kini akan mengevaluasi apakah persetujuan banyak pihak mungkin diperlukan. Jika server kami menentukan bahwa peninjauan diperlukan, API akan menghasilkan resource MultiPartyAuthReview dalam status tertunda dan menampilkan nama resource-nya. Perubahan yang Anda minta akan tetap tertunda dan hanya akan diterapkan setelah peninjauan banyak pihak berhasil disetujui oleh administrator kedua di akun. CustomerUserAccess yang sedang ditinjau tidak dapat diubah hingga peninjauan yang tertunda diselesaikan.

Bagaimana cara menyetujui permintaan persetujuan banyak pihak?

Anda dapat mengambil MultiPartyAuthReview yang tertunda menggunakan metode GoogleAdsService.Search atau GoogleAdsService.SearchStream, menggunakan kueri GAQL berikut. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

Permintaan MultiPartyAuthReview yang tertunda dapat disetujui atau ditolak menggunakan permintaan API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Peninjauan harus dilakukan oleh administrator kedua yang tidak membuat permintaan awal. Akun ini dapat berupa akun pengguna atau akun layanan dengan hak istimewa administrator. Peninjauan yang tertunda dapat dicabut oleh pemohon asli.

Apa yang harus saya lakukan?

Jika aplikasi Anda menggunakan metode ini, pastikan untuk mengupdatenya agar dapat menangani alur kerja persetujuan banyak pihak sebelum 27 Juli 2026. Kami telah menambahkan dukungan untuk persetujuan banyak pihak ke semua versi utama API (v24.2, v23.3, v22.2, dan v21.2). Jika Anda menggunakan library klien resmi, pastikan untuk mendownload versi terbarunya. Anda dapat melihat panduan berikut untuk mempelajari lebih lanjut perubahan ini, yang mencakup detail tentang

Jika ada pertanyaan atau diskusi lebih lanjut terkait perubahan ini, hubungi kami di server Discord "Google Advertising and Measurement Community". Untuk masalah dukungan teknis, hubungi https://support.google.com/google-ads/contact/google_ads_api

Potret penulis - , Tim Google Ads API

Label: authorization, google-ads-api