Explorer API Google Ads

Explorer API 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 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 immediatamente il comportamento degli endpoint e ispeziona le risposte API non elaborate 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.

Per iniziare

  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 "Provalo" sul lato destro della pagina.
  3. Configura la richiesta:
    • Inserisci i parametri della richiesta obbligatori, ad esempio developer-token e login-customer-id.
    • Definisci il corpo della richiesta utilizzando l'editor JSON interattivo se il metodo richiede un payload, ad esempio per le operazioni mutate.
  4. Esegui: fai clic su Esegui per inviare la richiesta. Lo strumento visualizzerà 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 una logica 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 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 o i metadati a livello di account eseguendo una richiesta get o search.
  • 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 di 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 esatte e l'annidamento JSON richiesti per una versione API specifica.