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

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

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

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

enum (DiscoveryObjectStatus)

Der Status dieses Auktionspakets. Pakete mit dem Status „PAUSIERT“ oder „ENTFERNT“ werden DV3-Werbetreibenden nicht angezeigt. Erforderlich.
auctionPackage.description

string

Der Beschreibungstext für dieses Paket. Muss UTF-8-codiert sein und eine maximale Größe von 2.000 Zeichen haben. Erforderlich.
auctionPackage.format

enum (Format)

Der zugrunde liegende Anzeigenformattyp. Erforderlich. Nach dem Erstellen sind keine Aktualisierungen mehr möglich.
auctionPackage.forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Aufschlüsselung der Prognose für das Inventar dieses Auktionspakets. DV3-Werbetreibende können diese Aufschlüsselungen sehen und nach ihnen filtern. Optional.
auctionPackage.externalDealId

string

Die Deal-ID der Anzeigenplattform, die in Gebotsanfragen verwendet wird. Max. 100 Zeichen. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte. Erforderlich. Erforderlich. Aktualisierungen nach der Erstellung nicht zulassen.
auctionPackage.logoUrl

string

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

Nur Ausgabe.
auctionPackage.floorPrice

object (Money)

Der Mindestpreis dieses Auktionspakets. Erforderlich.
auctionPackage.startTime

string (Timestamp format)

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

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

string (Timestamp format)

Datum und Uhrzeit, zu dem dieses Produkt inaktiv wird. Erforderlich.

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

enum (MediumType)

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

enum (UnderRepresentedGroup)

Optional. Unterrepräsentierte Gruppen, in denen der Inhaber Mitglied ist, falls zutreffend.
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".
auctionPackage.dv3MarketplaceUri

string

Nur Ausgabe. DV360-Link für 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.