Method: exchanges.orders.products.patch

Updates a product.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
product.name

string

Relative rouce name for prouct. Generated by server. Example: "exchanges/1234/orders/5678/proucts/abc". Output only.

Request body

The request body contains data with the following structure:

JSON representation
{
  "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)
  },
  "updateMask": string
}
Fields
product.displayName

string

The display name of the product.

Must be UTF-8 encoded with a maximum size of 240 bytes. Required.

product.externalDealId

string

External ID. This is the deal ID on exchange system. Max 100 characters. Allowed characters are alphanumeric, underscore, dash, and dot. Must be unique across all products. Required.

product.transactionType

enum (TransactionType)

Product transaction type. Required.

product.pricingType

enum (PricingType)

Pricing type for product. Required.

product.updateTime

string (Timestamp format)

The timestamp when the product was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

product.startTime

string (Timestamp format)

Time when this product becomes active. Must be earlier than endTime. Start time cannot be more than 1 year in the future. Required.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

product.endTime

string (Timestamp format)

Time when this product becomes inactive. Currently cannot be later than year 2036. Required.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

product.rateDetails

object (RateDetails)

Rate details. Required.

product.creativeConfig[]

object (CreativeConfig)

The creative requirements for a product. Required for reserved transaction type product.

product.makegood

boolean

Denotes whether a product is a makegood product.

product.makegoodDetails

object (MakegoodDetails)

The makegood details for a product. Required when the product is a makegood.

product.creativeSource

enum (CreativeSource)

Creative source for a product. Optional, defaults to CREATIVE_SOURCE_ADVERTISER. Cannot be changed after product creation.

updateMask

string (FieldMask format)

The mask to control which fields to update. Required.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Response body

If successful, the response body contains an instance of Product.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.