Instala y usa el Asistente para desarrolladores de la API de Google Ads

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.
    • gemini-cli instalado.
    • jq (procesador JSON de línea de comandos) La secuencia de comandos de instalación intentará instalarlo si falta.

  3. Repositorio:

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 que use los archivos de contexto GEMINI.md y las herramientas necesarias del asistente.

    ./install.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 secuencias de comandos de Python de solo lectura generadas directamente desde gemini-cli y consulta 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 si tu idioma predeterminado es Python, Ruby o PHP. Los lenguajes compilados no se ejecutarán debido a las políticas de seguridad.

  • 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:
    • "Muéstrame 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:
    • "/explica qué es un conjunto compartido"
  • Generación de código:
    • "Escribe código para crear una campaña de máximo rendimiento para company name".

Comunidad y asistencia

Lineamientos para las contribuciones

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