REST Resource: exchanges.auctionPackages

Resource: AuctionPackage

Encapsulates a single auction package. Advertisers in DV3 can browse all auction packages in DV3 via the marketplace discovery UI and opt in to use these packages without seller action.

JSON representation
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ]
}
Fields
name

string

Relative route name for this auction package. Should be of the form: "exchanges/{seller_id}/auctionpackages/{auction_package_id} Example: "exchanges/1234/auctionPackage/5678". Output only.

displayName

string

The display name of this auction package. Must be UTF-8 encoded with a maximum size of 150 characters. Required.

status

enum (DiscoveryObjectStatus)

The status of this auction package. Packages with status PAUSED or REMOVED are not shown to DV3 advertisers. Required.

description

string

The description text for this package. Must be UTF-8 encoded with a maximum size of 290 characters. Required.

format

enum (Format)

The underlying ad format type. Required. Updates not allowed after creation.

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Forecasting breakdown for this auction package’s inventory. DV3 advertisers can see and filter on these breakdowns. Optional.

externalDealId

string

The exchange deal id used in bid requests. Max 100 characters. Allowed characters are alphanumeric, underscore, dash, and dot. Required. Required. Not allow updates after creation.

logoUrl

string

Output only. The url for the logo of this auction package.

Output only.

floorPrice

object (Money)

The floor price of this auction package. Required.

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

endTime

string (Timestamp format)

Time when this product becomes inactive. 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".

mediumType

enum (MediumType)

Required. Medium type of the auction package.

urgOwners[]

enum (UnderRepresentedGroup)

Optional. Under represented groups the owner is a member of, if any.

Format

Ad format for auction package.

Enums
DEAL_FORMAT_UNSPECIFIED Deal format unspecified. Not valid for input.
DEAL_FORMAT_DISPLAY Display format.
DEAL_FORMAT_VIDEO Video format.
DEAL_FORMAT_AUDIO Audio format.

MediumType

Medium type. The Marketplace frontend (within DV360’s Inventory Module) includes different sections for inventory. "Digital: This includes publishers & auction packages spanning across Display, Video (incl. CTV & OTT) and Audio inventory." "TV: This is our newly launched dedicated section for discovering CTV & OTT inventory. CTV & OTT are defined as below: "Connected TV (CTV) includes all devices that fit into the following descriptions: - Connected or Streaming devices: Devices that connect to a TV screen to display video streams (Roku, Apple TV, etc.) - Smart TV: TVs with integrated Internet connections (Samsung Smart TV, etc.) - Gaming consoles: Internet-connected gaming consoles (Xbox, PlayStation, Wii, etc.) - Set top boxes: Devices delivering traditional cable and video on demand content." "Over the Top (OTT) means TV-like video content delivered by a video provider over the Internet outside the closed networks of telecom and cable providers. OTT Video can be viewed on desktop, mobile, tablet, as well as CTV or STB devices (as long as the content is delivered over IP for the latter). "Audio: This is a newly launched, dedicated section for audio inventory."

Enums
MEDIUM_TYPE_UNSPECIFIED Medium type unspecified.
MEDIUM_TYPE_DIGITAL Medium type digital.
MEDIUM_TYPE_TV Medium type TV.
MEDIUM_TYPE_AUDIO Medium type audio.

Methods

create

Creates a new auction package.

get

Gets an auction package.

list

Lists auction packages.

patch

Updates an auction package.
Upload logo for the specified package.