Google Ads API Developer Assistant

Hinweis:Dieses Tool ist ein Open-Source-Projekt und kein offizielles Google-Produkt.

Der Google Ads API Developer Assistant ist eine leistungsstarke Erweiterung für die Gemini CLI, mit der Sie Ihre Google Ads API-Workflows beschleunigen können. Mit dem Assistant können Sie in natürlicher Sprache mit der Google Ads API interagieren. So können Sie einfacher Fragen stellen, Code generieren, Daten abrufen und Probleme direkt in Ihrem Terminal beheben.

Hinweis :In dieser Dokumentation werden die Kernfunktionen des Assistenten beschrieben. Der Assistent wird jedoch schnell weiterentwickelt. Die neuesten Funktionen und Updates finden Sie in der README und im ChangeLog auf GitHub.

Vorteile

• Produktivität steigern:Sie müssen weniger Zeit für die Suche nach Dokumentation und das Schreiben von Boilerplate-Code aufwenden.
• Komplexe Aufgaben vereinfachen:Generieren Sie GAQL-Code (Google Ads Query Language) und Clientbibliotheks-Code aus einfachen englischen Prompts.
• API kennenlernen:API-Konzepte verstehen und sehen, wie Anfragen in natürlicher Sprache in ausführbaren Code übersetzt werden.
• Interaktives Debugging:Sie erhalten Hilfe beim Verstehen von Fehlern und eine Schritt-für-Schritt-Anleitung zur Fehlerbehebung.
• Optimierter Workflow:Sie können den Entwicklungs- und Testzyklus in der Befehlszeile durchführen.

Vorbereitung

Bevor Sie beginnen, benötigen Sie Folgendes:

1. Google Ads API-Zugriff:

   • Ein Google Ads API-Entwicklertoken.
   • Eine google-ads.yaml-Datei, die mit Ihrem Entwicklertoken, Ihren OAuth 2.0-Anmeldedaten und Ihrer Kunden-ID konfiguriert ist. Sie befindet sich in der Regel in Ihrem Home-Verzeichnis. Weitere Informationen finden Sie im Konfigurationsleitfaden für Clientbibliotheken.
   • Vertrautheit mit Google Ads API-Konzepten und der Authentifizierung.

2. Software:

   • Python 3.10 oder höher. Python ist die Standardsprache. Sie muss also installiert sein und sich in Ihrem Pfad befinden.
   • Die Gemini CLI ist installiert.
   • jq (Befehlszeilen-JSON-Prozessor). Das Einrichtungs-Script versucht, diese zu installieren, falls sie fehlt.

3. Repository:

   • Ein lokaler Klon des google-ads-api-developer-assistant-Repositorys von GitHub:

Jetzt starten

1. Zum Projektverzeichnis wechseln:

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

2. Einrichtungsscript ausführen:Dieses Script konfiguriert die Gemini CLI so, dass die GEMINI.md-Kontextdateien und erforderlichen Tools des Assistenten verwendet werden.

   ./setup.sh
   

   Wenn Sie Windows verwenden, führen Sie das PowerShell-Skript setup.ps1 aus.

3. Gemini CLI starten:

   gemini
   

4. Mit dem Assistenten interagieren:Sie können jetzt Fragen stellen oder Befehle in natürlicher Sprache geben.

Wichtige Features

• Fragen und Antworten in natürlicher Sprache:Sie können Fragen zu Google Ads API-Funktionen, Best Practices oder bestimmten Ressourcen stellen.

  • Welche Kampagnentypen gibt es?
  • „Wie filtere ich in GAQL nach Datum?“
  • „Erkläre den Unterschied zwischen ‚click_view‘ und ‚impression_view‘.“

• Codegenerierung:GAQL-Abfragen und ausführbare Python-Code-Snippets generieren.

  • „Zeig mir die Kampagnen mit den meisten Conversions in den letzten 30 Tagen.“
  • „Get all enabled ad group names for campaign ID 12345.“ (Alle aktivierten Anzeigengruppennamen für die Kampagnen-ID 12345 abrufen)
  • „Abgelehnte Anzeigen in allen Kampagnen finden“ Der generierte Code wird im Verzeichnis saved_code/ gespeichert.

• Direkte API-Ausführung:Generierte schreibgeschützte Python-Skripts können direkt über die Gemini CLI ausgeführt werden. Die formatierten Ergebnisse werden im Terminal angezeigt. Nachdem der Assistant den Code generiert hat, wird eine Aufforderung auf dem Bildschirm angezeigt:

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>

Geben Sie run ein. Das Skript wird dann im Assistant-Kontext ausgeführt.

• CSV-Export:Tabellarische Ergebnisse aus API-Aufrufen in einer CSV-Datei speichern.

  • „Speichere die Ergebnisse in einer CSV-Datei.“ Dateien werden im Verzeichnis saved_csv/ gespeichert.

• Unterstützung bei der Fehlerbehebung:Sie erhalten Hilfe bei Fehlermeldungen oder unerwartetem API-Verhalten.

  • Ich habe den Fehler „AuthenticationError.OAUTH_TOKEN_INVALID“ erhalten. Was soll ich tun?
  • „Warum sehe ich keine Ergebnisse für meine Anfrage?“

Beispielanwendungsfälle

• Berichte:
  • „Gib mir die fünf wichtigsten Keywords nach Kosten für den letzten Monat für Kunde 12345678.“
• Kontostruktur:
  • „Liste alle Kampagnennamen und ihre IDs auf.“
• Fehlerbehebung
  • Ich habe 100 Conversions hochgeladen, aber nur 78 werden auf der Benutzeroberfläche angezeigt. Wie kann ich das mit der API debuggen?“
• Lernen:
  • „Erstelle eine Performance Max-Kampagne über die API.“

Community und Support

• GitHub-Probleme:Auf dem Tab Probleme im Repository können Sie Fehler melden, Funktionen vorschlagen oder um Hilfe bitten.
• Discord:Nehmen Sie an der Diskussion im Channel #ads-api-ai-tools auf dem Discord-Server der Google Advertising and Measurement Community teil.
• Feedback:Sie können uns Ihr Feedback über dieses Umfrageformular senden.

Richtlinien für Beiträge

Beiträge sind willkommen. Richtlinien finden Sie in der Datei CONTRIBUTING.md im GitHub-Repository.