Mit den erweiterten APIs in Google Ads-Skripts können Entwickler mit weniger Aufwand als bei Verwendung der HTTP-Schnittstellen eine Verbindung zu bestimmten öffentlichen Google APIs herstellen. Diese APIs lassen sich ähnlich wie die integrierten Dienste von Skripts verwenden und bieten dieselben Vorteile wie die automatische Vervollständigung und Autorisierung.
Auf unserer Seite mit Code-Snippets finden Sie einige Beispiele für die Verwendung dieser APIs.
Verfügbare erweiterte APIs
- Google Analytics
- Mit Google Analytics können Sie die Zugriffe auf Ihre Website erfassen und Ihre Kampagnengebote entsprechend anpassen. Wenn Sie eine Google Analytics-Property mit Ihrem Google Ads-Konto verknüpfen, können Sie auch die Kundenaktivitäten auf Ihrer Website analysieren. Anhand dieser Informationen erkennen Sie, welcher Anteil Ihrer Websitezugriffe oder Ihres Umsatzes auf Google Ads entfällt. Außerdem können Sie Anzeigen und Ihre Website basierend auf diesen Daten optimieren. Weitere Informationen zum Verknüpfen von Analytics- und Google Ads-Konten finden Sie im Hilfeartikel Analytics für eine Website und/oder App einrichten.
- Google BigQuery
- Sie können große Datenmengen in Google Cloud Storage laden und diese Daten dann mit Google BigQuery abfragen. Sie können beispielsweise öffentliche Wetterdaten der letzten 10 Jahre laden und dann in einem Skript, das diese Informationen zur Anpassung von Geboten verwendet, die durchschnittliche Temperatur einer Region abfragen. Eine weitere Möglichkeit ist, die Leistungsdaten Ihres Kontos über mehrere Jahre hinweg zu analysieren.
- Google Kalender
- Ihr Skript kann Termine für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen in zwei Wochen erstellen) oder Aktionen basierend auf einem Eintrag in Ihrem Kalender ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Google Präsentationen
- Ihr Skript kann Kampagnendetails oder Statistiken in Google Präsentationen exportieren, um diese Informationen in einem präsentationsfähigen Format zu veröffentlichen.
- Google Tasks
- Ihr Skript kann eine Erinnerungsliste für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen in zwei Wochen erstellen) oder Aktionen basierend auf einem Eintrag in Ihrer Erinnerungsliste ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Merchant API
- Mit Ihrem Skript können Sie die Merchant API verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten sowie Ihre Google Merchant Center-Konten zu verwalten. In Skripts kann dies nützlich sein, um Produkteinträge zu prüfen und bestimmte Produkte mit bestimmten Anzeigen zu verknüpfen. Die Merchant API enthält Sub-APIs, die einzeln im Dialogfeld Erweiterte APIs aktiviert werden können. Weitere Informationen zum Verknüpfen Ihres Google Merchant Center-Kontos finden Sie im Leitfaden Registrieren als Entwickler.
- Shopping-Inhalte
- Mit Ihrem Skript können Sie die Google Content API for Shopping verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten sowie Ihre Google Merchant Center-Konten zu verwalten. In Skripts kann dies nützlich sein, um Produkteinträge zu prüfen und bestimmte Produkte mit bestimmten Anzeigen zu verknüpfen. Hinweis:Die Content API for Shopping wird am 18. August 2026 eingestellt. Verwenden Sie stattdessen die Merchant API, die im vorherigen Abschnitt beschrieben wird.
- YouTube und YouTube Analytics
- Sie können Ihre Videos, Playlists usw. sowie die Leistungsdaten Ihrer Videos abrufen und aktualisieren, um Gebotsentscheidungen zu treffen.
Erweiterte APIs aktivieren
Wenn Sie sehen möchten, welche Google APIs als erweiterte APIs verfügbar sind, klicken Sie in der oberen Editorleiste auf die Schaltfläche Erweiterte APIs.
Daraufhin wird das Dialogfeld Erweiterte APIs geöffnet. Aktivieren Sie die APIs, die Sie aktivieren möchten.
Klicken Sie dann auf den Link Google API Console , um die Seite API Console in der Console mit dem Ihrem Skript zugeordneten Projekt aufzurufen. Wenn Ihr Projekt noch nicht ausgewählt ist, wählen Sie es aus der Drop-down-Liste „Projekt“ aus. Suchen Sie nach den APIs, die Sie in Ihrem Skript verwenden möchten, indem Sie den API-Namen in die Suchleiste eingeben.
Wählen Sie in den Suchergebnissen die API aus und wählen Sie auf der folgenden Seite Aktivieren aus. Wenn die Schaltfläche Deaktivieren angezeigt wird, ist diese API bereits aktiviert. Wenn Sie mehrere APIs aktivieren möchten, wiederholen Sie diesen Schritt jeweils.
Wenn Sie die Liste der für das Projekt aktivierten APIs aufrufen möchten, wählen Sie die Seite Dashboard aus. Prüfen Sie, ob alle erweiterten APIs aufgeführt sind, die Sie für das Skript verwenden möchten.
Schließen Sie nun das Dialogfeld „Erweiterte APIs“, um zum Editor zurückzukehren. Die neuen APIs werden für Ihr Skript aktiviert und sind in der Liste für die automatische Vervollständigung verfügbar.
Abschließende Hinweise
Bei der Arbeit mit den erweiterten APIs sind einige Dinge zu beachten.
Projekt-ID
Jedes Google Ads-Skript hat eine Google Cloud Projekt-ID (auch Projektnummer genannt). Die Projektnummer Ihres Skripts finden Sie, indem Sie im Dialogfeld Erweiterte APIs die Seite Google API Console öffnen. Diese Projekt-ID wird beim Erstellen des Skripts generiert und ist mit dem Nutzer verknüpft, der das Google Ads-Skript erstellt hat. Wenn der Nutzer, der das Skript erstellt hat, später aus dem Konto entfernt wird, werden Nutzer, die auf das Skript zugreifen möchten, aufgefordert, das Skript neu zu autorisieren und die Abhängigkeiten der erweiterten APIs noch einmal einzurichten. Außerdem wird eine neue Google Developer-Projekt-ID erstellt und Sie müssen die erweiterten APIs noch einmal einrichten, wie weiter oben in diesem Dokument beschrieben.
Abhängigkeiten
Nur der Nutzer, der das Skript im Konto erstellt hat, kann die Abhängigkeiten der erweiterten APIs für dieses Skript ändern.
Berechtigungen
Beim Zugriff auf die APIs verwendet ein Skript die Berechtigungen des Nutzers, der das Skript autorisiert hat. Achten Sie darauf, dass der Nutzer, der das Skript autorisiert hat, den erforderlichen Zugriff auf alle verwendeten erweiterten APIs sowie auf die Daten hat, die das Skript benötigt. Wenn Sie die Google Analytics API verwenden, prüfen Sie, ob der Nutzer, der das Skript autorisiert hat, die erforderlichen Berechtigungen für das Analytics-Konto hat, auf das zugegriffen wird.
Nutzungsbedingungen
Für jede der erweiterten APIs gelten möglicherweise eigene Nutzungsbedingungen, die Sie akzeptieren müssen, wenn Sie die API in der Google API Console aktivieren.
Quota
Zu den meisten erweiterten APIs gehört ein kostenloses Tageskontingent. Sobald Ihr Skript dieses Kontingent überschreitet, funktioniert die API nicht mehr, bis Sie zusätzliche Daten anfordern oder das kostenlose Kontingent wieder aufgefüllt wird. Sie können das von Ihrem Skript verwendete Kontingent überwachen, indem Sie im Dialogfeld Erweiterte APIs die Google API Console für das Skript öffnen. Über die Google API Console können Sie auch zusätzliches Kontingent für die API anfordern.
Abrechnung
Für einige erweiterte APIs müssen Sie für die Nutzung bezahlen. Diese Zahlungen werden über das Google Cloud-Projekt verwaltet, das mit Ihrem Skript verknüpft ist, und nicht über Google Ads. Weitere Informationen zum Aktivieren der Abrechnung für das Google Cloud-Projekt Ihres Skripts finden Sie in unserer Dokumentation.