I test sono un passaggio importante per creare un'integrazione dell'API Google Ads efficace, che tu stia iniziando, gestendo un'app o aggiungendo nuove funzionalità a un'integrazione esistente. Questa guida presenta alcune best practice per testare l'integrazione dell'API Google Ads.
Account di test e account di produzione
Gli account di test sono disponibili per scopi di sviluppo. Con gli account di test, puoi verificare che il codice dell'applicazione e la configurazione funzionino come previsto.
Tuttavia, non tutte le funzionalità possono essere testate in un account di test.
Quando le limitazioni dell'account di test ti impediscono di testare alcune funzionalità dell'integrazione, puoi utilizzare un account di produzione per lo sviluppo. Il tuo
progetto Google Cloud deve avere almeno il
livello di accesso Explorer (Explorer, Basic o Standard) per
chiamare un account di produzione. Tieni presente che l'accesso Explorer limita ancora alcuni servizi, tra cui la fatturazione (BillingSetupService e AccountBudgetProposalService), la pianificazione, la creazione di account e gli inviti agli utenti (vedi Limitazioni delle funzionalità di Explorer), che richiedono l'accesso di base o standard. Il tentativo di chiamare un account di produzione da un progetto con il livello di accesso Test restituisce AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION a partire dal giorno v25 o AuthorizationError.ACTION_NOT_PERMITTED nel giorno v24 e in precedenza.
Gli account di produzione per lo sviluppo differiscono dagli account di test nei seguenti modi:
- Pubblica annunci visibili agli utenti
- Richiedere URL validi
- Deve rispettare le norme pubblicitarie
Poiché gli account di produzione pubblicano annunci, generano metriche che ti consentono di testare i report sul rendimento, nonché di sbloccare tutte le altre funzionalità dell'API Google Ads. Tuttavia, il loro utilizzo per lo sviluppo richiede maggiore cautela. Ti consigliamo di adottare le seguenti misure:
- Concedi l'accesso solo agli utenti che ne hanno bisogno per scopi di sviluppo.
- Imposta un budget dell'account giornaliero fisso e basso.
- Utilizza gli account di produzione per lo sviluppo solo quando non è possibile utilizzare gli account di test.
Pertanto, per eseguire test completi dell'integrazione, probabilmente avrai bisogno sia delle credenziali di test sia di quelle di produzione.
Credenziali di test
Per ridurre al minimo il rischio di modificare accidentalmente gli account di produzione quando tenti di modificare gli account di sviluppo, ti consigliamo di mantenere un insieme di credenziali di test separate dalle credenziali dell'applicazione di produzione.
Per creare un insieme di credenziali di test:
- Crea un account email (ad esempio
api.test@example.com) o un service account che verrà utilizzato solo a scopo di test. - Aggiungi questo utente o account di servizio come utente valido negli account Google Ads su cui esegui i test. Assicurati di concedere a questo utente o service account i livelli di accesso appropriati. Non concedere a questo utente o service account l'accesso a nessun account di produzione.
- Se utilizzi il flusso di autenticazione utente OAuth 2.0 anziché il flusso del service account, genera un token di aggiornamento per il tuo account utente di test.
- Utilizza queste nuove credenziali durante il test dell'applicazione. L'ID client e il client secret possono essere riutilizzati a scopo di test, poiché non hanno alcun effetto nel determinare a quali account Google Ads è possibile accedere. Memorizza tutte le credenziali e i token di aggiornamento in modo sicuro e non eseguirne mai il commit nel controllo del codice sorgente.
Richiedi convalida
Se devi solo verificare la validità di una richiesta, ad esempio per controllare
che sia strutturata correttamente e non violi le norme, puoi utilizzare il campo
validate_only, disponibile per le richieste
GoogleAdsService.Search (tieni presente che
GoogleAdsService.SearchStream non supporta
validate_only) e la maggior parte delle richieste di mutazione. Consulta la
documentazione di riferimento per verificare se questo campo è
disponibile per un determinato metodo.
API REST
Per i test ad hoc, ad esempio per verificare che una richiesta produca l'output previsto, l'utilizzo dell'API REST è spesso l'opzione più semplice. Consulta gli esempi REST per scoprire come utilizzare curl per effettuare richieste all'API REST. Prova anche a eseguire il test in REST Explorer.