Assistente per sviluppatori dell'API Google Ads

L'assistente sviluppatore dell'API Google Ads è una potente estensione per la CLI Gemini progettata per accelerare i flussi di lavoro dell'API Google Ads. L'assistente ti consente di interagire con l'API Google Ads utilizzando il linguaggio naturale, semplificando la formulazione di domande, la generazione di codice, il recupero di dati e la risoluzione dei problemi direttamente all'interno del terminale.

Vantaggi

  • Aumentare la produttività: dedica meno tempo alla ricerca di documentazione e alla scrittura di codice boilerplate.
  • Semplifica le attività complesse:genera codice del linguaggio di query di Google Ads (GAQL) e della libreria client da semplici prompt in inglese.
  • Scopri l'API:comprendi i concetti dell'API e scopri come le richieste in linguaggio naturale si traducono in codice eseguibile.
  • Debug interattivo: ricevi assistenza per comprendere gli errori e istruzioni passo passo per la risoluzione dei problemi.
  • Workflow semplificato: mantieni il ciclo di sviluppo e test all'interno della riga di comando.

Prerequisiti

Prima di iniziare, assicurati di disporre di quanto segue:

  1. Accesso all'API Google Ads:

  2. Software:

    • Python 3.10 o versioni successive. Python è la lingua predefinita, quindi devi averla installata e nel percorso.
    • Gemini CLI installata.
    • jq (processore JSON a riga di comando). Lo script di configurazione tenterà di installarlo se manca.

  3. Repository:

    • Una clonazione locale del repository google-ads-api-developer-assistant da GitHub:

Inizia

  1. Vai alla directory del progetto:

    cd <full path>/google-ads-api-developer-assistant

  2. Esegui lo script di configurazione: questo script configura la CLI Gemini per utilizzare i file di contesto GEMINI.md dell'assistente e gli strumenti necessari.

    ./setup.sh

    Se utilizzi Windows, esegui lo script di PowerShell setup.ps1.

  3. Avvia Gemini CLI:

    gemini

  4. Interagisci con l'assistente: Ora puoi porre domande o dare comandi in linguaggio naturale.

Funzionalità principali

  • Domande e risposte in linguaggio naturale:poni domande sulle funzionalità dell'API Google Ads, sulle best practice o su risorse specifiche.

    • "Quali sono i tipi di campagna disponibili?"
    • "Come faccio a filtrare per data in GAQL?"
    • "Spiega la differenza tra click_view e impression_view".

  • Generazione del codice:genera query GAQL e snippet di codice Python eseguibili.

    • "Mostrami le campagne con il maggior numero di conversioni negli ultimi 30 giorni".
    • "Recupera tutti i nomi dei gruppi di annunci attivati per la campagna con ID 12345."
    • "Trova gli annunci non approvati in tutte le campagne". Il codice generato viene salvato nella directory saved_code/.

  • Esecuzione diretta dell'API:esegui gli script Python di sola lettura generati direttamente dalla CLI Gemini e visualizza i risultati formattati nel terminale. Dopo che l'assistente ha generato il codice, riceverai un messaggio sullo schermo:

To run this script, you will need to replace YOUR_CUSTOMER_ID with your actual
Google Ads customer ID and execute the following command in
your shell: <command>

Inserisci run e lo script verrà eseguito nel contesto dell'assistente.

  • Esportazione CSV:salva i risultati tabellari delle chiamate API in un file CSV.

    • "Salva i risultati in un file CSV". I file vengono salvati nella directory saved_csv/.

  • Assistenza per la risoluzione dei problemi: ricevi assistenza per i messaggi di errore o per il comportamento imprevisto dell'API.

    • "Ho ricevuto l'errore 'AuthenticationError.OAUTH_TOKEN_INVALID'. Che cosa devo fare?"
    • "Perché non vedo risultati per la mia query?"

Esempi di casi d'uso

  • Report:
    • "Mostrami le prime 5 parole chiave per costo del mese scorso per il cliente 12345678."
  • Struttura dell'account:
    • "Elenca tutti i nomi delle campagne e i relativi ID."
  • Risoluzione dei problemi:
    • "Ho caricato 100 conversioni, ma nell'interfaccia utente ne vengono visualizzate solo 78. Come posso eseguire il debug utilizzando l'API?"
  • Apprendimento:
    • "Spiegami come creare una campagna Performance Max utilizzando l'API."

Community e assistenza

Linee guida per i contributi

I contributi sono ben accetti. Consulta il file CONTRIBUTING.md nel repository GitHub per le linee guida.