REST Resource: sellers.availabilityOrders

Ressource: AvailabilityOrder

Eine Verfügbarkeitsbestellung ist eine Sammlung von AvailabilityLines. Die Reihenfolge der Verfügbarkeit wird vom Käufer erstellt. Der Verkäufer aktualisiert die Verfügbarkeit mit der Antwort.

So sieht der Workflow aus:

  • Der Käufer erstellt Verfügbarkeitsauftrag und -positionen und setzt den Status auf "Ausstehend". Weitere Änderungen durch den Käufer am Verfügbarkeitsauftrag oder der Werbebuchung sind nicht zulässig.
  • Der Verkäufer agiert bei allen Verfügbarkeitszeilen entweder mit den Verfügbarkeitsbedingungen oder kennzeichnet ihn als abgelehnt. Aktionen können nur abgeschlossen oder abgelehnt werden, wenn der Auftrag und die Zeilen den Status „Ausstehend“ haben.
  • Der Verkäufer verwendet complete benutzerdefinierte Aktion, um die Verfügbarkeitsanfrage als abgeschlossen zu markieren. Weitere Änderungen an der Verfügbarkeitsreihenfolge oder den untergeordneten Zeilen sind nach Abschluss nicht mehr zulässig.
JSON-Darstellung 
{
  "name": string,
  "description": string,
  "state": enum (State),
  "expireTime": string,
  "createTime": string,
  "updateTime": string,
  "advertiserInfo": {
    object (AdvertiserInfo)
  }
}
Felder
name

string

Nur Ausgabe. Der Ressourcenname der Verfügbarkeitsreihenfolge im Format: sellers/{seller}/availabilityOrders/{id}.
description

string

Nur Ausgabe. Zusätzliches freies Feld zur Beschreibung der Verfügbarkeitsreihenfolge.
state

enum (State)

Nur Ausgabe. Der Status dieser Verfügbarkeitsbestellung. Informationen zum Lebenszyklus eines AvailabilityOrders findest du unter AvailabilityOrder.State.

Der Verkäufer kann die benutzerdefinierte Methode Complete verwenden, um STATE_COMPLETED festzulegen.
expireTime

string (Timestamp format)

Nur Ausgabe. Ablaufzeitstempel für die ausstehende Verfügbarkeitsbestellung. Der Verkäufer muss dieses Angebot abschließen, bevor eine ausstehende Bestellung mit Verfügbarkeit abläuft. Andernfalls wird sie als abgeschlossen und ohne Verfügbarkeit behandelt.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der Erstellung. Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung. Vom System zugewiesen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
advertiserInfo

object (AdvertiserInfo)

Nur Ausgabe. Informationen zum Werbetreibenden.

Status

Mögliche Werte für den Status der Verfügbarkeitsbestellung.

Enums
STATE_UNSPECIFIED Der Standardwert, wenn der Verfügbarkeitsstatus nicht angegeben wurde oder in dieser Version unbekannt ist.
STATE_PENDING Die Verfügbarkeit ausstehend, als der Käufer die Einstellungen für die Verfügbarkeitsanforderung angegeben hat.
STATE_COMPLETED Verfügbarkeitsstatus fertiggestellt, wenn der Verkäufer die Verfügbarkeitsantwort für alle Zeilen gesendet hat.
STATE_CANCELLED Der Status „Verfügbarkeit“ wurde abgebrochen, wenn der Käufer die Stornierungsanfrage gestellt hat, bevor der Verkäufer die Antwort auf die Verfügbarkeit für alle Zeilen gesendet hat.
STATE_EXPIRED Abgelaufener Verfügbarkeitsstatus, wenn die Bestellung abgelaufen ist, bevor der Verkäufer sie abgeschlossen hat.

Methoden

complete

 Markiert einen vorhandenen Verfügbarkeitsauftrag als abgeschlossen.

get

 Ruft eine einzelne Verfügbarkeitsreihenfolge ab.

list

 Listet verfügbare Bestellungen auf.