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,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
Felder
order.displayName

string

Der Name der Bestellung, der dem Käufer angezeigt wird. Max. 250 Zeichen. Optional.
order.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.
order.publisherEmail

string

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

string

Name des Verlags oder Webpublishers. Max. 250 Zeichen. Erforderlich.
order.budget

object (Budget)

Nur Ausgabe. Das vom Käufer festgelegte Budget. Gilt nur für Sofortangebote.
order.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.
order.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.
order.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".
order.buyerInfo

object (BuyerInfo)

Nur Ausgabe. Die Käuferinformationen, einschließlich Partner- und Werbetreibendendetails. Gilt nur für Sofortangebote.
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.