Approbations multipartites dans l'API Google Ads

Jeudi 25 juin 2026

Afin d'améliorer la sécurité des comptes Google Ads, l'API Google Ads exigera dorénavant des approbations multipartites pour effectuer des actions sensibles. Cette modification s'inscrit dans un changement plus vaste dans Google Ads, qui nécessite des approbations multipartites pour effectuer des actions sensibles dans votre compte Google Ads. Ces importantes mises à jour de sécurité seront déployées à partir du 27 juillet 2026 et entreront en vigueur pour tous les utilisateurs au cours des prochaines semaines.

Qu'est-ce qui change ?

Lorsque ce changement sera effectif, le comportement des appels d'API suivants sera modifié.

Inviter un utilisateur

Si vous utilisez la méthode CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation pour inviter un nouvel utilisateur à gérer un compte Google Ads, l'API Google Ads évalue désormais si l'approbation multipartite est nécessaire. Lorsque nos serveurs déterminent qu'un examen est nécessaire, le système suspend le workflow standard et ne génère pas immédiatement de CustomerUserAccessInvitation ni n'envoie l'e-mail d'invitation. Une ressource MultiPartyAuthReview est lancée à la place, avec son nom de ressource fourni dans la réponse. Une fois que l'examen en attente est approuvé par un deuxième administrateur du compte, le CustomerUserAccessInvitation est créé et l'utilisateur invité reçoit son e-mail. Aucune nouvelle invitation ne peut être créée pour l'utilisateur tant que l'examen en attente n'est pas terminé.

Modifier ou résilier l'accès d'un utilisateur

Si vous utilisez la méthode CustomerUserAccessService.MutateCustomerUserAccess pour ajuster les autorisations d'un utilisateur à l'aide de l'opération de mise à jour ou pour révoquer l'accès à l'aide de l'opération de suppression, l'API Google Ads évalue désormais si une approbation multipartite est nécessaire. Lorsque nos serveurs déterminent qu'un examen est nécessaire, l'API génère une ressource MultiPartyAuthReview en attente et renvoie son nom de ressource. Les modifications demandées resteront en attente et ne prendront effet qu'une fois que l'approbation multipartite aura été validée par un deuxième administrateur de compte. L'élément CustomerUserAccess en cours d'examen ne peut pas être modifié tant que l'examen en attente n'est pas terminé.

Comment approuver une demande d'approbation multipartite ?

Vous pouvez récupérer un MultiPartyAuthReview en attente à l'aide des méthodes GoogleAdsService.Search ou GoogleAdsService.SearchStream, en utilisant la requête GAQL suivante. 

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'

Une requête MultiPartyAuthReview en attente peut être approuvée ou refusée à l'aide d'une requête API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. L'examen doit être effectué par un deuxième administrateur qui n'a pas créé la demande d'origine. Il peut s'agir d'un utilisateur ou d'un compte de service disposant de droits d'administrateur. L'examen en attente peut être révoqué par le demandeur d'origine.

Que dois-je faire ?

Si votre application utilise ces méthodes, veillez à la mettre à jour pour qu'elle prenne en charge les workflows d'approbation multipartite avant le 27 juillet 2026. Nous avons ajouté la prise en charge des approbations multipartites à toutes les versions majeures de l'API (v24.2, v23.3, v22.2 et v21.2). Si vous utilisez une bibliothèque cliente officielle, assurez-vous de télécharger la dernière version. Pour en savoir plus sur ces changements, consultez les guides suivants, qui détaillent les points ci-dessous :

Si vous avez des questions ou souhaitez discuter de cette modification, n'hésitez pas à nous contacter sur le serveur Discord de la communauté Google Advertising and Measurement. Pour toute demande d'assistance technique, contactez https://support.google.com/google-ads/contact/google_ads_api.

Portrait de l'auteur - , équipe API Google Ads

Libellés : authorization, google-ads-api