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

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.

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

Nom à afficher de ce package d'enchères. Doit être encodé au format UTF-8 et ne pas dépasser 240 caractères. Obligatoire.
auctionPackage.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.
auctionPackage.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.
auctionPackage.format

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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.
auctionPackage.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.
auctionPackage.logoUrl

string

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

Uniquement en sortie.
auctionPackage.floorPrice

object (Money)

Prix plancher de ce package d'enchères. Obligatoire.
auctionPackage.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".
auctionPackage.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".
auctionPackage.mediumType

enum (MediumType)

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

enum (UnderRepresentedGroup)

Facultatif. Groupes sous-représentés dont le propriétaire est membre, le cas échéant
updateMask

string (FieldMask format)

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

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 en savoir plus, consultez OAuth 2.0 Overview.