Intégrations qui appellent CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation pour inviter un utilisateur sur un compte Google Ads soumis à approbation multipartite, ou qui résolvent des revues MPA via MultiPartyAuthReviewService.ResolveMultiPartyAuthReview.
Gestion des accès · API Google Ads
Google Ads : invitation d'accès différée dès le 7 décembre 2026
À adapter avant le 7 décembre 2026Échéance : 7 décembre 2026État de la documentation au : 5 novembre 2026
Ne pas perdre cette date
Ajouter l’échéance au calendrier
La date est enregistrée comme une journée entière. La fiche reste la source à consulter en cas de report.
01 · Mécanisme
Ce qui change réellement
Le Google Ads Developer Blog rappelle que l'API Google Ads exige depuis 2026 des approbations multipartites (MPA) pour les actions sensibles. À partir de la semaine du 7 décembre 2026, Google introduit trois changements pour ces approbations. Premier changement : lorsqu'une approbation multipartite est requise, la méthode CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation diffère la création de la ressource d'invitation d'accès jusqu'à l'approbation de la demande MPA, et le champ resource_name n'est alors pas renseigné ; une fois la demande approuvée, l'invitation devient disponible depuis les résultats de la revue. Actuellement, cette méthode crée l'invitation et renvoie son resource_name immédiatement, sans effectuer d'autre action, comme l'envoi de l'e-mail d'invitation, avant l'approbation de la demande MPA.
Deuxième changement : un nouveau code d'erreur MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST, introduit en v26.2, est renvoyé dans le champ d'échec partiel quand une demande MPA en attente devient invalide parce que la ressource ciblée a été modifiée ou supprimée après la création de la revue ; les versions v23 à v25 renvoient à la place MultiPartyAuthReviewError.UNKNOWN, avec le champ unpublished_error_code de GoogleAdsError.details positionné à MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST. Troisième changement : jusqu'à 100 revues MPA en attente peuvent être résolues par un seul appel à MultiPartyAuthReviewService.ResolveMultiPartyAuthReview, contre une seule aujourd'hui. Google demande à qui utilise les approbations multipartites de revoir et d'adapter son code avant le 7 décembre 2026.
02 · Impact
Ce que cela change dans le mix
Les intégrations qui lisent resource_name juste après l'appel de création d'une invitation d'accès, et supposent qu'il est systématiquement renseigné, peuvent échouer ou enregistrer une valeur vide lorsque l'invitation attend une approbation multipartite : ce champ reste vide tant que la demande MPA n'est pas approuvée. Le risque porte sur les outils d'agence et les connecteurs qui automatisent l'ouverture d'accès aux comptes Google Ads soumis à approbation multipartite.
Les intégrations qui traitent MultiPartyAuthReviewError.UNKNOWN pour une demande MPA devenue invalide doivent aussi reconnaître le nouveau code MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST en v26.2, pendant que les versions v23 à v25 continuent de renvoyer UNKNOWN avec l'identifiant précis dans unpublished_error_code. Les intégrations qui résolvent les revues MPA une par une peuvent aussi regrouper jusqu'à 100 résolutions par appel à MultiPartyAuthReviewService.ResolveMultiPartyAuthReview.
03 · Périmètre
Qui doit reparamétrer
Les appels de MutateCustomerUserAccessInvitation qui ne déclenchent pas d'approbation multipartite : ils continuent de renvoyer resource_name immédiatement, sans changement de comportement.
04 · Réglages
Qu’est-ce que je reparamètre ?
- 01
Recenser les appels de création d'invitation
Lister les services, scripts et outils qui appellent CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation pour des comptes soumis à approbation multipartite, et rattacher chacun à un responsable identifié.
- Avant quand
- Avant le 7 décembre 2026
- Où
- Google Ads API · Service CustomerUserAccessInvitationService
- 02
Adapter la lecture de resource_name
Avant le 7 décembre 2026, modifier chaque intégration pour qu'un resource_name non renseigné après l'appel de MutateCustomerUserAccessInvitation soit traité comme une invitation en attente d'approbation multipartite, récupérable ensuite depuis les résultats de la revue, et non comme une erreur.
- Avant quand
- Avant le 7 décembre 2026
- Où
- Code appelant · champ resource_name renvoyé par MutateCustomerUserAccessInvitation
- 03
Traiter le nouveau code d'erreur
Avant le 7 décembre 2026, mettre à jour le traitement des erreurs pour reconnaître MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST en v26.2, et son équivalent MultiPartyAuthReviewError.UNKNOWN avec unpublished_error_code en v23 à v25.
- Avant quand
- Avant le 7 décembre 2026
- Où
- Code appelant · champ d'échec partiel, GoogleAdsError.details.unpublished_error_code
- 04
Télécharger les bibliothèques clientes v26.2
Avant le 7 décembre 2026, vérifier si v26.2 est publiée et, dès sa publication, télécharger les bibliothèques clientes Google Ads API v26 mises à jour, qui portent le support du code STALE_MULTI_PARTY_AUTH_REQUEST.
- Avant quand
- Avant le 7 décembre 2026
- Où
- Bibliothèques clientes Google Ads API v26
- 05
Regrouper la résolution des revues MPA
À partir du 7 décembre 2026, adapter les appels à MultiPartyAuthReviewService.ResolveMultiPartyAuthReview pour résoudre jusqu'à 100 revues MPA en attente par appel, au lieu d'une seule.
- Avant quand
- À partir du 7 décembre 2026
- Où
- Google Ads API · Service MultiPartyAuthReviewService
05 · Rectification
Ce qui circule et ce qui est exact
resource_name reste toujours renseigné immédiatement après l'appel de création d'une invitation d'accès.
À partir de la semaine du 7 décembre 2026, resource_name n'est pas renseigné quand l'invitation est soumise à approbation multipartite : il devient disponible seulement depuis les résultats de la revue, une fois la demande approuvée.
06 · Preuves
Sources primaires
07 · Révisions
Historique public
Création et vérification sur la documentation primaire.