Explorer API Google Ads

Explorer API Google Ads è un ambiente di esecuzione interattivo che ti consente di creare e inviare richieste API in tempo reale 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 in tempo reale (sia in lettura che in scrittura) direttamente dalla documentazione senza configurare un ambiente di sviluppo locale.
  • Protocollo di rilevamento: visualizza la struttura esatta delle richieste e delle risposte HTTP per capire il comportamento dell'API.
  • Prototipazione semplice: verifica il comportamento degli endpoint e ispeziona le risposte dell'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 di richiesta obbligatori, ad esempio customerId, ed espandi Intestazioni per fornire intestazioni HTTP facoltative, ad esempio login-customer-id (obbligatorio 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 in tempo reale dall'API.

Funzionalità principali

  • Esecuzione in tempo reale: 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 di update_mask per vedere come si comportano in pratica gli aggiornamenti parziali delle risorse.
  • Ispezione degli errori: visualizza messaggi di errore e codici (come QUERY_ERROR o AUTHENTICATION_ERROR) nella risposta non elaborata per facilitare il debug.
  • 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 l'esito positivo 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 la nidificazione JSON esatte richieste per una versione specifica dell'API.