Mit den erweiterten APIs in Google Ads-Scripts können Entwickler mit weniger Aufwand als bei Verwendung der HTTP-Schnittstellen eine Verbindung zu bestimmten öffentlichen Google APIs herstellen. Sie können diese APIs ähnlich wie die integrierten Dienste von Scripts verwenden. Sie bieten dieselben Vorteile wie die automatische Vervollständigung und die automatische 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 Google Analytics- und Google Ads-Konten finden Sie im Hilfeartikel Google 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 zehn Jahre laden und dann in einem Script, das diese Informationen zur Anpassung von Geboten verwendet, die Durchschnittstemperatur einer Region abfragen. Eine weitere Möglichkeit ist, die Leistungsdaten Ihres Kontos über mehrere Jahre hinweg zu analysieren.
- Google Kalender
- Ihr Script kann Termine für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen in zwei Wochen ausführen) oder Aktionen basierend auf einem Eintrag in Ihrem Kalender ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Google Präsentationen
- Ihr Script kann Kampagnendetails oder Statistiken in Google Präsentationen exportieren, um diese Informationen in einem präsentationsfähigen Format zu veröffentlichen.
- Google Tasks
- Ihr Script kann eine Erinnerungsliste für zukünftige Aufgaben erstellen (z. B. einen Leistungsbericht für Ihre Kampagnen in zwei Wochen ausführen) oder Aktionen basierend auf einem Eintrag in Ihrer Erinnerungsliste ausführen (z. B. eine Kampagne an einem bestimmten Datum aktivieren).
- Merchant API
- Ihr Script kann die Merchant API verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten sowie Ihre Google Merchant Center-Konten zu verwalten. In Scripts kann dies nützlich sein, um Produkteinträge zu überprü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 Als Entwickler registrieren.
- Shopping-Inhalte
- Ihr Script kann die Google Content API for Shopping verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten sowie Ihre Google Merchant Center-Konten zu verwalten. In Scripts kann dies nützlich sein, um Produkteinträge zu überprü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 Erweiterte APIs , um das Dialogfeld Erweiterte APIs aufzurufen. Wählen Sie die APIs aus, die Sie aktivieren möchten.
Klicken Sie auf Speichern , um Ihre Auswahl zu speichern und zum Scripteditor zurückzukehren. Die neuen APIs werden für Ihr Script aktiviert und sind in der Liste für die automatische Vervollständigung verfügbar.
Weitere Überlegungen
Bei der Arbeit mit den erweiterten APIs sind einige Punkte zu beachten.
Abhängigkeiten
Nur der Nutzer, der das Script im Konto erstellt hat, kann die Abhängigkeiten der erweiterten APIs für dieses Script ändern.
Berechtigungen
Beim Zugriff auf die APIs verwendet ein Script die Berechtigungen des Nutzers, der das Script autorisiert hat. Achten Sie darauf, dass der Nutzer, der das Script autorisiert hat, den erforderlichen Zugriff auf alle Daten hat, die das Script benötigt. Wenn Sie die Google Analytics API verwenden, prüfen Sie, ob der Nutzer, der das Script autorisiert hat, die erforderlichen Berechtigungen für das Analytics-Konto hat, auf das zugegriffen wird.
Hinweise zu Scripts von vor Mai 2019
Bei Scripts, die vor Mai 2019 erstellt wurden, müssen Sie die entsprechenden APIs möglicherweise manuell im verknüpften Google Cloud-Projekt des Scripts aktivieren. Wenn im Dialogfeld „Erweiterte APIs“ ein Link zur Google Cloud Console angezeigt wird, ist Ihr Script betroffen.
Erweiterte APIs aktivieren
Bei Scripts, die vor 2019 erstellt wurden, müssen Sie jede erweiterte API, die Sie in Ihrem Script verwenden möchten, manuell aktivieren:
- Klicken Sie auf die Schaltfläche Erweiterte APIs. Klicken Sie im folgenden Dialogfeld auf den Link zur Google Cloud Console.
- Wenn Ihr Projekt noch nicht ausgewählt ist, wählen Sie es in der Drop-down-Liste „Projekt“ aus.
- Suchen Sie nach den APIs, die Sie in Ihrem Script verwenden möchten, indem Sie den API-Namen in die Suchleiste eingeben.
- Wählen Sie die API in den Suchergebnissen aus und klicken Sie auf der nächsten Seite auf die Schaltfläche „Aktivieren“.
Wenn der Nutzer, der das Script erstellt hat, später aus dem Konto entfernt wird, werden alle neuen Nutzer, die auf das Script zugreifen möchten, aufgefordert, die Abhängigkeiten der erweiterten APIs noch einmal zu aktivieren und das Script neu zu autorisieren.