Anleitung

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

Nutzer erstellen

Der UserService ermöglicht Nutzer mit Administratorrechten zum Erstellen für einen Nutzer direkt in seinem Netzwerk. Jeder Entwickler kann dies tun, dass sich der neue Nutzer zunächst registrieren muss. Wenn Sie die API zum Beispiel anstatt jeden API-Aufruf als Administrator auszuführen (Standardeinstellung für Ihre E-Mail-Adresse). Möglicherweise möchten Sie einige Nutzer mit Rollen wie Vertriebsmitarbeiter, Trafficker oder Werbetreibender, um Workflows in der realen Welt zu testen.

  1. Erstellen Sie einige neue Gmail-Adressen, z. B. my.name.salesperson@gmail.com. Alternativ können Sie Registrieren Sie eine bestehende E-Mail-Adresse, die keine Gmail-Adresse ist, als neue Google-Konto.
  2. Rufe createUsers mit der neuen Adresse und der ausgewählten Role auf.
  3. Sie können sich als dieser neue Nutzer authentifizieren, indem Sie OAuth 2.0 verwenden, um Ihr Zugriffstoken zu generieren.

Root-Anzeigenblock abrufen

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

Um den effektiven Stamm abzurufen, rufen Sie NetworkService.getCurrentNetwork() auf und prüfen Sie das Feld effectiveRootAdUnitId des zurückgegebenen Network-Objekts.

Hinweis:Verschiedene Kontotypen unterstützen unterschiedliche Hierarchiemuster.

Objekt abfragen

Mit der Methode getObjectsByStatement() suchen Sie anhand von Suchkriterien nach Objekten die von vielen Diensten bereitgestellt werden, wobei Object ein bestimmter Objekttyp ist. Dieses verwendet eine PQL-Abfrage, die einer SQL-Abfrage insofern ähnelt, als Sie damit angeben können, Felder, nach denen gesucht werden soll (wobei Feldnamen den Eigenschaften des Objekts zugeordnet sind), sortieren, und Suchergebnisse zu verschieben. Siehe PQL Leitfaden finden Sie weitere Informationen zu PQL und zu den Objektfeldern, die Sie Filtern nach.

Erstellen eines Auftrags

Um einen Auftrag zu erstellen, erstellen Sie einfach ein Order-Objekt und legen den Werbetreibenden fest, Verkäufer-IDs und Trafficker-IDs den entsprechenden Nutzern einen eindeutigen Namen, und rufe createOrders() an. Das Ergebnis enthält die neu erstellte Order, oder ein Fehler auftritt.

Beispiel

Siehe Beispiel für den 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.
  2. Erstellen Sie ein neues LineItem-Objekt und legen Sie den Rotationstyp, das Creative-Größenarray Start- und Enddatum und andere Eigenschaften.
  3. Erstellen Sie ein neues InventoryTargeting-Objekt und geben Sie an, welche Placement- oder AdUnit-Objekte ein- oder ausgeschlossen werden sollen.
  4. Verpacken Sie Ihr InventoryTargeting-Objekt in ein neues Targeting-Objekt und weisen Sie ihm an die Ausrichtungs-Property von LineItem.
  5. Rufen Sie mit Ihrem neuen Objekt die Methode createLineItems() für den Positionsdienst auf und prüfen Sie anhand des Ergebnisses, ob das Objekt erstellt wurde.

Beispiel

Siehe den Java-Code zum Erstellen einer Werbebuchung.

Creative erstellen

Unterschiedliche Creative-Typen unterstützen unterschiedliche Komponenten, z. B. ein Bild. Das Creative unterstützt eine einzige Quelldatei für das Bild. unterstützt ein Flash-Creative zwei zugrunde liegende Asset-Dateien: eine Flash-Datei und eine Backup-Image-Datei für den Fall, dass die Flash-Datei -Datei kann nicht geliefert werden. Bei Creatives, die auf Websites von Drittanbietern gehostet werden, laden Sie nur ein HTML-Snippet, das auf die Datei auf dem Server des Drittanbieters verweist. Anzeigen Ihres spezifische abgeleitete Creative-Klasse, um zu erfahren, welche Assets Sie um Ihr Creative zu erstellen.

Beispiel

Siehe den Java-Code zum Erstellen eines Bild-Creatives.

Vorhandenes Objekt ändern

Wenn Sie ein vorhandenes Objekt ändern möchten, fragen Sie es durch Aufrufen von getObjectsByStatement() ab. die Werte in den zurückgegebenen Objekten aktualisieren und dann updateObjects() aufrufen.

Hinweis:Durch aktualisierte Objekte werden vorhandene Objekte vollständig ersetzt. einen Eigenschaftswert im gesendeten Objekt nicht festlegen, wird das gespeicherte Objekt erhalten Sie den Standardwert für diese Eigenschaft, nicht den vorherigen Wert.

Objektstatus ändern

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

  • Eine Instanz des Aktionsobjekts, das beschreibt, was Sie tun möchten. Für bietet der Bestelldienst mehrere Aktionen, darunter ApproveOrders, PauseOrders, und ArchiveOrders. Alle Aktionsobjekte stammen aus einer Basisaktion Klasse, die für Ihren Dienst geeignet ist.
  • Eine PQL-Abfrage, die beschreibt, welche Objekte geändert werden sollen. Sie können Status eines oder mehrerer Objekte gleichzeitig abrufen, indem Sie eine entsprechende PQL angeben .

Anzeigen-Tags generieren

Sie können mit der API keine Anzeigen-Tags generieren. müssen Sie die Google Ad Manager-Website verwenden. Weitere Informationen finden Sie im Abschnitt zur Tag-Kennzeichnung Hilfeartikel für erhalten Sie weitere Informationen.

Weitere Beispiele

Weitere Beispiele finden Sie in unserem Beispielcode für die Clientbibliothek in verschiedenen Programmiersprachen. Weitere Informationen finden Sie unter Client-Bibliotheken und Beispielcode finden Sie einen Link zu Beispielen in Ihrer Programmiersprache.