Method: exchanges.orders.patch

Aktualisiert eine Bestellung.

HTTP-Anfrage

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
order.name

string

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string
  },
  "updateMask": string
}
Felder
order.displayName

string

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

string (int64 format)

Partner-IDs in Google Display & Video 360, früher DoubleClick Bid Manager(DBM). Erforderlich.
order.publisherEmail

string

E-Mail-Adresse des Publishers. Muss ein gültiges E-Mail-Format sein. Maximal 250 Zeichen. Optional.
order.publisherName

string

Name des Publishers. Maximal 250 Zeichen. Erforderlich.
order.budget

object (Budget)

Budget Gilt nur für Instant-Deal-Szenarien. Nur Ausgabe.
order.status

enum (OrderStatus)

Bestellstatus – Der Status kann sich ändern, nachdem DV3-Nutzer eine Bestellung angenommen, storniert oder archiviert haben. Es wird auch unterstützt, den Status nach der Erstellung in der API auf „CANCELLED“ (STORNIERT) zu aktualisieren, um anzuzeigen, dass diese Bestellung auf dem Marktplatz storniert wurde.
order.wseatConfig

object (WSeatConfig)

Optional. WSeat-Konfiguration Gibt die WSeat-Konfiguration auf der Anzeigenplattformseite an. Anzeigenplattformen, die Multi-Sitzplatz-Deals nutzen, müssen dieses Feld ausfüllen und auf dem neuesten Stand halten.
order.updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann der Auftrag oder die zugrunde liegenden Produkte aktualisiert wurden.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
updateMask

string (FieldMask format)

Die Maske, um zu steuern, welche Felder aktualisiert werden. Erforderlich.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Order.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Weitere Informationen finden Sie unter OAuth 2.0 Overview.