REST Resource: exchanges.auctionPackages

Ressource: AuctionPackage

Encapsule un seul package d'enchères. Les annonceurs DV3 peuvent parcourir tous les packages d'enchères DV3 via l'interface utilisateur de la découverte de place de marché et choisir d'utiliser ces packages sans action 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

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

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)

État de ce package d'enchères. Les packages dont l'état est "EN PAUSE" ou "SUPPRIMÉ" ne sont pas diffusés auprès des annonceurs DV3. Obligatoire.

description

string

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)

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

forecast

object (SellerProvidedInventoryAvailabilityEstimate)

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

externalDealId

string

ID de l'accord de place de marché utilisé dans les demandes d'enchères. 100 caractères max. Les caractères autorisés sont les caractères alphanumériques, les traits de soulignement, les tirets et les points. Obligatoire. Obligatoire. Ne pas autoriser les mises à jour 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)

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

startTime

string (Timestamp format)

Heure à laquelle ce produit devient actif. Doit être antérieure à "endTime". L'heure de début ne peut pas être postérieure de plus d'un an à la date du jour. Obligatoire.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" 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)

Date à laquelle ce produit devient inactif. Obligatoire.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" 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 dont le propriétaire est membre, 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 de l'accord non spécifié. Valeur non valide.
DEAL_FORMAT_DISPLAY Format d'affichage.
DEAL_FORMAT_VIDEO Format vidéo.
DEAL_FORMAT_AUDIO Format audio.

Méthodes

create

Crée un package d'enchères.

get

Récupère un package d'enchères.

list

Liste les packages d'enchères.

patch

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