REST Resource: exchanges.inventorySources

Ressource : InventorySource

Modèle d'exécution d'une source d'inventaire DV360.

Représentation JSON 
{
  "name": string,
  "buyerStatus": enum (BuyerStatus),
  "sellerStatus": enum (SellerStatus),
  "transactionType": enum (TransactionType),
  "pricingType": enum (PricingType),
  "rateDetails": {
    object (RateDetails)
  },
  "startTime": string,
  "endTime": string,
  "exchangeVolumeForecast": {
    object (InventorySourceVolumeForecast)
  },
  "audienceMatchRate": number,
  "makegoodRequested": boolean,
  "makegoodRequestedReason": string,
  "percentFrequencyCapExcludedTraffic": string,
  "dv360WseatId": [
    string
  ],
  "lastModifiedTime": string,
  "creativeApprovalConfig": {
    object (CreativeApprovalConfig)
  }
}
Champs
name

string

Uniquement en sortie. Nom de ressource relatif pour la commande. Généré par le serveur. Exemple : "exchanges/1234/inventorySources/5678".
buyerStatus

enum (BuyerStatus)

Uniquement en sortie. État de l'acheteur.
sellerStatus

enum (SellerStatus)

État du vendeur.
transactionType

enum (TransactionType)

Uniquement en sortie. Type de transaction du produit.
pricingType

enum (PricingType)

Uniquement en sortie. Type de tarification du produit.
rateDetails

object (RateDetails)

Uniquement en sortie. Détails du tarif.
startTime

string (Timestamp format)

Uniquement en sortie. 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.

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)

Uniquement en sortie. 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".
exchangeVolumeForecast
(deprecated)

object (InventorySourceVolumeForecast)

Prévisions de volume quotidien fournies par la place de marché. Permet de déterminer le rythme et d'activer le choix de l'acheteur. Ce champ a été abandonné.
audienceMatchRate

number

Uniquement en sortie. Taux de correspondance d'audience prévu pour les accords programmatiques garantis avec ciblage d'audience, utilisé par la place de marché pour déterminer le nombre de demandes supplémentaires à envoyer. Il s'agit d'un nombre décimal compris entre 0 et 1, dont l'inverse doit être utilisé comme multiplicateur pour les impressions. La valeur 0 indique que le champ n'est pas défini et qu'il n'y a donc pas de ciblage d'audience. Exemple : "0.125". Cela signifie que 12, 5% des demandes correspondent au ciblage d'audience et que le nombre de demandes envoyées doit être huit fois supérieur au nombre d'impressions négociées.
makegoodRequested

boolean

Uniquement en sortie. Indique si une rediffusion de compensation a été demandée à l'acheteur.
makegoodRequestedReason

string

Uniquement en sortie. Motif de la demande de rediffusion de compensation fourni par l'acheteur.
percentFrequencyCapExcludedTraffic

string (int64 format)

Pourcentage du trafic exclu de la limite de la fréquence d'exposition pour un accord de programmatique garanti. Il s'agit d'un nombre entier compris entre 0 et 100. La valeur 0 (qui est également la valeur par défaut) indique qu'aucune exclusion n'est appliquée et que tout le trafic est donc éligible à la limitation de la fréquence. La valeur 100 indique une exclusion complète et qu'aucune limitation de la fréquence ne sera donc appliquée. Les valeurs comprises entre 0 et 100 entraîneront une exclusion partielle. Par exemple, une valeur de 20 signifie que 20% du trafic sera exclu de la limite de fréquence.
dv360WseatId[]

string (int64 format)

Uniquement en sortie. Les wseats actuellement autorisés pour la source d'inventaire.
lastModifiedTime

string (Timestamp format)

Uniquement en sortie. Date de la dernière mise à jour de la source d'inventaire. Notez que certaines mises à jour internes de DV3 modifieront la date et l'heure de la dernière modification.

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

object (CreativeApprovalConfig)

Facultatif. Configuration pour l'approbation des créations. L'approbation peut être requise au niveau de la plate-forme d'échange ou de l'éditeur.

BuyerStatus

État de l'acheteur.

Enums
BUYER_STATUS_UNSPECIFIED L'état de l'acheteur n'est pas spécifié. Valeur saisie non valide.
BUYER_STATUS_ACTIVE L'état de l'acheteur est "Actif". Un élément de campagne valide est attribué.
BUYER_STATUS_PENDING L'état de l'acheteur est "En attente". Cet état signifie que l'accord n'est pas actif et que l'acheteur doit effectuer certaines actions.
BUYER_STATUS_PAUSED État de l'acheteur : "Mis en veille par l'acheteur".

SellerStatus

État du vendeur.

Enums
SELLER_STATUS_UNSPECIFIED État du vendeur non spécifié. Inattendu, il indique que l'état de la négociation est inconnu. Valeur saisie non valide.
SELLER_STATUS_ACTIVE L'état du vendeur est "Actif". La source d'inventaire est active côté échange.
SELLER_STATUS_PAUSED L'état du vendeur est "En veille".

InventorySourceVolumeForecast

Prévision du volume de demandes quotidiennes pour une source d'inventaire. Les règles de validation suivantes s'appliquent : - Une entrée doit être fournie pour chaque jour de la semaine. - Le volume ne doit pas être négatif. - Le timeZoneId est obligatoire et doit être valide.

Représentation JSON 
{
  "dailyVolumes": [
    {
      object (DailyVolume)
    }
  ],
  "timeZoneId": string
}
Champs
dailyVolumes[]

object (DailyVolume)

Prévisions des volumes quotidiens.
timeZoneId

string

Fuseau horaire de la base de données des fuseaux horaires IANA, par exemple "America/New_York", utilisé pour les volumes quotidiens.

DailyVolume

Volume de requêtes pour une source d'inventaire pour un jour donné.

Représentation JSON 
{
  "day": enum (DayOfWeek),
  "volume": string
}
Champs
day

enum (DayOfWeek)

Jour de la semaine auquel s'applique le volume de demandes.
volume

string (int64 format)

Volume de demandes prévues pour le jour de la semaine donné.

DayOfWeek

Représente un jour de la semaine.

Enums
DAY_OF_WEEK_UNSPECIFIED Le jour de la semaine n'est pas spécifié.
MONDAY Lundi
TUESDAY Mardi
WEDNESDAY Mercredi
THURSDAY Jeudi
FRIDAY Vendredi
SATURDAY Samedi
SUNDAY Dimanche

CreativeApprovalConfig

Configuration pour l'approbation des créations.

Représentation JSON 
{
  "requiresExchangeApproval": boolean,
  "publisherConfigs": [
    {
      object (PublisherConfig)
    }
  ]
}
Champs
requiresExchangeApproval

boolean

Obligatoire. Indique si la création nécessite une approbation avant l'ingestion au niveau de la place de marché.
publisherConfigs[]

object (PublisherConfig)

Facultatif. Configuration de l'éditeur.

PublisherConfig

Configuration de l'éditeur (publisher_config). Si publisher_config est défini, la création nécessite une approbation avant l'ingestion au niveau de l'éditeur.

Représentation JSON 
{
  "publisherId": string,
  "publisherDisplayName": string
}
Champs
publisherId

string

Obligatoire. Référence éditeur.
publisherDisplayName

string

Obligatoire. Nom de l'éditeur.

Méthodes

get

 Récupère une source d'inventaire.

list

 Liste les sources d'inventaire.

patch

 Met à jour une source d'inventaire.