Explorer API Google Ads

Explorer API di Google Ads è un ambiente di esecuzione interattivo che ti consente di creare e inviare richieste API live direttamente dal tuo browser. Incorporato nella documentazione di riferimento, gestisce le complessità dell'autenticazione OAuth 2.0 e della formattazione del payload JSON, consentendoti di testare servizi e metodi specifici senza scrivere una sola riga di codice.

Vantaggi

  • Test senza codice: esegui chiamate API live (sia di lettura che di scrittura) direttamente dalla documentazione senza configurare un ambiente di sviluppo locale.
  • Rilevamento del protocollo: visualizza la struttura esatta delle richieste e delle risposte HTTP per capire il comportamento dell'API.
  • Prototipazione a basso attrito: verifica il comportamento dell'endpoint e ispeziona le risposte API non elaborate immediatamente prima di implementare la logica nella tua applicazione.
  • Autenticazione semplificata: lo strumento gestisce automaticamente i flussi OAuth 2.0, consentendoti di concentrarti sulla richiesta API anziché sulla gestione delle credenziali.

Inizia

  1. Vai alla documentazione: vai alla documentazione di riferimento e seleziona il servizio e il metodo che vuoi testare, ad esempio GoogleAdsService/Search.
  2. Apri Explorer: cerca il riquadro Prova questo metodo sul lato destro della pagina.
  3. Configura la richiesta:
    • Inserisci i parametri della richiesta obbligatori, ad esempio customerId, ed espandi Intestazioni per fornire intestazioni HTTP facoltative come login-customer-id (obbligatoria solo quando accedi a un account tramite un account amministratore). Tieni presente che i token sviluppatore (developer-token) sono stati ritirati il 9 settembre 2026 e vengono ignorati dai server API, anche se puoi comunque inserire un valore se richiesto dal modulo.
    • Definisci il corpo della richiesta utilizzando l'editor JSON interattivo se il metodo richiede un payload, ad esempio per le operazioni search o mutate.
  4. Esegui: fai clic su Esegui per inviare la richiesta. Lo strumento mostra la richiesta HTTP completa e la risposta JSON live dell'API.

Funzionalità principali

  • Esecuzione live: esegui operazioni search e mutate in tempo reale sui tuoi account di produzione o di test.
  • Formattazione del payload JSON: crea in modo interattivo oggetti JSON complessi per le richieste, con lo strumento che evidenzia i campi obbligatori e le strutture di schema valide.
  • Maschere di campo: testa la logica update_mask per vedere come si comportano in pratica gli aggiornamenti parziali delle risorse.
  • Ispezione degli errori: visualizza messaggi di errore e codici dettagliati (ad esempio QUERY_ERROR o AUTHENTICATION_ERROR) nella risposta non elaborata per facilitare il debug più rapido.
  • Esportazione del codice: esporta comandi curl, richieste HTTP non elaborate o codice JavaScript di esempio dalla visualizzazione espansa di Explorer API.

Esempi di casi d'uso

  • Controlla le impostazioni dell'account: recupera rapidamente le configurazioni a livello di account o i metadati eseguendo una richiesta GoogleAdsService/Search sulla risorsa customer.
  • Testa le mutazioni: verifica la riuscita della creazione di una campagna o dell'aggiornamento del budget prima di distribuire il codice in produzione.
  • Esegui il debug di GAQL: utilizza Explorer per eseguire una stringa Google Ads Query Language (GAQL) e verificare che la struttura JSON restituita corrisponda alle aspettative della tua applicazione.
  • Verifica del protocollo: ispeziona le intestazioni HTTP e l'annidamento JSON esatti richiesti per una versione API specifica.