Method: exchanges.auctionPackages.patch

Aktualisiert ein Auktionspaket.

HTTP-Anfrage

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
auctionPackage.name

string

ID. Relativer Routenname für dieses Auktionspaket. Muss das Format „exchanges/{seller_id}/auctionpackages/{auction_package_id}“ haben. Beispiel: „exchanges/1234/auctionPackage/5678“.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Felder
auctionPackage.displayName

string

Erforderlich. Der Anzeigename dieses Auktionspakets. Muss UTF-8-codiert sein und darf maximal 240 Zeichen lang sein.
auctionPackage.status

enum (DiscoveryObjectStatus)

Erforderlich. Der Status dieses Auktionspakets. Pakete mit dem Status PAUSED oder REMOVED werden DV360-Werbetreibenden nicht angezeigt.
auctionPackage.description

string

Erforderlich. Der Beschreibungstext für dieses Paket. Muss UTF-8-codiert sein und darf maximal 2.000 Zeichen lang sein.
auctionPackage.format

enum (Format)

Erforderlich. Nicht veränderbar. Der zugrunde liegende Anzeigenformattyp. Nach der Erstellung sind keine Aktualisierungen mehr zulässig.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Optional. Prognoseaufschlüsselung für das Inventar dieses Auktionspakets. DV360-Werbetreibende können diese Aufschlüsselungen sehen und danach filtern.
auctionPackage.externalDealId

string

Erforderlich. Nicht veränderbar. Die Deal-ID der Anzeigenplattform, die in Gebotsanfragen verwendet wird. Max. 100 Zeichen. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte. Nach der Erstellung sind keine Aktualisierungen mehr zulässig.
auctionPackage.logoUrl

string

Nur Ausgabe. Die URL für das Logo dieses Auktionspakets.
auctionPackage.floorPrice

object (Money)

Erforderlich. Der Mindestpreis dieses Auktionspakets.
auctionPackage.startTime

string (Timestamp format)

Erforderlich. Der Zeitpunkt, zu dem dieses Produkt aktiv wird. Muss vor „endTime“ liegen. Die Startzeit darf nicht mehr als ein Jahr in der Zukunft liegen.

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"
auctionPackage.endTime

string (Timestamp format)

Erforderlich. Der Zeitpunkt, zu dem dieses Produkt inaktiv 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"
auctionPackage.mediumType

enum (MediumType)

Erforderlich. Der Medientyp des Auktionspakets.
auctionPackage.urgOwners[]

enum (UnderRepresentedGroup)

Optional. Unterrepräsentierte Gruppen, denen der Inhaber angehört (falls zutreffend).
updateMask

string (FieldMask format)

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

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

Nur Ausgabe. DV360-Link für das Auktionspaket auf dem Marktplatz.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.