Die vorherige Search Ads 360 Reporting API wird eingestellt und am 30. Juni 2024 außer Betrieb genommen. Die Search Ads 360 Conversion API ist davon nicht betroffen und wird weiterhin unterstützt. Verwenden Sie bei jeder neuen Berichterstellung die neue Search Ads 360 Reporting API.

Ab April 2024 wird beim Anfordern eines Berichts der Fehler „Nicht unterstützte ApiVersion“ zurückgegeben. Weitere Informationen

Außerdem empfehlen wir Ihnen dringend, alle vorhandenen Search Ads 360-Implementierungen zur neuen API zu migrieren. Weitere Informationen finden Sie unter Erste Schritte und im Migrationsleitfaden zur neuen Search Ads 360 Reporting API.

Diese Seite wurde von der Cloud Translation API übersetzt.

Autorisierung einrichten

Für die Search Ads 360 API müssen alle Anfragen ein OAuth 2.0-Zugriffstoken zur Authentifizierung angeben. Sie können jedem Standard-OAuth 2.0-Authentifizierungsworkflow folgen, um das Token zu generieren und an die Search Ads 360 API zu übergeben. Wir empfehlen den unten beschriebenen Workflow, da er für vollautomatische Conversion-Uploads und Berichtdownloads geeignet ist.

Alternativen zum unten beschriebenen Workflow finden Sie unter OAuth 2.0 für installierte Anwendungen oder OAuth 2.0 für Server-zu-Server-Anwendungen verwenden. Wenn Sie einen alternativen Workflow verwenden, geben Sie bei der Anforderung eines OAuth 2.0-Autorisierungscodes den folgenden Wert als scope-Parameter an:
https://www.googleapis.com/auth/doubleclicksearch
Wenn Sie dem Server-zu-Server-Routing folgen, fügen Sie das Dienstkonto als Search Ads 360-Nutzer hinzu.

Empfohlener Autorisierungsworkflow

Rufen Sie die Google API Console auf und wählen Sie Ihr Projekt aus.
Wenn Sie noch kein Google API Console-Projekt und noch keine OAuth-Anmeldedaten erstellt haben, folgen Sie der Anleitung unter Google API Console-Projekt und OAuth-Anmeldedaten für Ihren Client erstellen.

So finden Sie die OAuth-Client-ID und das Secret Ihres Projekts:
1. Öffnen Sie die Seite Anmeldedaten.
2. Klicken Sie in der Spalte Name auf den Namen Ihres OAuth-Clients.
3. Die Client-ID und das Secret sind auf der Seite aufgeführt.
Öffnen Sie einen Webbrowser und melden Sie sich bei Google an. Verwenden Sie dabei ein Google-Konto mit Berechtigung zum Zugriff auf Daten in Search Ads 360.
Das ist das Google-Konto, mit dem sich Ihr API-Client für Search Ads 360 authentifiziert. Wenn der Inhaber des Google-Kontos Ihr Unternehmen verlässt und Sie Search Ads 360-Zugriff aus dem Konto entfernen, müssen Sie diesen Autorisierungsworkflow wiederholen und ein anderes Google-Konto angeben.
Um ein Aktualisierungstoken zu erhalten, rufen Sie das Search Ads 360-Dienstprogrammskript so auf:
sa360Api.py --login

Das Skript führt Sie durch den Vorgang, bei dem Sie die OAuth-Client-ID und das Secret verwenden, um ein Aktualisierungstoken abzurufen. Das Aktualisierungstoken ist nur für das Google-Konto gültig, in dem Sie sich im vorherigen Schritt angemeldet haben.
Im Rahmen dieses Prozesses generiert das Skript eine URL und weist Sie an, die URL in einem Webbrowser aufzurufen.
Wenn Sie im Browser aufgefordert werden, dem OAuth-Client Zugriff auf Search Ads 360-Daten zu gewähren, müssen Sie prüfen, ob das Google-Konto, in dem Sie sich zuvor angemeldet haben, angezeigt wird. Wenn Sie in mehreren Google-Konten angemeldet sind, wird möglicherweise ein anderes Konto angezeigt.

Am Ende des Vorgangs gibt das Skript sa360Api.py einen durch Kommas getrennten String aus. Der erste Wert ist die von Ihnen angegebene Client-ID, der zweite Wert ist der von Ihnen angegebene Clientschlüssel und der dritte Wert ist das Aktualisierungstoken. In der folgenden Beispielausgabe ist das Aktualisierungstoken fett formatiert:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
Speichern Sie die Client-ID, den Clientschlüssel und das Aktualisierungstoken in einer Back-End-Datenbank oder an einem anderen sicheren Ort, auf den Ihre Anwendung zugreifen kann.
Bewahren Sie den gesamten durch Kommas getrennten String an einem praktischen Ort auf, wenn Sie sa360Api.py verwenden möchten, um JSON-Beispielanfragen an die Search Ads 360 API zu senden. Sie übergeben den gesamten String jedes Mal als Parameter, wenn Sie das Skript aufrufen.
Fügen Sie Ihrer Anwendung Code hinzu, der Folgendes tut:
1. Verwenden Sie die Client-ID, den Clientschlüssel und das Aktualisierungstoken, um ein neues OAuth 2.0-Zugriffstoken zu erhalten.
2. Anfragen mit dem neuen Zugriffstoken an die Search Ads 360 API senden.
Wenn Sie die Clientbibliotheken verwenden, wird im nächsten Abschnitt Anwendung einrichten beschrieben, wie Sie diesen Autorisierungscode in Ihre Anwendung einfügen.

Wenn Sie keine der Clientbibliotheken verwenden, finden Sie unter OAuth 2.0 für installierte Anwendungen Vorschläge zum Abrufen eines neuen Zugriffstokens.