Mit den erweiterten APIs in Google Ads-Skripts können Entwickler mit weniger Aufwand als bei der Verwendung von HTTP-Schnittstellen eine Verbindung zu bestimmten öffentlichen Google APIs herstellen. Sie können diese APIs ähnlich wie die integrierten Dienste von Skripts verwenden. Sie bieten dieselben Vorteile wie die automatische Vervollständigung und die automatische Autorisierung.
Auf der Seite mit Code-Snippets finden Sie einige Beispiele für die Verwendung dieser APIs.
Verfügbare erweiterte APIs
- Google Analytics
- Hinweis: Die erweiterte API
Analyticsim Dialogfeld Erweiterte APIs ist auf die eingestellte Universal Analytics v3 API ausgerichtet. Anfragen an diese API schlagen fehl. Google Ads-Skripts unterstützen die erweiterten Google Analytics 4-DiensteAnalyticsDataundAnalyticsAdminnicht. Wenn Sie Google Analytics 4-Daten über ein Script abfragen möchten, senden Sie HTTPS-Anfragen an die Google Analytics Data API. Verwenden Sie dazu den DienstUrlFetchAppund OAuth 2.0. Sie können auch eine Google Analytics 4-Property mit Ihrem Google Ads-Konto verknüpfen, um Website- und App-Conversion-Daten direkt zu teilen. Eine Anleitung zur Einrichtung finden Sie im Einrichtungsleitfaden für Analytics. - 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 die Durchschnittstemperatur einer Region in einem Skript abfragen, das diese Informationen zur Anpassung von Geboten verwendet. Eine weitere Möglichkeit besteht darin, die Leistungsdaten Ihres Kontos über mehrere Jahre hinweg zu analysieren.
- Google Kalender
- Mit Ihrem Script 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 Script können Sie Kampagnendetails oder Statistiken in Google Präsentationen exportieren, um diese Informationen in einem präsentablen Format zu veröffentlichen.
- Google Tasks
- Mit Ihrem Script 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
- Ihr Script kann die Merchant API verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten und 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 hat Unter-APIs, die im Dialogfeld Erweiterte APIs einzeln aktiviert werden können. Weitere Informationen zum Verknüpfen Ihres Google Merchant Center-Kontos finden Sie im Leitfaden Als Entwickler registrieren.
- Shopping-Inhalte
- In Ihrem Script können Sie die Google Content API for Shopping verwenden, um Ihre Produkteinträge hochzuladen und zu verwalten und 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
- Du kannst deine Videos, Playlists usw. sowie die Leistungsdaten deiner 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 Script-Editor 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 Dinge 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 erweiterte APIs verwendet ein Script die Berechtigungen des Nutzers, der das Script autorisiert hat. Der autorisierende Nutzer muss den erforderlichen Zugriff auf alle Daten haben, die das Skript benötigt. Wenn Sie beispielsweise die erweiterte API BigQuery verwenden möchten, muss der autorisierende Nutzer die erforderlichen Berechtigungen für das Google Cloud-Zielprojekt und das BigQuery-Dataset haben.
Hinweise zu Skripts, die vor Mai 2019 erstellt wurden
Bei Skripts, die vor Mai 2019 erstellt wurden, müssen Sie die relevanten APIs möglicherweise manuell im zugehörigen Google Cloud-Projekt des Skripts aktivieren. Wenn Ihr Script betroffen ist, wird im Dialogfeld für erweiterte APIs ein Link zur Google Cloud Console angezeigt.
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 den Button 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 aus 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 aus den Suchergebnissen aus und klicken Sie auf der folgenden Seite auf den Button „Aktivieren“.
Wenn der Nutzer, der das Skript erstellt hat, später aus dem Konto entfernt wird, werden alle neuen Nutzer, die versuchen, auf das Skript zuzugreifen, aufgefordert, die erweiterten API-Abhängigkeiten noch einmal zu aktivieren und das Skript neu zu autorisieren.