Martedì 25 agosto 2026
È ora disponibile una versione principale dell'assistente per sviluppatori dell'API Google Ads. Questa release segna la transizione dell'assistente da un progetto autonomo a un'architettura di plug-in unificata progettata per integrare funzionalità specializzate dell'API Google Ads direttamente negli Agentic Workflows degli agenti AI.
Che cos'è?
L'assistente per sviluppatori dell'API Google Ads porta una profonda esperienza nel dominio di Google Ads negli ambienti di programmazione AI come Antigravity e Claude Code. Fornisce al tuo assistente AI strumenti e sistemi di protezione specializzati. Le funzioni includono:
- Genera codice idiomatico: crea codice di integrazione testato e basato sulle best practice in Python, Java, PHP, .NET e Ruby.
- Convalida le query GAQL: verifica automaticamente la sintassi, la compatibilità dei campi, la segmentazione delle date e le regole per le impressioni pari a zero prima di eseguire le query.
- Ispeziona gli schemi Protobuf: rilevamento on demand di campi delle risorse, tipi di dati e definizioni di enum per qualsiasi versione attiva dell'API Google Ads per garantire che i campi delle query GAQL siano validi.
- Risolvi i problemi relativi alle API: diagnostica gli errori di caricamento delle conversioni offline, esplora le gerarchie degli account amministratore e crea filtri per le schede Performance Max. Puoi porre domande in linguaggio naturale come "Mostrami tutti gli annunci del mio account con problemi e consigliami come risolvere il problema".
- Rispondere alle domande sull'API: l'assistente risponde alle domande combinando le regole di architettura dell'API Google Ads incorporate con l'ispezione dinamica e locale dello schema Protobuf per fornire indicazioni precise sulla versione e snippet di codice verificati. Basa le sue risposte direttamente sulle definizioni ufficiali delle API e sul codice sorgente della libreria client, anziché fare affidamento esclusivamente sull'addestramento generale del modello. Un esempio di domanda potrebbe essere: "Che cos'è un set condiviso e come lo utilizzo?"
- Report ad hoc: puoi richiedere i dati sul rendimento in un linguaggio naturale e l'assistente crea, convalida ed esegue istantaneamente le query GAQL richieste direttamente nel tuo account Google Ads. Trasmette i risultati in tempo reale nella chat sotto forma di tabelle pulite e formattate, semplificando la generazione di report ad hoc e l'analisi delle metriche. Se vuoi salvare i risultati, chiedi di "Salvare i risultati come file CSV in <la tua directory>" e potrai caricarli in un foglio di lavoro per l'analisi.
Supporto per Antigravity e Claude Code
Questa release introduce il supporto per due piattaforme:
- Antigravity: supporto nativo per gli ambienti di sviluppo Antigravity con registrazione dei plug-in globali e dell'area di lavoro.
- Claude Code: integrazione completa con il sistema di plug-in dell'interfaccia a riga di comando di Claude Code, inclusi i comandi slash personalizzati (come
/validate-gaql,/inspect-object,/troubleshoot-conversionse/get-cids).
Gli script di installazione unificati sono disponibili per Linux, macOS (bash) e Windows (PowerShell) per fornire una gestione del ciclo di vita coerente su tutte e tre le piattaforme.
Prestazioni migliorate
- Consumo di token ridotto: la divulgazione progressiva di regole e schemi carica solo il contesto necessario per una determinata attività, riducendo l'overhead dei token dei prompt.
- Tempi di risposta più rapidi: l'esecuzione delle skill on demand e il routing dei comandi mirato consentono di completare le attività end-to-end più rapidamente.
- Utilizzo ridotto della CPU: le pipeline di esecuzione semplificate eliminano l'overhead dei processi in background durante le sessioni di sviluppo.
- I/O del disco ridotto: la riduzione del numero di file non necessari nell'albero dei plug-in impedisce a file watcher, linter e indicizzatori IDE di scansionare decine di migliaia di file protobuf/SDK inutilizzati.
- Impatto ridotto sulla memoria (RAM) e overhead del daemon pari a zero: le skill e i comandi ora vengono eseguiti in modo temporaneo come processi secondari rapidi solo quando vengono chiamati, riducendo a zero l'utilizzo delle risorse di sistema quando sono inattivi.
- Versione dell'API memorizzata nella cache e risoluzione dello schema Protobuf: l'assistente evita di effettuare chiamate API di reflection o metadati remoti ripetitive durante l'ispezione di campi, risorse ed enum standard.
- Esecuzione deterministica dei comandi rispetto al ragionamento LLM multi-turn: invece di far indovinare o eseguire il debug iterativo della sintassi GAQL all'LLM in 3-4 round-trip, il validator locale controlla campi, risorse, metriche con zero impressioni e clausole di data in un unico passaggio.
Una build di release principale basata su un'architettura di plug-in moderna
Si tratta di una release principale non compatibile con le release precedenti. Le versioni precedenti si basavano su una struttura di progetto dell'area di lavoro locale. Questa versione è basata su un'architettura di plug-in standardizzata che viene installata per essere disponibile a livello globale.
La modularizzazione di regole, competenze e comandi di diagnostica in un bundle di plug-in autonomo consente agli sviluppatori di installare, aggiornare e gestire l'assistente in più ambienti e progetti.
Consulta il file README.md per i dettagli tecnici sull'architettura del plug-in.
Per iniziare
A causa delle modifiche all'architettura in questa release, consulta la documentazione prima dell'installazione:
- Leggi README_BEFORE_INSTALLATION.md per i prerequisiti e la preparazione dell'ambiente.
- Segui le istruzioni di installazione nel file README.md.
Vorremmo sapere cosa ne pensi
Condividi il tuo feedback, segnala problemi e suggerisci funzionalità utilizzando il modulo del sondaggio:
Etichette: google-ads-api, release