API-Workflows

In diesem Leitfaden werden gängige API-Workflows zum Erstellen, Abrufen und Aktualisieren von Auktionspaketen in Display &Video 360 beschrieben.

Liste der Auktionspakete abrufen

Rufen Sie die LIST API auf. Die Filterung nach external_deal_id wird unterstützt.

Neues Auktionspaket erstellen

  1. external_deal_id muss eindeutig sein. Rufen Sie LIST mit external_deal_id auf, um zu prüfen, ob die ID bereits verwendet wurde.
  2. Rufen Sie die Create API auf. Es wird ein eindeutiger Name zugewiesen, mit dem Sie das erstellte Paket abrufen können.
  3. Rufen Sie die Get API auf, um Details zum erstellten Auktionspaket zu sehen.
  4. Optional: Laden Sie ein Logo für das erstellte Paket hoch.

Auktionspaket aktualisieren

  1. Wenn Sie den Namen des erstellten Auktionspakets nicht speichern, rufen Sie die LIST API mit dem Filter external_deal_id auf, um das Auktionspaket zu erhalten, das Sie aktualisieren möchten.
  2. Aktualisieren Sie die Felder anhand der Ergebnisse der LIST API.
  3. Rufen Sie die Patch API auf, um das Auktionspaket zu aktualisieren. Die updateMask ist erforderlich. Sie gibt an, auf welche Felder die Aktualisierung angewendet werden soll. In der updateMask können nur Felder festgelegt werden, die aktualisiert werden dürfen.

Betaprozess

Der einzige Unterschied zwischen der Beta- und der GA-Version besteht darin, dass bei der Betaversion der Status der erstellten Auktionspakete auf DISCOVERY_OBJECT_STATUS_PAUSED gesetzt sein muss und der Status nicht aktualisiert werden kann. Pausierte Pakete sind in der Display & Video 360-Benutzeroberfläche nicht sichtbar. So können Exchanges die API-Integration testen, ohne Testpakete zu zeigen.

In der Regel werden alle „echten“ Pakete in der Betaversion als „Pausiert“ erstellt und dann in der GA-Version aktiviert.

Quota

2.000 aktive Pakete pro Exchange.

2.000 pausierte Pakete pro Exchange.

Zurück
Überblick