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 pour le 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 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)

Uniquement en sortie. Date à laquelle ce produit devient inactif.

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

object (InventorySourceVolumeForecast)

La place de marché a fourni une prévision quotidienne du volume. Permet de déterminer le rythme et d'offrir un choix aux acheteurs. Ce champ a été abandonné.
audienceMatchRate

number

Uniquement en sortie. Taux de correspondance d'audience prévu pour les accords programmatiques garantis avec ciblage par type d'audience, utilisé par la place de marché pour déterminer le nombre de requêtes 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. 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 requêtes correspondent au ciblage d'audience, et que le nombre de requêtes 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 de 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 (également la valeur par défaut) indique qu'aucune exclusion n'est appliquée et que, par conséquent, tout le trafic peut être soumis à un plafond de fréquence. La valeur 100 indique une exclusion complète et, par conséquent, aucun plafond de fréquence ne sera appliqué. Les valeurs comprises entre 0 et 100 entraînent une exclusion partielle. Par exemple, si vous saisissez 20, 20% du trafic sera exclu de la limite de la fréquence d'exposition.
dv360WseatId[]

string (int64 format)

Uniquement en sortie. Les wseats actuellement autorisés à accéder à 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 DV3 modifient la date et l'heure de la dernière modification.

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

object (CreativeApprovalConfig)

Facultatif. Configuration de l'approbation des créations. L'approbation peut être requise au niveau de la place de marché 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 État de l'acheteur : actif. Élément de campagne attribué, création valide attribuée.
BUYER_STATUS_PENDING État de l'acheteur 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 : l'état de la négociation est inconnu. Valeur saisie non valide.
SELLER_STATUS_ACTIVE État du vendeur : actif. La source d'inventaire est active du côté de la place de marché.
SELLER_STATUS_PAUSED État du vendeur "Mis en veille".

InventorySourceVolumeForecast

Prévision du volume de requêtes quotidien 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 doit être positif ; - le paramètre 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 le volume de requêtes s'applique.
volume

string (int64 format)

Volume de requêtes prévu pour un jour donné de la semaine.

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 de 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 doit être approuvée avant l'ingestion au niveau de l'éditeur.

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

string

Obligatoire. Référence de l'éditeur.
publisherDisplayName

string

Obligatoire. Nom de l'éditeur.

Méthodes

get

 Récupère une source d'inventaire.

list

 Répertorie les sources d'inventaire.

patch

 Met à jour une source d'inventaire.