Erweiterte APIs

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. Sie können diese APIs ähnlich wie die integrierten Dienste von Skripts verwenden und profitieren von denselben Vorteilen wie der automatischen Vervollständigung und der automatischen 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 lässt sich erkennen, welcher Anteil Ihrer Websitezugriffe oder Ihres Umsatzes auf Google Ads entfällt. Außerdem können Sie Ihre 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 hochladen und diese Daten dann mit Google BigQuery abfragen. Sie können beispielsweise öffentliche Wetterdaten der letzten zehn Jahre hochladen und dann in einem Skript, 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
Mit Ihrem Skript können Sie 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
Mit Ihrem Skript können Sie Kampagnendetails oder Statistiken in Google Präsentationen exportieren, um diese Informationen in einem präsentationsfähigen Format zu veröffentlichen.
Google Tasks
Mit Ihrem Skript können Sie 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 Unter-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 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 Skripteditor zurückzukehren. Die neuen APIs werden für Ihr Skript 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 Dinge zu beachten.

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 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.

Hinweise zu Skripts von vor Mai 2019

Bei Skripts, die vor Mai 2019 erstellt wurden, müssen Sie die entsprechenden APIs möglicherweise manuell im verknüpften Google Cloud-Projekt des Skripts aktivieren. Wenn im Dialogfeld „Erweiterte APIs“ ein Link zur Google Cloud Console angezeigt wird, ist Ihr Skript betroffen.

Erweiterte APIs aktivieren

Bei Skripts, die vor 2019 erstellt wurden, müssen Sie jede erweiterte API, die Sie in Ihrem Skript verwenden möchten, manuell aktivieren:

  1. Klicken Sie auf die Schaltfläche Erweiterte APIs. Klicken Sie im folgenden Dialogfeld auf den Link zur Google Cloud Console.
  2. Wenn Ihr Projekt noch nicht ausgewählt ist, wählen Sie es aus der Drop-down-Liste „Projekt“ aus.
  3. Suchen Sie nach den APIs, die Sie in Ihrem Skript verwenden möchten, indem Sie den API-Namen in die Suchleiste eingeben.
  4. 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 Skript erstellt hat, später aus dem Konto entfernt wird, werden alle neuen Nutzer, die auf das Skript zugreifen möchten, aufgefordert, die Abhängigkeiten der erweiterten APIs noch einmal zu aktivieren und das Skript neu zu autorisieren.