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),

      // 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.
    },
    "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

Name der Bestellung, die 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 des Publishers. Muss ein gültiges E-Mail-Format haben. Max. 250 Zeichen. Optional.
order.publisherName

string

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

object (Budget)

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

enum (OrderStatus)

Bestellstatus – Der Status kann sich ändern, nachdem DV3-Nutzer eine Bestellung akzeptiert, storniert oder archiviert haben. 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. Die WSeat-Konfiguration gibt die WSeat-Konfiguration auf der Börsenseite an. Börsen, die Multi-Seat-Deals verwenden, müssen dieses Feld aktuell halten.
order.updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, an dem die Bestellung 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 Instant Deal-Szenarien.
updateMask

string (FieldMask format)

Die Maske, mit der gesteuert wird, welche Felder aktualisiert werden sollen. Erforderlich.

Dies ist eine durch Kommas getrennte Liste voll 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.