Hintergrund

Vorbereitung

  1. Bitten Sie Ihren Kundenbetreuer, die richtigen Berechtigungen für Konten einzurichten. auf die Ihre Anwendung zugreift.
  2. Wenn Sie mit den Konzepten von Authorized Buyers nicht vertraut sind, finden Sie hier weitere Informationen: Authorized Buyers-Hilfe und mit der Benutzeroberfläche experimentieren. Wenn Ihre Anwendung Echtzeitgebote ausführen soll, lesen Sie die Dokumentation zum RTB-Protokoll.
  3. Besuchen Sie die APIs-Konsole um ein neues Projekt einzurichten. Melden Sie sich entweder in Ihrem Google-Entwicklerkonto oder Konto erstellen Sie werden dann aufgefordert, ein Projekt zu erstellen und zu den Nutzungsbedingungen.

Über- und untergeordnete Konten

Wenn Sie in einer Kontostruktur mit über- und untergeordneten Elementen arbeiten Konten zu verwalten, können Sie möglicherweise effizienter arbeiten, wenn Sie wissen, interagieren. Hier eine kurze Zusammenfassung:

Untergeordnete Konten

Ein Nutzer mit Anmeldedaten, die Zugriff auf ein Kinderkonto gewähren, kann nur Mit ihrem Konto verknüpfte Ressourcen ansehen und bearbeiten Für Kinderkonten ist Folgendes nicht möglich: Ressourcen anderer untergeordneter oder übergeordneter Konten ansehen oder ändern.

Elternkonten

Ein Nutzer mit Anmeldedaten, die Zugriff auf ein übergeordnetes Konto gewähren, kann sich das folgende Element ansehen: und Ressourcen für das übergeordnete Konto zusätzlich zu allen zugehörigen Kinderkonten. Für Vorgänge, die eine bestimmte Ressource auflisten, erhält eine Antwort mit Daten für sein Konto und alle Kinderkonten. Bei anderen Arten von Anfragen, die auf Ressourcen für untergeordnete Konten ausgerichtet sind, Im übergeordneten Konto muss für das untergeordnete Konto ein accountId-Pfadparameter angegeben werden Konto anstelle eines eigenen accountId.

Das REST API-Datenmodell

Eine Ressource ist ein individuelles Datenobjekt mit einer eindeutigen ID. Die Die Kontenressource stellt einen Authorized Buyers-Kontoeintrag dar und ist der Stamm für die Ad Exchange-API für Käufer. Die Methoden der API laufen auf Kontenressourcen und Sammlungen von Kontenressourcen.

Konten Ressource umfasst: eine Konto-ID, für den Cookie-Abgleich verwendete Informationen, Bieterstandorte, die URL, an die Gebotsanfragen gesendet werden, und eine Anfrage um die maximale Anzahl von Abfragen pro Sekunde anzugeben, die von der Anzeigenplattform gesendet werden sollen.

Zusätzlich zur Kontenressource und -sammlung kann die Ad Exchange-API für Käufer definiert die folgenden Datenstrukturen:

Standort des Bieters

Bieterstandorte sind Strukturen, die mit Kontoressourcen zurückgegeben werden um die URL anzugeben, an die Gebotsanfragen über die Anzeigenplattform gesendet werden sollen, sowie Maximale Anzahl von Abfragen pro Sekunde, die von der Anzeigenplattform gesendet werden sollen. Hier ist eine Beispiel für einen Bieterstandort im JSON-Format: 

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

Elemente

Elemente enthalten eine Liste mit Konten. Hier ist ein Beispiel für Elemente im JSON-Format: 

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

Unterstützte Vorgänge

Sie können drei verschiedene Methoden für Sammlungen und Ressourcen in der Ad Exchange-API für Käufer, wie in der folgenden Tabelle beschrieben. Alle Vorgänge erfordern Autorisierung.

Vorgang Beschreibung REST-HTTP-Zuordnungen
list Listet alle Konten auf, auf die die aktuell authentifizierten Nutzer zugreifen können Nutzer. GET für einen Sammlungs-URI.
get Ruft eine bestimmte Kontenressource ab. GET für einen Ressourcen-URI.
Update Aktualisiert eine bestimmte Kontenressource. Für einen Ressourcen-URI ist dies PUT, wobei Sie Daten für den aktualisierte Ressource.

Aufrufstil

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

Der Begriff REST steht für Representational State Transfer. Im Zusammenhang mit Google-APIs bezieht es sich auf die Verwendung von HTTP-Verben zum Abrufen und Ändern von Darstellungen von Daten, die von Google gespeichert sind.

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 Googles RESTful APIs spezifiziert der Client eine Aktion mit einem HTTP-Verb wie POST, GET, PUT oder DELETE. Eine Ressource wird anhand eines weltweit eindeutigen URIs im folgenden Format spezifiziert:

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 Ad Exchange-API für Käufer

Für die unterstützten Vorgänge besteht eine direkte Zuordnung zu REST-HTTP-Verben. Eine Beschreibung finden Sie unter API-Vorgänge:

Das spezifische Format für API-URIs ist:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

Dabei ist resourceID die ID für eine Ressource vom Typ „Konten“ und parameters sind -Parameter, die auf die Abfrage angewendet werden sollen. Weitere Informationen finden Sie unter Standardsuchparameter und die Referenzdokumentation .

Das Format der resourceID-Pfaderweiterungen können Sie die Ressource identifizieren, mit der Sie gerade arbeiten. Beispiel:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

Die vollständige Gruppe von URIs, die für jeden unterstützten Vorgang in der API verwendet wird, ist in der Referenzdokumentation nachlesen.

Beispiel für die Funktionsweise in der Ad Exchange-API für Käufer:

Rufen Sie die Kontenliste des authentifizierten Nutzers ab:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

Datenformat

JSON

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.