REST Resource: exchanges.auctionPackages

Ressource : AuctionPackage

Encapsule un seul package d'enchères. Les annonceurs de DV3 peuvent parcourir tous les packages d'enchères dans DV3 via l'interface utilisateur de découverte de la place de marché et choisir d'utiliser ces packages sans intervention du vendeur.

Représentation JSON 
{
  "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)
  ],
  "dv3MarketplaceUri": string
}
Champs
name

string

Identifiant. Nom de route relatif pour ce package d'enchères. Doit se présenter sous la forme : "exchanges/{seller_id}/auctionpackages/{auction_package_id}" Exemple : "exchanges/1234/auctionPackage/5678". Uniquement en sortie.
displayName

string

Obligatoire. Nom à afficher de ce package d'enchères. Doit être encodé au format UTF-8 et ne pas dépasser 240 caractères. Obligatoire.
status

enum (DiscoveryObjectStatus)

Obligatoire. État de ce package d'enchères. Les packages dont l'état est PAUSED ou REMOVED ne sont pas affichés pour les annonceurs DV3. Obligatoire.
description

string

Obligatoire. Texte de description de ce package. Doit être encodé au format UTF-8 et ne pas dépasser 2 000 caractères. Obligatoire.
format

enum (Format)

Obligatoire. Immuable. Type de format d'annonce sous-jacent. Obligatoire. Les modifications ne sont pas autorisées après la création.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

Facultatif. Répartition des prévisions pour l'inventaire de ce package d'enchères. Les annonceurs DV3 peuvent consulter et filtrer ces répartitions. Facultatif.
externalDealId

string

Obligatoire. Immuable. ID d'accord de la place de marché utilisé dans les demandes d'enchères. 100 caractères max. Caractères autorisés : alphanumériques, trait de soulignement, tiret et point. Obligatoire. Obligatoire. Les modifications ne sont pas autorisées après la création.
logoUrl

string

Uniquement en sortie. URL du logo de ce package d'enchères.

Uniquement en sortie.
floorPrice

object (Money)

Obligatoire. Prix plancher de ce package d'enchères. Obligatoire.
startTime

string (Timestamp format)

Obligatoire. Heure à laquelle ce produit devient actif. Doit être antérieure à l'heure de fin. L'heure de début ne peut pas être postérieure de plus d'un an. Obligatoire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Obligatoire. Heure à laquelle ce produit devient inactif. Obligatoire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
mediumType

enum (MediumType)

Obligatoire. Type de support du package d'enchères.
urgOwners[]

enum (UnderRepresentedGroup)

Facultatif. Groupes sous-représentés auxquels le propriétaire appartient, le cas échéant.
dv3MarketplaceUri

string

Uniquement en sortie. Lien Dv360 pour le package d'enchères sur la place de marché.

Format

Format d'annonce pour le package d'enchères.

Enums
DEAL_FORMAT_UNSPECIFIED Format d'accord non spécifié. Non valide pour l'entrée.
DEAL_FORMAT_DISPLAY Format display.
DEAL_FORMAT_VIDEO Format vidéo.
DEAL_FORMAT_AUDIO Format audio.

Méthodes

create

 Crée un package d'enchères.

get

 Obtient un package d'enchères.

list

 Liste les packages d'enchères.

patch

 Met à jour un package d'enchères.
Importe le logo du package spécifié.