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 Verlags oder Webpublishers. Max. 250 Zeichen. Erforderlich.
budget

object (Budget)

Nur Ausgabe. Das vom Käufer festgelegte Budget. Gilt nur für Sofortangebote.
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“ nach der Erstellung in der API unterstützt, um zu signalisieren, dass diese Bestellung an der Börse storniert wurde.
wseatConfig

object (WSeatConfig)

Optional. WSeat Configuration Specifies the WSeat configuration on the exchange side. 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 zugrunde liegenden 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 Sofortangebote.

Budget

Budget angegeben.

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

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
Felder
budgetType

enum (BudgetType)

Der angegebene Budgettyp.
Union-Feld budget. Es kann nur ein Budgettyp angegeben werden. Für budget ist nur einer der folgenden Werte zulässig:
impressions

string (int64 format)

Impressionsbudget.
money

object (Money)

Währungsbudget.

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 ist „Storniert“.
NEGOTIATING Verhandlungsstatus der Bestellung. 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 Exchange-Seite.
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.