Perubahan mendatang pada persetujuan banyak pihak di Google Ads API

Rabu, 4 November 2026

Pada awal tahun ini, Google Ads API mulai mewajibkan persetujuan banyak pihak (MPA) saat melakukan tindakan API sensitif. Mulai minggu 7 Desember 2026, kami akan memperkenalkan perubahan tambahan untuk meningkatkan pengalaman developer terkait persetujuan banyak pihak.

Apa yang berubah?

Pembuatan undangan akses yang ditangguhkan: Jika persetujuan banyak pihak diperlukan, metode CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation akan menangguhkan pembuatan resource undangan akses hingga permintaan persetujuan banyak pihak disetujui. Kolom resource_name tidak diisi dalam kasus tersebut. Setelah permintaan MPA yang tertunda disetujui, resource undangan akses akan tersedia dari hasil peninjauan. Saat ini, metode ini membuat undangan dan menampilkan resource_name undangan, tetapi tidak melakukan tindakan tambahan seperti mengirim email undangan hingga permintaan MPA terkait disetujui.

Kode error baru untuk permintaan yang tidak berlaku: Kami akan mulai menampilkan kode error MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST baru di kolom kegagalan parsial jika permintaan MPA yang tertunda tidak lagi valid karena resource target diubah atau dihapus setelah peninjauan dibuat. Kode error ini akan diperkenalkan dalam rilis v26.2 mendatang. Versi API yang lebih lama (v23 hingga v25) akan menampilkan error MultiPartyAuthReviewError.UNKNOWN, dan kolom unpublished_error_code di GoogleAdsError.details akan ditetapkan ke MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST.

Peningkatan batas untuk peninjauan MPA: Anda dapat menyelesaikan hingga 100 peninjauan MPA yang tertunda dalam satu panggilan ke metode MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Saat ini, metode ini dibatasi untuk satu ulasan per panggilan API.

Tindakan diperlukan

Jika Anda menggunakan persetujuan banyak pihak, tinjau dan perbarui kode Anda untuk mencerminkan perilaku API baru sebelum 7 Desember 2026. Jika Anda menggunakan Google Ads API v26, download library klien terbaru setelah v26.2 dirilis untuk mendapatkan dukungan terkait kode error STALE_MULTI_PARTY_AUTH_REQUEST baru. Lihat panduan teknis kami untuk mempelajari lebih lanjut persetujuan banyak pihak. Untuk masalah dukungan teknis, hubungi dukungan Google Ads API. Jika ada pertanyaan atau ingin mendiskusikan postingan ini, hubungi kami di server Discord Komunitas Pengukuran dan Iklan Google.

Label: authorization, google-ads-api, release