I test sono un passaggio importante per creare un'integrazione dell'API Google Ads efficace, 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 prova, puoi verificare che il codice e la configurazione dell'applicazione funzionino come previsto.
Tuttavia, non tutte le funzionalità possono essere testate in un account di prova.
Quando le limitazioni dell'account di prova 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 comunque determinati
servizi, tra cui la fatturazione (BillingSetupService
e AccountBudgetProposalService),
la pianificazione, la creazione di account e gli inviti degli utenti (vedi Limitazioni delle funzionalità di Explorer), che richiedono l'accesso Basic 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 dalla versione v25, o
AuthorizationError.ACTION_NOT_PERMITTED nella versione v24 e
precedenti.
Gli account di produzione per lo sviluppo differiscono dagli account di prova nei seguenti modi:
- Pubblicano annunci che possono essere visualizzati dagli utenti
- Richiedono URL validi
- Devono 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 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 prova.
Pertanto, per eseguire test completi dell'integrazione, è probabile che tu abbia bisogno sia di credenziali di prova sia di credenziali di produzione.
Credenziali di test
Per ridurre al minimo il rischio di modificare accidentalmente gli account di produzione quando tenti di modificare gli account sviluppatore, 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 da utilizzare solo per scopi di test. - Aggiungi questo utente o service account come utente valido negli account Google Ads su cui esegui 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 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 l'account utente di test.
- Utilizza queste nuove credenziali quando testi l'applicazione. L'ID client e il client secret possono essere riutilizzati per scopi di test, poiché non influiscono sulla determinazione degli account Google Ads a cui è possibile accedere. Archivia in modo sicuro tutte le credenziali e i token di aggiornamento e non eseguirne mai il commit nel controllo del codice sorgente.
Richiedi convalida
Se devi solo verificare se una richiesta è valida, ad esempio per verificare
che la richiesta 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 i test in REST Explorer.