Installer et utiliser l'assistant pour les développeurs de l'API Google Ads

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 d'installer ce package s'il est manquant.

  3. Dépôt :

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 utiliser les fichiers de contexte GEMINI.md de l'assistant et les outils nécessaires.

    ./install.sh

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

  3. Démarrer 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 vos 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 à partir de gemini-cli 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 si votre langue par défaut est Python, Ruby ou PHP. Les langages compilés ne s'exécuteront pas en raison des règles de sécurité.

  • 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'y a-t-il aucun résultat pour ma requête ?"

Exemples de cas d'utilisation

  • Rapports :
    • "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 apparaissent dans l'interface utilisateur. Comment puis-je déboguer cela à l'aide de l'API ?"
  • Apprentissage
    • "/explain what a shared set is" (explique ce qu'est un ensemble partagé)
  • Génération de code :
    • "Écris du code pour créer une campagne Performance Max pour company name."

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.