Mercoledì 4 novembre 2026
All'inizio di quest'anno, l'API Google Ads ha iniziato a richiedere approvazioni da più parti (MPA) quando si eseguono azioni API sensibili. A partire dalla settimana del 7 dicembre 2026, introdurremo ulteriori modifiche per migliorare l'esperienza degli sviluppatori per le approvazioni da più parti.
Cosa cambierà?
Creazione di un invito di accesso differito: se è richiesta un'approvazione da più parti, il metodo CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation rimanderà la creazione della risorsa di invito di accesso fino all'approvazione della richiesta di approvazione da più parti. In questi casi, il campo resource_name non viene compilato. Una volta approvata la richiesta MPA in attesa, la risorsa di invito all'accesso è disponibile nei risultati della revisione. Al momento, questo metodo crea l'invito e restituisce il resource_name dell'invito, ma non esegue azioni aggiuntive come l'invio di un'email di invito finché la richiesta MPA associata non viene approvata.
Nuovo codice di errore per le richieste non aggiornate: inizieremo a restituire un nuovo codice di errore MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST nel campo di errore parziale quando una richiesta MPA in attesa non è più valida perché la risorsa di destinazione è stata modificata o eliminata dopo la creazione della revisione. Questo codice di errore verrà introdotto nella prossima release v26.2. Le versioni precedenti dell'API (dalla v23 alla v25) restituiranno un errore MultiPartyAuthReviewError.UNKNOWN e il campo unpublished_error_code in GoogleAdsError.details verrà impostato su MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST.
Limiti aumentati per le revisioni MPA: puoi risolvere fino a 100 revisioni MPA in attesa in una singola chiamata al metodo MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. Al momento, questo metodo è limitato a una recensione per chiamata API.
Azione richiesta
Se utilizzi le approvazioni da più parti, rivedi e aggiorna il codice in modo che rifletta il nuovo comportamento dell'API prima del 7 dicembre 2026. Se utilizzi la versione 26 dell'API Google Ads, scarica le librerie client più recenti dopo il rilascio della versione 26.2 per ricevere assistenza per il nuovo codice di errore STALE_MULTI_PARTY_AUTH_REQUEST. Consulta le nostre guide tecniche per scoprire di più sulle approvazioni da più parti. Per richieste di assistenza tecnica, contatta l'assistenza API Google Ads. Se hai domande o vuoi discutere di questo post, contattaci sul nostro server Discord della community di Google Advertising and Measurement.
- Anash P. Oommen, team API Google Ads
Etichette: authorization, google-ads-api, release