Asistente para desarrolladores de la API de Google Ads

El Asistente para desarrolladores de la API de Google Ads es una potente extensión para la CLI de Gemini diseñada para acelerar tus flujos de trabajo de la API de Google Ads. El asistente te permite interactuar con la API de Google Ads en lenguaje natural, lo que facilita hacer preguntas, generar código, recuperar datos y solucionar problemas directamente en tu terminal.

Beneficios

  • Aumenta la productividad: Dedica menos tiempo a buscar documentación y escribir código estándar.
  • Simplifica tareas complejas: Genera código del lenguaje de consultas de Google Ads (GAQL) y de la biblioteca cliente a partir de instrucciones simples en inglés.
  • Aprende a usar la API: Comprende los conceptos de la API y observa cómo las solicitudes en lenguaje natural se traducen en código ejecutable.
  • Depuración interactiva: Obtén ayuda para comprender los errores y orientación paso a paso para solucionar problemas.
  • Flujo de trabajo optimizado: Mantén tu ciclo de desarrollo y pruebas dentro de la línea de comandos.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

  1. Acceso a la API de Google Ads:

  2. Software:

    • Python 3.10 o una versión posterior Python es el lenguaje predeterminado, por lo que debes tenerlo instalado y en tu ruta de acceso.
    • La Gemini CLI instalada
    • jq (procesador JSON de línea de comandos) La secuencia de comandos de configuración intentará instalarlo si falta.

  3. Repositorio:

    • Una clonación local del repositorio de google-ads-api-developer-assistant de GitHub:

Comenzar

  1. Navega al directorio del proyecto:

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

  2. Ejecuta la secuencia de comandos de configuración: Esta secuencia de comandos configura Gemini CLI para usar los archivos de contexto GEMINI.md y las herramientas necesarias del asistente.

    ./setup.sh

    Si usas Windows, ejecuta la secuencia de comandos de PowerShell setup.ps1.

  3. Inicia Gemini CLI:

    gemini

  4. Interactúa con el Asistente: Ahora puedes hacer preguntas o dar comandos en lenguaje natural.

Características clave

  • Preguntas y respuestas en lenguaje natural: Haz preguntas sobre las funciones, las prácticas recomendadas o los recursos específicos de la API de Google Ads.

    • "¿Cuáles son los tipos de campaña disponibles?"
    • "¿Cómo filtro por fecha en GAQL?"
    • "Explica la diferencia entre click_view y impression_view".

  • Generación de código: Genera consultas en GAQL y fragmentos de código de Python ejecutables.

    • "Muéstrame las campañas con la mayor cantidad de conversiones en los últimos 30 días".
    • "Obtén todos los nombres de los grupos de anuncios habilitados para el ID de campaña 12345".
    • "Busca anuncios rechazados en todas las campañas". El código generado se guarda en el directorio saved_code/.

  • Ejecución directa de la API: Ejecuta scripts de Python de solo lectura generados directamente desde la CLI de Gemini y visualiza los resultados con formato en tu terminal. Después de que el Asistente genere el código, recibirás un mensaje en pantalla:

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>

Ingresa run y la secuencia de comandos se ejecutará en el contexto de Asistente.

  • Exportación a CSV: Guarda los resultados tabulares de las llamadas a la API en un archivo CSV.

    • "Guarda los resultados en un archivo CSV". Los archivos se guardan en el directorio saved_csv/.

  • Asistencia para solucionar problemas: Obtén ayuda con los mensajes de error o el comportamiento inesperado de la API.

    • “Recibí el error ‘AuthenticationError.OAUTH_TOKEN_INVALID’. ¿Qué debo hacer?”
    • "¿Por qué no veo ningún resultado para mi búsqueda?"

Ejemplos de casos de uso

  • Informes:
    • "Obtén las 5 palabras clave principales por costo del mes pasado para el cliente 12345678".
  • Estructura de la cuenta:
    • "Enumera todos los nombres de las campañas y sus IDs".
  • Solución de problemas:
    • "Cargué 100 conversiones, pero solo 78 aparecen en la IU. ¿Cómo puedo depurar esto con la API?"
  • Aprendizaje:
    • "Explícame cómo crear una campaña de máximo rendimiento con la API".

Comunidad y asistencia

Lineamientos para la contribución

Agradecemos tus contribuciones. Consulta el archivo CONTRIBUTING.md en el repositorio de GitHub para obtener los lineamientos.