REST Resource: exchanges.orders

Ressource: Bestellung

Ein nicht verhandelbares Angebot, das ein Käufer annehmen kann.

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Felder
name

string

Relativer Ressourcenname für die Bestellung. Vom Server generiert. Beispiel: „exchanges/1234/orders/5678“. Nur Ausgabe.
displayName

string

Der Name der Bestellung, der dem Käufer angezeigt wird. Max. 250 Zeichen. Optional.
partnerId[]

string (int64 format)

Partner-ID in Google Display & Video 360, früher DoubleClick Bid Manager(DBM). Es ist nur eine Partner-ID zulässig. Erforderlich.
publisherEmail

string

E-Mail-Adresse für den Publisher. Muss ein gültiges E‑Mail-Format sein. Max. 250 Zeichen. Optional.
publisherName

string

Name des Publishers. Max. 250 Zeichen. Erforderlich.
budget

object (Budget)

Nur Ausgabe. Das vom Käufer festgelegte Budget. Gilt nur für Sofortangebot-Szenarien.
status

enum (OrderStatus)

Bestellstatus – Der Status kann sich ändern, nachdem DV3-Nutzer eine Bestellung annehmen, stornieren oder archivieren. Außerdem wird die Aktualisierung auf „CANCELLED“ (ABGEBROCHEN) nach der Erstellung in der API unterstützt, um zu signalisieren, dass diese Bestellung auf der Börse storniert wurde.
wseatConfig

object (WSeatConfig)

Optional. WSeat-Konfiguration: Gibt die WSeat-Konfiguration auf der Exchange-Seite an. Börsen, die Multi-Seat-Deals nutzen, müssen dieses Feld ausfüllen und auf dem neuesten Stand halten.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Auftrag oder die zugehörigen Produkte aktualisiert wurden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
buyerInfo

object (BuyerInfo)

Nur Ausgabe. Die Käuferinformationen, einschließlich Partner- und Werbetreibendendetails. Gilt nur für Sofortangebot-Szenarien.

Budget

Budget angegeben.

JSON-Darstellung 
{
  "budgetType": enum (BudgetType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of mutually exclusive fields.
}
Felder
budgetType

enum (BudgetType)

Der angegebene Budgettyp.
Es kann nur ein Budgettyp enthalten sein. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
impressions

string (int64 format)

Impressionsbudget.
money

object (Money)

Währungsbudget.
Ende der sich gegenseitig ausschließenden Felder.

BudgetType

Budgettypen

Enums
BUDGET_TYPE_UNSPECIFIED Nicht angegebenes Budget. Nicht für die Eingabe gültig.
BUDGET_TYPE_CURRENCY Währungsbudget.
BUDGET_TYPE_IMPRESSION Impressionsbudget.

OrderStatus

Status der Bestellung.

Enums
ORDER_STATUS_UNSPECIFIED Der Bestellstatus ist nicht angegeben. Unerwartet. Der Verhandlungsstatus ist unbekannt. Ungültiger Eingabewert.
PENDING_ACCEPTANCE Der Bestellstatus ist „Annahme ausstehend“.
ACCEPTED Bestellstatus „Angenommen“.
ARCHIVED Der Bestellstatus wurde archiviert.
CANCELLED Der Bestellstatus wurde auf „Storniert“ gesetzt.
NEGOTIATING Verhandlung des Bestellstatus. Gilt nur für Instant Deal-Szenarien.

WSeatConfig

WSeat-Konfiguration.

JSON-Darstellung 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Felder
exchangeWseatStatus

enum (WSeatStatus)

Optional. Der aktuelle Status der WSeat-Konfiguration auf Exchange-Seite.
exchangeWseatIds[]

string (int64 format)

Optional. WSeat-IDs auf der Anzeigenplattformseite.
updateTime

string (Timestamp format)

Nur Ausgabe. Dieses Feld wird von DV3 automatisch aktualisiert, wenn WSeatConfiguration durch den Austausch aktualisiert wird.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

WSeatStatus

WSeat-Status-Enum-Optionen.

Enums
W_SEAT_STATUS_UNSPECIFIED WSeatStatus nicht angegeben.
W_SEAT_STATUS_ENFORCED WSeatStatus wird erzwungen. Gibt an, ob Exchange die WSeatId erzwingt, indem die WSeatId an DV3 gesendet oder WSeatIds in Gebotsantworten überprüft werden.
W_SEAT_STATUS_NOT_ENFORCED „WSeatStatus“ wird nicht erzwungen. Gibt an, dass die Anzeigenplattform „wseatid“ nicht in Gebotsanfragen sendet und „wseatid“ in Gebotsanfragen nicht validiert.

BuyerInfo

Käuferinformationen für Instant-Deal-Szenarien.

JSON-Darstellung 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Felder
partner

object (PartnerInfo)

Nur Ausgabe. Partnerinformationen.
advertisers[]

object (AdvertiserInfo)

Nur Ausgabe. Informationen zum Werbetreibenden.

PartnerInfo

Partnerinformationen für Instant-Deal-Szenarien.

JSON-Darstellung 
{
  "title": string
}
Felder
title

string

Nur Ausgabe. Anzeigename des Partners in Display & Video 360.

AdvertiserInfo

Informationen für Werbetreibende für Instant-Deal-Szenarien.

JSON-Darstellung 
{
  "advertiserId": string,
  "domainUri": string
}
Felder
advertiserId

string (int64 format)

Nur Ausgabe. Werbetreibenden-ID in Display & Video 360.
domainUri

string

Nur Ausgabe. Der Domain-URI der Website des Werbetreibenden.

Methoden

accept

 Nimmt die Bestellung an.

create

 Erstellt einen Auftrag.

get

 Ruft eine Bestellung ab.

list

 Listet die Reihenfolge auf.

patch

 Aktualisiert eine Bestellung.