Explorer API Google Ads

L'Explorer API di Google Ads è un ambiente di esecuzione interattivo che ti consente di creare e inviare richieste API live direttamente dal 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 in lettura che in scrittura) direttamente dalla documentazione senza configurare un ambiente di sviluppo locale.
  • Rilevamento del protocollo:visualizza la struttura esatta delle richieste HTTP e delle risposte per capire il comportamento dell'API.
  • Prototipazione a basso attrito:verifica il comportamento degli 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 l'Explorer:cerca il riquadro Prova questo metodo sul lato destro della pagina.
  3. Configura la richiesta:
    • Inserisci i parametri della richiesta richiesti, ad esempio customerId, ed espandi Intestazioni per fornire intestazioni HTTP facoltative come login-customer-id (obbligatorio solo quando si accede 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 dello schema valide.
  • Maschere dei campi:testa la logica di update_mask per vedere come si comportano in pratica gli aggiornamenti parziali delle risorse.
  • Ispezione degli errori:visualizza messaggi e codici di errore dettagliati (ad esempio QUERY_ERROR o AUTHENTICATION_ERROR) nella risposta non elaborata per facilitare un debug più rapido.
  • Esportazione del codice:esporta i comandi curl, le richieste HTTP non elaborate o il codice JavaScript di esempio dalla visualizzazione espansa di Explorer API.

Esempi di casi d'uso

  • Controlla le impostazioni dell'account:recupera rapidamente le configurazioni o i metadati a livello di account 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 eseguire il deployment del codice in produzione.
  • Esegui il debug di GAQL:utilizza Explorer per eseguire una stringa Google Ads Query Language (GAQL) e verifica che la struttura JSON restituita corrisponda alle aspettative della tua applicazione.
  • Verifica del protocollo:esamina le intestazioni HTTP e l'annidamento JSON esatti richiesti per una versione API specifica.