I test sono un passaggio importante per creare un'integrazione dell'API Google Ads di successo, sia 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 prova e account di produzione
Gli account di prova 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à della tua 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 comunque alcuni servizi, tra cui la fatturazione (BillingSetupService e AccountBudgetProposalService), la pianificazione, la creazione di account e gli inviti degli utenti (consulta 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 da v25 o AuthorizationError.ACTION_NOT_PERMITTED in v24 e versioni precedenti.
Gli account di produzione per lo sviluppo differiscono dagli account di test nei seguenti modi:
- Pubblica annunci che possono essere visti dagli utenti
- Richiedi 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, oltre a sbloccare tutte le altre funzionalità dell'API Google Ads. Tuttavia, il loro utilizzo per lo sviluppo richiede un'attenzione particolare. 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 un test completo 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 provi a modificare gli account sviluppatore, ti consigliiamo di mantenere un insieme di credenziali di test separate dalle credenziali dell'applicazione di produzione.
Per creare un insieme di credenziali di test, segui questi passaggi:
- Crea un account email (ad esempio
api.test@example.com) o un service account che verrà utilizzato solo per i test. - Aggiungi questo utente o service account come utente valido negli account Google Ads su cui stai eseguendo i test. Assicurati di assegnare i livelli di accesso appropriati a questo utente o service account. Non concedere a questo utente o service account l'accesso ad alcun account di produzione.
- Se utilizzi il flusso di autenticazione utente OAuth 2.0 anziché il flusso dell'account di servizio, genera un token di aggiornamento per l'account utente di test.
- Utilizza queste nuove credenziali quando testi l'applicazione. L'ID client e il client secret possono essere riutilizzati a scopo di test, in quanto non influiscono sulla determinazione degli account Google Ads a cui è possibile accedere. Archivia 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 se una richiesta è valida, 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 modifica. 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. Inoltre, prova a eseguire il test in REST Explorer.