Anleitung

Auf dieser Seite wird beschrieben, wie Sie häufige Aufgaben mithilfe der API ausführen.

Nutzer erstellen

Mit dem UserService können Nutzer mit Administratorrechten direkt in ihrem Netzwerk einen Nutzer erstellen. Jeder Entwickler kann dies tun, ohne dass sich der neue Nutzer zuerst registrieren muss. Wenn Sie beispielsweise die API zum ersten Mal testen, möchten Sie vielleicht nicht jeden API-Aufruf als Administrator (Standardeinstellung für Ihre E-Mail-Adresse) ausführen, sondern ein paar Nutzer mit Rollen wie Vertriebsmitarbeiter, Trafficker oder Werbetreibender erstellen, um Workflows in der Praxis zu testen.

  1. Erstellen Sie neue Gmail-Adressen, z. B. my.name.dfp.salesperson@gmail.com. Alternativ können Sie eine bestehende Nicht-Gmail-Adresse als neues Google-Konto registrieren.
  2. Rufen Sie createUsers mit dieser neuen Adresse und der ausgewählten Role an.
  3. Sie können sich mit OAuth 2.0 als neuer Nutzer authentifizieren, um Ihr Zugriffstoken zu generieren.

Stammanzeigenblock abrufen

Sowohl der oberste AdUnit, dem Sie untergeordnete Knoten hinzufügen können, als auch die zulässige Tiefe Ihrer Hierarchie hängen von Ihrem Kontotyp ab (Small Business oder Premium). Die oberste AdUnit, die das Ändern ihrer untergeordneten Knoten unterstützt, wird als effektive Stamm-AdUnit bezeichnet.

Um den effektiven Stamm abzurufen, rufen Sie NetworkService.getCurrentNetwork() auf und sehen Sie sich das Feld effectiveRootAdUnitId im zurückgegebenen Network-Objekt an.

Hinweis:Verschiedene Kontotypen unterstützen unterschiedliche Hierarchiemuster.

Objekte abfragen

Sie können anhand von Suchkriterien nach Objekten suchen, indem Sie die Methode getObjectsByStatement() verwenden, die von vielen Diensten bereitgestellt wird. Dabei ist Object ein bestimmter Objekttyp. Diese Methode verwendet eine PQL-Abfrage, die einer SQL-Abfrage insofern ähnelt, als Sie damit Felder angeben können, nach denen gesucht werden soll (wobei Feldnamen den Attributen des Objekts zugeordnet sind), sortieren, begrenzen und verschieben können. Im PQL-Leitfaden finden Sie weitere Informationen zu PQL sowie dazu, nach welchen Objektfeldern Sie filtern können.

Auftrag erstellen

Um einen Auftrag zu erstellen, erstellen Sie einfach ein Order-Objekt, legen Sie die Werbetreibenden-, Vertriebs- und Trafficker-IDs auf die entsprechenden Nutzer fest, weisen Sie einen eindeutigen Namen zu und rufen Sie createOrders() auf. Das Ergebnis enthält den neu erstellten Order oder einen Fehler.

Beispiel

Siehe Java-Code zum Erstellen einer Bestellung.

Werbebuchung erstellen

So erstellen Sie eine neue Werbebuchung:

  1. Erstellen Sie ein neues Order-Objekt oder verwenden Sie ein vorhandenes Objekt.
  2. Erstellen Sie ein neues LineItem-Objekt und legen Sie den Rotationstyp, das Creative-Größen-Array, das Start- und Enddatum und andere Eigenschaften fest.
  3. Erstellen Sie ein neues InventoryTargeting-Objekt und geben Sie an, welche Placement- oder AdUnit-Objekte als Ziel verwendet oder ausgeschlossen werden sollen.
  4. Umschließen Sie das InventoryTargeting-Objekt mit einem neuen Targeting-Objekt und weisen Sie es der Targeting-Eigenschaft der LineItem zu.
  5. Rufen Sie die Werbebuchungsdienstmethode createLineItems() mit Ihrem neuen Objekt auf und prüfen Sie das Ergebnis, um festzustellen, ob das Objekt erstellt wurde.

Beispiel

Weitere Informationen finden Sie unter Java-Code zum Erstellen einer Werbebuchung.

Creative erstellen

Verschiedene Creative-Typen unterstützen unterschiedliche Komponenten. So unterstützt ein Bild-Creative beispielsweise nur eine Quelldatei für das Bild und ein Flash-Creative unterstützt zwei zugrunde liegende Asset-Dateien: eine Flash-Datei und eine Reservebilddatei für den Fall, dass die Flash-Datei nicht ausgeliefert werden kann. Für Creatives, die auf Websites von Drittanbietern gehostet werden, laden Sie nur ein HTML-Snippet hoch, das auf die Datei auf dem Drittanbieterserver verweist. In der abgeleiteten Klasse Creative erfahren Sie, welche Assets Sie hochladen müssen, um Ihr Creative zu erstellen.

Beispiel

Siehe Java-Code zum Erstellen eines Bild-Creatives.

Vorhandenes Objekt ändern

Wenn Sie ein vorhandenes Objekt ändern möchten, rufen Sie getObjectsByStatement() auf, aktualisieren Sie die Werte in den zurückgegebenen Objekten und rufen Sie dann updateObjects() auf.

Hinweis: Aktualisierte Objekte ersetzen vorhandene Objekte vollständig. Wenn Sie im gesendeten Objekt keinen Attributwert angeben, erhält das gespeicherte Objekt also den Standardwert für dieses Attribut und nicht den vorherigen Wert.

Objektstatus ändern

Der Objektstatus kann durch Aufrufen der von Ihrem Dienst bereitgestellten Methode performObjectAction() geändert werden. Diese Methode verwendet zwei Parameter:

  • Eine Instanz des Aktionsobjekts, das beschreibt, was Sie tun möchten. Der Bestelldienst stellt beispielsweise mehrere Aktionen zur Verfügung, darunter ApproveOrders, PauseOrders und ArchiveOrders. Aktionsobjekte werden alle von einer Basisaktionsklasse abgeleitet, die für Ihren Dienst geeignet ist.
  • Eine PQL-Abfrage, die beschreibt, welche Objekte geändert werden sollen. Sie können den Status eines oder mehrerer Objekte gleichzeitig ändern, indem Sie eine entsprechende PQL-Anweisung angeben.

Anzeigen-Tags generieren

Sie können keine Anzeigen-Tags mit der API generieren. Verwenden Sie stattdessen die Google Ad Manager-Website. Weitere Informationen finden Sie in der Hilfe zu Tagging .

Weitere Beispiele

In unserem Beispielcode der Clientbibliothek finden Sie viele weitere Beispiele in verschiedenen Programmiersprachen. Auf der Seite Clientbibliotheken und Beispielcode finden Sie einen Link zu Beispielen in Ihrer Programmiersprache.