Method: exchanges.auctionPackages.patch

Met à jour un package d'enchères.

Requête HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{auctionPackage.name=exchanges/*/auctionPackages/*}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
auctionPackage.name

string

Identifiant. Nom de route relatif pour ce package d'enchères. Doit être au format "exchanges/{seller_id}/auctionpackages/{auction_package_id}". Exemple : "exchanges/1234/auctionPackage/5678".

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "auctionPackage": {
    "name": string,
    "displayName": string,
    "status": enum (DiscoveryObjectStatus),
    "description": string,
    "format": enum (Format),
    "forecast": {
      "weeklyImpressions": string,
      "weeklyUniques": string,
      "breakdowns": [
        {
          object (TargetingDimensionBreakdown)
        }
      ],
      "appsBreakdown": [
        {
          object (MobileAppSlice)
        }
      ]
    },
    "externalDealId": string,
    "logoUrl": string,
    "floorPrice": {
      "currencyCode": string,
      "units": string,
      "nanos": integer
    },
    "startTime": string,
    "endTime": string,
    "mediumType": enum (MediumType),
    "urgOwners": [
      enum (UnderRepresentedGroup)
    ],
    "dv3MarketplaceUri": string
  },
  "updateMask": string
}
Champs
auctionPackage.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.
auctionPackage.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.
auctionPackage.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.
auctionPackage.format

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

Obligatoire. Immuable. ID de l'accord d'échange 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. Les mises à jour ne sont pas autorisées après la création.
auctionPackage.logoUrl

string

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

object (Money)

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

string (Timestamp format)

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

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

string (Timestamp format)

Obligatoire. Heure à laquelle ce produit devient inactif.

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

enum (MediumType)

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

enum (UnderRepresentedGroup)

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

string (FieldMask format)

Facultatif. Masque permettant de contrôler les champs à mettre à jour.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".
auctionPackage.dv3MarketplaceUri

string

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

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de AuctionPackage.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.