Ihre erste App: Voraussetzungen

Bevor Sie mit dem Coding Ihrer ersten Clientanwendung beginnen, müssen Sie einige Vorbereitungen treffen, falls noch nicht geschehen.

Google-Konto erstellen und Search Ads 360-Berechtigungen erhalten

Damit Sie die Search Ads 360 API verwenden können, benötigen Sie ein Google-Konto und die entsprechenden Berechtigungen von Search Ads 360:

  1. Wenn Sie noch kein Google-Konto haben, erstellen Sie eines.

  2. Bitten Sie einen Search Ads 360-Agenturmanager, einen Search Ads 360-Nutzer für Ihr Google-Konto zu erstellen.

    Zum Herunterladen von Berichten benötigen Sie eine Leseberechtigung für die Werbetreibenden, mit denen Sie zusammenarbeiten.

    Wenn Sie Conversions hinzufügen oder bearbeiten möchten, benötigen Sie eine Bearbeitungsberechtigung für die Werbetreibenden, mit denen Sie zusammenarbeiten. In einer gemeinsam genutzten Floodlight-Konfiguration benötigen Sie die Bearbeitungsberechtigung für jeden untergeordneten Werbetreibenden, in den Sie Conversions hochladen möchten. Sie benötigen keinen Zugriff auf den übergeordneten Werbetreibenden und auch nicht auf untergeordnete Werbetreibende, in die Sie keine Conversions hochladen. Wenn Sie Klick-IDs verwenden, um Conversions Besuchen zuzuordnen, müssen Sie Bearbeitungszugriff auf den Werbetreibenden haben, der die Klick-ID generiert hat. Wenn Sie eine Klick-ID von einem Werbetreibenden angeben, auf den Sie keinen Bearbeitungszugriff haben, ist die Anfrage nicht erfolgreich.

    Der Agenturmanager kann Ihr Konto als Werbetreibendennutzer mit Zugriff auf bestimmte Werbetreibende oder mit einer höheren Zugriffsebene wie Agenturnutzer mit Zugriff auf alle Werbetreibenden in der Agentur einrichten.

API-Conversion-Service aktivieren

Wenn Sie Daten zu Conversions hochladen möchten, muss sich ein Search Ads 360-Nutzer mit Agenturmanagerberechtigungen in der Search Ads 360-Benutzeroberfläche anmelden und den API-Conversion-Service aktivieren. Eine Anleitung finden Sie in der Search Ads 360-Hilfe.

Google API Console-Projekt und OAuth-Anmeldedaten für den Client erstellen

  1. Starten Sie das Einrichtungstool für die Google API Console.
    Das Einrichtungstool führt Sie durch die Erstellung eines Projekts (oder eines vorhandenen Projekts), die Aktivierung der Search Ads 360 API und die Erstellung von OAuth 2.0-Anmeldedaten.
  2. Wählen Sie auf der Seite Anwendung registrieren ein vorhandenes Projekt aus oder klicken Sie auf Projekt erstellen. Anschließend klicken Sie auf Weiter.
  3. Nachdem die Search Ads 360 API in der Google API Console aktiviert wurde, klicken Sie auf die Schaltfläche Zu den Anmeldedaten.
  4. Geben Sie auf der Seite Anmeldedaten erstellen die folgenden Informationen ein:
    • Welche API verwenden Sie? Search Ads 360 API
    • Auf welche Daten werden Sie zugreifen? Nutzerdaten
  5. Klicken Sie auf die Schaltfläche Weiter.

    Mit dem Einrichtungstool können Sie jetzt eine OAuth 2.0-Client-ID erstellen.

  6. Folgen Sie den restlichen Schritten im Einrichtungstool.

sa360Api.py installieren

Search Ads 360 bietet ein Dienstprogrammskript, das die Einrichtung der Autorisierung erleichtert. Sie können dieses Skript auch zum Senden und Empfangen von Daten im JSON-Format verwenden, wenn Sie Daten vor dem Erstellen und Schreiben einer vollständigen Anwendung senden und empfangen möchten. Sie können viele der JSON-Beispiele auf dieser Dokumentationswebsite kopieren und direkt in das Skript eingeben.

So installieren Sie das Skript:

  1. Installieren Sie Python 2.7.
    Das Skript funktioniert nicht mit Python 3.x.
  2. cURL installieren
  3. Laden Sie sa360Api.zip herunter.
  4. Extrahieren Sie sa360Api.py aus sa360Api.zip.
  5. Machen Sie sa360Api.py ausführbar.

Informationen zu REST-Grundlagen

Es gibt zwei Möglichkeiten, die API aufzurufen:

Wenn Sie keine Clientbibliotheken verwenden möchten, müssen Sie sich mit den Grundlagen von REST vertraut machen.

REST ist eine Art Softwarearchitektur, die einen bequemen und einheitlichen Ansatz zur Abfrage und Bearbeitung von Daten bietet.

REST steht für "Representational State Transfer". Im Kontext der Google APIs ist damit die Verwendung von HTTP-Verben gemeint, um Darstellungen von Daten, die bei Google gespeichert sind, abzufragen und zu bearbeiten.

In einem als "RESTful" bezeichneten System werden Ressourcen in einem Datenspeicher abgelegt; ein Client sendet eine Aufforderung, der Server möge eine bestimmte Aktion ausführen (z. B. eine Ressource erstellen, abfragen, aktualisieren oder löschen), und der Server führt die Aktion aus und sendet eine Antwort, oft in Form einer Darstellung der angegebenen Ressource.

In den RESTful APIs von Google gibt der Client eine Aktion über ein HTTP-Verb wie POST, GET, PUT oder DELETE an. Sie gibt eine Ressource durch einen global eindeutigen URI im folgenden Format an:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Weil alle API-Ressourcen eindeutige, über HTTP zugängliche URIs haben, ermöglicht REST das Caching von Daten und ist optimal geeignet, mit der verteilten Infrastruktur des Webs zu arbeiten.

Dafür können die Methodendefinitionen in der Dokumentation der HTTP 1.1-Standards hilfreich sein. Hier finden Sie auch die Spezifikationen für GET, POST, PUT und DELETE.

REST in der Search Ads 360 API

Die Search Ads 360 API-Vorgänge sind REST-HTTP-Verben direkt zugeordnet.

Das spezifische Format für Search Ads 360 API-URIs lautet:

https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters

Die vollständige Gruppe von URIs, die für die einzelnen unterstützten Vorgänge in der API verwendet wird, ist in der API-Referenz zusammengefasst.

Informationen zu JSON-Grundlagen

Wenn Sie REST verwenden, müssen Sie für die Anfragetexte das JSON-Format verwenden. Sie können angeben, dass die Antworten im JSON- oder CSV-Format vorliegen.

JSON (JavaScript Object Notation) ist ein gängiges sprachunabhängiges Datenformat, das eine einfache Textdarstellung beliebiger Datenstrukturen bietet. Weitere Informationen finden Sie unter json.org.