Approvazioni da più parti nell'API Google Ads

Giovedì 25 giugno 2026

Nell'ambito del miglioramento della sicurezza degli account Google Ads, l'API Google Ads inizierà a richiedere approvazioni da più parti quando si eseguiranno azioni API sensibili. Questo fa parte di una modifica più ampia in Google Ads che richiede approvazioni da più parti per eseguire azioni sensibili nel tuo account Google Ads. Questi importanti aggiornamenti della sicurezza verranno resi disponibili a partire dal 27 luglio 2026 e verranno attivati per tutti gli utenti nelle prossime settimane.

Che cosa cambierà?

Quando questa modifica diventerà effettiva, il comportamento delle seguenti chiamate API cambierà.

Invita un utente

Se utilizzi il metodo CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation per invitare un nuovo utente a gestire un account Google Ads, l'API Google Ads ora valuta se potrebbe essere necessaria l'approvazione da più parti. Nei casi in cui i nostri server stabiliscono che è necessaria una revisione, il sistema mette in pausa il workflow standard e non genera immediatamente un CustomerUserAccessInvitation né invia l'email di invito. Viene invece avviata una risorsa MultiPartyAuthReview, con il relativo nome della risorsa fornito nella risposta. Una volta che la revisione in attesa riceve l'approvazione di un secondo amministratore account, l'CustomerUserAccessInvitation verrà creato e l'utente invitato riceverà l'email. Non è possibile creare nuovi inviti per l'utente finché la revisione in attesa non viene risolta.

Aggiornamento o revoca dell'accesso di un utente

Se utilizzi il metodo CustomerUserAccessService.MutateCustomerUserAccess per modificare le autorizzazioni di un utente tramite l'operazione di aggiornamento o per revocare l'accesso tramite l'operazione di rimozione, l'API Google Ads ora valuta se potrebbe essere necessaria l'approvazione da più parti. Nei casi in cui i nostri server stabiliscono che è necessaria una revisione, l'API genera una risorsa MultiPartyAuthReview in stato di attesa e restituisce il relativo nome della risorsa. Le modifiche richieste rimarranno in attesa e avranno effetto solo dopo che la revisione da più parti sarà stata approvata da un secondo amministratore dell'account. L'elemento CustomerUserAccess in fase di revisione non può essere modificato finché la revisione in attesa non viene risolta.

Come faccio ad approvare una richiesta di approvazione da più parti?

Puoi recuperare un MultiPartyAuthReview in attesa utilizzando i metodi GoogleAdsService.Search o GoogleAdsService.SearchStream, con la seguente query GAQL. 

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'

Una richiesta MultiPartyAuthReview in attesa può essere approvata o rifiutata utilizzando una richiesta API MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. La revisione deve essere eseguita da un secondo amministratore che non ha creato la richiesta originale. Può trattarsi di una persona o di un service account con privilegi di amministratore. La revisione in attesa può essere revocata dal richiedente originale.

Cosa devo fare?

Se la tua applicazione utilizza questi metodi, assicurati di aggiornarla per gestire i workflow di approvazione da più parti prima del giorno 27 luglio 2026. Abbiamo aggiunto il supporto per le approvazioni da più parti a tutte le versioni principali dell'API (v24.2, v23.3, v22.2 e v21.2). Se utilizzi una libreria client ufficiale, assicurati di scaricarne l'ultima versione. Puoi consultare le seguenti guide per saperne di più su queste modifiche, che includono dettagli su:

Per qualsiasi domanda o ulteriore discussione in merito a questo aggiornamento, contattaci sul server Discord "Google Advertising and Measurement Community". Per richieste di assistenza tecnica, contatta l'indirizzo https://support.google.com/google-ads/contact/google_ads_api

Ritratto dell'autore - , team API Google Ads

Labels: authorization, google-ads-api