Presentazione dell'Assistente per sviluppatori dell'API Google Ads v1.0: interagisci con l'API utilizzando il linguaggio naturale

Mercoledì 10 dicembre 2025

Annunciamo il rilascio di Google Ads API Developer Assistant, una potente estensione per l'interfaccia a riga di comando di Gemini progettata per semplificare i flussi di lavoro dell'API Google Ads. Questo strumento ti consente di interagire con l'API Google Ads utilizzando un linguaggio naturale, semplificando più che mai l'ottenimento di informazioni, la generazione di codice e persino il recupero dei dati direttamente nel tuo terminale.
Che tu sia un utente alle prime armi con l'API Google Ads o uno sviluppatore esperto, questo assistente può aiutarti a lavorare in modo più efficiente.

Cosa può fare?

L'Assistente per sviluppatori dell'API Google Ads (v1.0) migliora l'interfaccia a riga di comando di Gemini con diverse funzionalità chiave:

  1. Domande e risposte in linguaggio naturale: hai domande sull'API Google Ads? Basta chiedere.
    • "Quali sono i tipi di campagna disponibili?"
    • "Parlami dei report per le campagne Performance Max."
    • "Come faccio a filtrare per data in GAQL?"
  2. Generazione di codice da linguaggio naturale: descrivi i dati di cui hai bisogno e l'assistente genererà il codice Google Ads Query Language (GAQL) e Python eseguibile utilizzando la libreria client google-ads-python come contesto, in modo che il codice sia conforme alle best practice.
    • "Mostrami le campagne con il maggior numero di conversioni negli ultimi 30 giorni."
    • "Recupera tutti i gruppi di annunci per il cliente '123-456-7890'."
    • "Trova gli annunci non approvati in tutte le campagne."
    • Il codice generato viene salvato automaticamente nella directory saved_code/.
  3. Esecuzione diretta dell'API: esegui gli script Python generati direttamente dalla riga di comando. L'assistente eseguirà le chiamate API di sola lettura e visualizzerà i risultati, spesso formattati in modo ordinato come tabelle all'interno del terminale.
  4. Esportazione in formato CSV: hai bisogno di salvare i tuoi dati? Puoi esportare facilmente i risultati tabulari delle chiamate API in un file CSV. Basta chiedere:
    • "Salva i risultati in un file CSV"
    • I file vengono salvati nella directory saved_csv/.

Come funziona?

Questa estensione sfrutta la capacità di Gemini CLI di utilizzare il contesto dei file e delle impostazioni di GEMINI.md all'interno di .gemini/settings.json. Configurando l'assistente con i percorsi del clone della libreria google-ads-python locale e delle directory di esempio, l'assistente fornisce una generazione di codice pertinente e accurata.

Per iniziare

Ecco cosa ti serve per iniziare:
Prerequisiti:

  • Familiarità con i concetti e l'autenticazione dell'API Google Ads.
  • Un token sviluppatore dell'API Google Ads.
  • Un file di credenziali google-ads.yaml configurato nella tua home directory.
  • Python >= 3.10.
  • Gemini CLI installata.
  • Una copia locale della libreria client google-ads-python. (Lo script di configurazione può clonarlo per te.)

Per istruzioni dettagliate sulla configurazione ed esempi, consulta il file README nel repository GitHub.

Dove trovarlo

L'assistente per sviluppatori dell'API Google Ads è disponibile su GitHub.

Community e assistenza

Ti invitiamo a provarla. Il tuo feedback è importante e può essere fornito in questo sondaggio. Partecipa alla discussione nel canale #ads-api-ai-tools del nostro Discord.

Utilizza la scheda GitHub Issues nel repository per segnalare bug, suggerire funzionalità o chiedere assistenza. Consulta CONTRIBUTING.md per le linee guida per i contributi.

Buona programmazione!
Bob Hancock, team API Google Ads

Etichette: google-ads-api, release