Method: exchanges.orders.products.patch

Aktualisiert ein Produkt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
product.name

string

Relativer Ressourcenname für das Produkt. Vom Server generiert. Beispiel: „exchanges/1234/orders/5678/products/abc“. Nur Ausgabe.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "program": string,
    "buyerCustomParameters": {
      string: string,
      ...
    },
    "etag": string
  },
  "updateMask": string
}
Felder
product.displayName

string

Der Anzeigename des Produkts.

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein. Erforderlich.
product.externalDealId

string

Externe ID. Dies ist die Deal-ID im Anzeigenplattform-System. Max. 100 Zeichen. Zulässige Zeichen sind alphanumerische Zeichen, Unterstriche, Bindestriche und Punkte. Muss für alle Produkte eindeutig sein. Erforderlich.
product.transactionType

enum (TransactionType)

Produkttyp der Transaktion. Erforderlich.
product.pricingType

enum (PricingType)

Preistyp für das Produkt. Erforderlich.
product.updateTime
(deprecated)

string (Timestamp format)

Der Zeitstempel, der angibt, wann das Produkt zuletzt aktualisiert wurde.

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".
product.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.

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

string (Timestamp format)

Zeitpunkt, zu dem dieses Produkt inaktiv wird. Darf nicht nach 2036 liegen. Erforderlich.

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".
product.rateDetails

object (RateDetails)

Preisdetails. Erforderlich.
product.creativeConfig[]

object (CreativeConfig)

Die Creative-Anforderungen für ein Produkt. Erforderlich für reservierte Transaktionstypen.
product.makegood
(deprecated)

boolean

Gibt an, ob es sich bei einem Produkt um ein Kulanzprodukt handelt.
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

Die Details zur Ausgleichsbuchung für ein Produkt. Erforderlich, wenn es sich bei dem Produkt um eine Ausgleichsbuchung handelt.
product.creativeSource

enum (CreativeSource)

Creative-Quelle für ein Produkt. Optional; der Standardwert ist CREATIVE_SOURCE_ADVERTISER. Kann nach dem Erstellen des Produkts nicht mehr geändert werden.
product.mediumType

enum (MediumType)

Medientyp für ein Produkt. Wenn keine Angabe gemacht wird, ist der Standardwert DIGITAL (aus Gründen der Abwärtskompatibilität). Kann nach dem Erstellen des Produkts nicht mehr geändert werden.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

Optional. Die Konfiguration des Zielgruppen-Targetings wird auf Deal-Ebene in der Anzeigenplattform angewendet.
product.targetingCriteria

object (TargetingCriteria)

Nur Ausgabe. Referenzen für Produkt-Targeting-Kriterien. Gilt nur für Szenarien mit Instant-Deals.
product.forecastResult

object (ForecastResult)

Ergebnisse der Produktprognose. Erforderlich, wenn die Targeting-Kriterien nicht leer sind und die Prognose nicht angegeben ist. Gilt nur für Szenarien mit Instant-Deals.
product.errorDetails

object (ErrorDetails)

Wenn bestimmte Produktfelder nicht aktualisiert werden können, müssen Fehlerdetails angegeben werden. Erforderlich, wenn das Prognoseergebnis aufgrund eines Targeting-Kriteriums nicht bereitgestellt werden kann oder das Produkt nicht aktualisiert werden kann. Gilt nur für Szenarien mit Instant-Deals.
product.frequencyCap

object (FrequencyCap)

Nur Ausgabe. Vom Käufer ausgewähltes Frequency Capping. Gilt nur für Szenarien mit Instant-Deals.
product.program

string

Nur Ausgabe. Das Programm, unter dem der Käufer den Instant-Deal erstellt hat. Leer für den regulären Ablauf des Austauschs. Gilt nur für Szenarien mit Instant-Deals.
product.buyerCustomParameters

map (key: string, value: string)

Nur Ausgabe. Benutzerdefinierte Parameter für Schlüssel/Wert-Paare, die vom Käufer in der Anfrage für einen Instant-Deal festgelegt wurden. Gilt nur für Szenarien mit Instant-Deals.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
product.etag

string

Ein ETag, das beim Aktualisieren eines Produkts angegeben werden muss. Er muss nur für eine Aktualisierung angegeben werden, wenn das Feld „etag“ nicht leer ist. Gilt nur für Szenarien mit Instant-Deals.
updateMask

string (FieldMask format)

Die Maske, mit der gesteuert wird, welche Felder aktualisiert werden sollen. 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 Product.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.