Assistant pour les développeurs de l'API Google Ads

L'assistant pour les développeurs de l'API Google Ads est une extension puissante de la CLI Gemini conçue pour accélérer vos workflows de l'API Google Ads. L'assistant vous permet d'interagir avec l'API Google Ads en langage naturel. Vous pouvez ainsi poser des questions, générer du code, récupérer des données et résoudre des problèmes plus facilement, directement dans votre terminal.

Avantages

  • Améliorez votre productivité : passez moins de temps à rechercher de la documentation et à écrire du code passe-partout.
  • Simplifiez les tâches complexes : générez du code de langage de requête Google Ads (GAQL) et de bibliothèque cliente à partir de requêtes simples en anglais.
  • Découvrir l'API : comprenez les concepts de l'API et découvrez comment les requêtes en langage naturel se traduisent en code exécutable.
  • Débogage interactif : obtenez de l'aide pour comprendre les erreurs et des conseils détaillés pour les résoudre.
  • Workflow simplifié : gardez votre boucle de développement et de test dans la ligne de commande.

Prérequis

Avant de commencer, vérifiez que vous disposez des éléments suivants :

  1. Accès à l'API Google Ads :

  2. Logiciel :

    • Python 3.10 ou version ultérieure. Python étant le langage par défaut, vous devez l'avoir installé et sur votre chemin d'accès.
    • Gemini CLI est installé.
    • jq (processeur JSON de ligne de commande). Le script d'installation tentera de l'installer si elle est manquante.

  3. Dépôt :

    • Clone local du dépôt google-ads-api-developer-assistant depuis GitHub :

Premiers pas

  1. Accédez au répertoire du projet :

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

  2. Exécutez le script de configuration : ce script configure Gemini CLI pour qu'il utilise les fichiers de contexte GEMINI.md de l'assistant et les outils nécessaires.

    ./setup.sh

    Si vous utilisez Windows, exécutez le script PowerShell setup.ps1.

  3. Démarrez Gemini CLI :

    gemini

  4. Interagir avec l'Assistant : vous pouvez désormais poser des questions ou donner des commandes en langage naturel.

Principales fonctionnalités

  • Questions/réponses en langage naturel : posez des questions sur les fonctionnalités de l'API Google Ads, les bonnes pratiques ou des ressources spécifiques.

    • "Quels sont les types de campagnes disponibles ?"
    • "Comment filtrer par date dans GAQL ?"
    • "Explique la différence entre click_view et impression_view."

  • Génération de code : générer des requêtes GAQL et des extraits de code Python exécutables.

    • "Affiche-moi les campagnes qui ont généré le plus de conversions au cours des 30 derniers jours."
    • "Obtiens tous les noms de groupes d'annonces activés pour la campagne 12345."
    • "Trouvez les annonces refusées dans toutes les campagnes." Le code généré est enregistré dans le répertoire saved_code/.

  • Exécution directe de l'API : exécutez les scripts Python en lecture seule générés directement depuis la CLI Gemini et affichez les résultats mis en forme dans votre terminal. Une fois que l'Assistant a généré le code, une invite s'affiche à l'écran :

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>

Saisissez run. Le script s'exécutera dans le contexte de l'Assistant.

  • Exportation au format CSV : enregistrez les résultats tabulaires des appels d'API dans un fichier CSV.

    • "Enregistre les résultats dans un fichier CSV." Les fichiers sont enregistrés dans le répertoire saved_csv/.

  • Aide au dépannage : obtenez de l'aide pour les messages d'erreur ou le comportement inattendu de l'API.

    • "J'ai reçu le message d'erreur 'AuthenticationError.OAUTH_TOKEN_INVALID'. Que dois-je faire ?"
    • "Pourquoi n'obtiens-je aucun résultat pour ma requête ?"

Exemples de cas d'utilisation

  • Reporting :
    • "Donne-moi les cinq principaux mots clés par coût pour le mois dernier pour le client 12345678."
  • Structure du compte :
    • "Liste tous les noms de campagnes et leurs ID."
  • Dépannage
    • J'ai importé 100 conversions, mais seulement 78 s'affichent dans l'interface utilisateur. Comment puis-je déboguer cela à l'aide de l'API ?"
  • Apprentissage :
    • "Explique-moi comment créer une campagne Performance Max à l'aide de l'API."

Communauté et support

Consignes de contribution

Vos contributions sont les bienvenues ! Pour obtenir des consignes, consultez le fichier CONTRIBUTING.md dans le dépôt GitHub.