Ti presentiamo l'Assistente per gli sviluppatori dell'API Google Ads v2.0

Giovedì 26 febbraio 2026

Questo aggiornamento principale trasforma l'assistente da un potente strumento di generazione di codice in un partner proattivo per la risoluzione dei problemi e l'automazione per gli sviluppatori Google Ads. Dalla release della versione 1.6.0, abbiamo ascoltato i vostri feedback e ci siamo concentrati sugli aspetti più complessi dello sviluppo di API: diagnostica, coerenza e configurazione.

Novità della versione 2.0

1. Installazione e manutenzione più semplici

Configurare un ambiente di sviluppo multilingue non dovrebbe essere un'attività noiosa.

  • Configurazione con un solo comando: utilizza il nuovo flag --install-deps con install.sh o install.ps1 per gestire le dipendenze di pip, composer e bundler in un'unica operazione.
  • Struttura delle directory unificata: tutto il codice generato, le esportazioni CSV e i report diagnostici sono ora organizzati in un'unica directory saved/ con sottodirectory per ogni tipo di output.
  • Aggiornamento con un solo comando: quando viene rilasciata una nuova versione dell'API e delle librerie client, devi eseguire update.sh per lavorare con l'ultima versione. Puoi anche utilizzare update.sh per aggiungere altre librerie client al tuo contesto.

2. Risoluzione dei problemi relativi alle conversioni agentiche

Il monitoraggio delle conversioni offline è una delle funzionalità più potenti, ma anche più complesse, dell'API Google Ads. Il debug del motivo per cui una conversione non è stata attribuita può essere un processo manuale che richiede molto tempo.

Nella versione 2.0, abbiamo introdotto una suite dedicata alla risoluzione dei problemi e alla diagnostica delle conversioni.

  • Nuovo script: api_examples/collect_conversions_troubleshooting_data.py
  • Nuovo comando: /conversions_support_data

Lo script esegue report standard per la risoluzione dei problemi relativi alle conversioni e fornisce il contesto all'assistente per risolvere i problemi.

Il comando è particolarmente utile dopo che l'assistente ha analizzato il problema di conversione e ha tentato di risolverlo. In caso contrario, se devi contattare l'assistenza, questo comando analizzerà le impostazioni del cliente, le azioni di conversione e i riepiloghi dei caricamenti per generare un report diagnostico strutturato in base all'analisi già eseguita. Identifica persino gli stati "non integri" e le percentuali di errore elevate in modo automatico, risparmiandoti ore di analisi dei log. I risultati vengono salvati in un file di testo che puoi includere in una richiesta di assistenza, se necessario.

3. Sviluppata per l'API più recente (v23)

La versione 2.0 supporta completamente l'API Google Ads v23. Tutti i nostri esempi interattivi sono stati aggiornati e il contesto interno dell'assistente è ora ottimizzato per le risorse e i campi più recenti, garantendo che il codice generato sia pronto per la produzione.

4. Automazione perfetta con gli hook di sessione

Abbiamo aggiunto gli hook SessionStart e SessionEnd per rendere il tuo flusso di lavoro davvero fluido.

  • Configurazione automatica: l'assistente ora può individuare automaticamente il file di configurazione nella directory $HOME all'inizio di una sessione. Lo copia nella sottodirectory config della directory del progetto. Python è il linguaggio preferito di Gemini per eseguire query sull'API. Pertanto, se utilizzi un altro linguaggio, legge il file di configurazione e crea un file google-ads.yaml temporaneo in config per le sue query, ma continua a rispondere nel codice del linguaggio che preferisci.
  • Pulizia automatica: le configurazioni temporanee vengono cancellate in modo sicuro quando esci, mantenendo pulita l'area di lavoro e al sicuro le tue credenziali.

5. Convalida GAQL più intelligente

Creare query GAQL complesse non è mai stato così facile. Abbiamo aggiornato GEMINI.md e conversions/GEMINI.md con regole di convalida rigorose per i casi limite più recenti dell'API, tra cui una migliore gestione dei segmenti di date e dei requisiti di intervallo finito. L'assistente ora rileva gli errori logici prima di eseguire la query.

6. Skill

Pensa a una skill come a un mini-plug-in o a un "modello di comportamento". Mentre il contesto generale (come il file GEMINI.md) fornisce informazioni di base, una skill viene "caricata" nel cervello dell'AI solo quando deve eseguire in modo specifico un'attività procedurale complessa, come ottenere la versione corrente di questa estensione. Non esegui direttamente la skill. Gemini decide quando ne ha bisogno.

Sebbene sia ancora una funzionalità sperimentale, ne abbiamo inclusa una in questa release per integrare il nostro utilizzo degli hook per l'inizializzazione e la pulizia delle sessioni.

Perché dovresti eseguire l'upgrade?

Il salto dalla versione 1.6.0 alla versione 2.0.0 non riguarda solo le nuove funzionalità, ma anche l'affidabilità. Integrando una conoscenza approfondita delle API con strumenti di diagnostica automatizzati, la versione 2.0 riduce il ciclo di "tentativi ed errori" che spesso rallenta l'integrazione delle API.

Che tu stia eseguendo il debug dei caricamenti delle conversioni o creando pipeline di report complesse, la versione 2.0 ti offre gli strumenti per lavorare più velocemente e con maggiore sicurezza.

Per iniziare

Prima installazione

Eseguire l'upgrade da una versione precedente

  • Copia l'eventuale codice personalizzato da saved_code/ e saved_csv/ in una posizione sicura.
  • Elimina il clone locale dell'Assistente per sviluppatori dell'API Google Ads eliminando la directory del progetto e tutte le sottodirectory e i file.
  • git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  • Nella directory del progetto, esegui install.sh o install.ps1 per installare l'estensione e le librerie client.

Bob Hancock, team API Google Ads

Etichette: google-ads-api, release