Explorer API di Google Ads

L'Explorer API di Google Ads è un ambiente di esecuzione interattivo che ti consente di creare e inviare richieste API in tempo reale direttamente dal browser. Integrato 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 no-code: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 degli endpoint e ispeziona le risposte API non elaborate istantaneamente 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 "Prova" sul lato destro della pagina.
  3. Configura la richiesta:
    • Inserisci i parametri di richiesta richiesti, 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 mostrerà la richiesta HTTP completa e la risposta JSON in tempo reale 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 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 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 get o search.
  • Testa le mutazioni:verifica la riuscita della creazione di una campagna o dell'aggiornamento del budget prima di implementare il codice in produzione.
  • 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:esamina le intestazioni HTTP e l'annidamento JSON esatti richiesti per una versione API specifica.