- Ressource: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- Valeur monétaire
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- Méthodes
Ressource: InventorySource
Une source d'inventaire
Représentation JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
Champs | |
---|---|
name |
Uniquement en sortie. Nom de ressource de la source d'inventaire. |
inventorySourceId |
Uniquement en sortie. Identifiant unique de la source d'inventaire. Attribué par le système. |
displayName |
Nom à afficher de la source d'inventaire. Il doit être encodé au format UTF-8 et ne doit pas dépasser 240 octets. |
inventorySourceType |
Indique le type de source d'inventaire. |
inventorySourceProductType |
Uniquement en sortie. Type de produit de la source d'inventaire, indiquant la façon dont l'inventaire est vendu. |
commitment |
Indique si la diffusion de la source d'inventaire est garantie ou non. |
deliveryMethod |
Mode de diffusion de la source d'inventaire.
|
dealId |
ID qui identifie de manière unique la source d'inventaire dans l'espace de la place de marché. Il doit être unique pour les acheteurs au sein de chaque place de marché, mais pas nécessairement entre les différentes places de marché. |
status |
Paramètres d'état de la source d'inventaire. |
exchange |
Place de marché à laquelle appartient la source d'inventaire. |
updateTime |
Uniquement en sortie. Horodatage de la dernière mise à jour de la source d'inventaire. Attribué par le système. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
rateDetails |
Obligatoire. Détails du tarif de la source d'inventaire. |
publisherName |
Nom de l'éditeur/du vendeur de la source d'inventaire. |
timeRange |
Période au cours de laquelle cette source d'inventaire commence et s'arrête de diffuser des annonces. |
creativeConfigs[] |
Exigences liées aux créations de la source d'inventaire. Non applicable aux packages d'enchères. |
guaranteedOrderId |
Immuable. ID de la campagne garantie à laquelle appartient cette source d'inventaire. Ne s'applique que lorsque |
readWriteAccessors |
Partenaire ou annonceurs disposant d'un accès en lecture/écriture à la source d'inventaire. Résultat uniquement lorsque Obligatoire lorsque Si |
readAdvertiserIds[] |
Uniquement en sortie. Identifiants des annonceurs disposant d'un accès en lecture seule à la source d'inventaire. |
readPartnerIds[] |
Uniquement en sortie. ID des partenaires disposant d'un accès en lecture seule à la source d'inventaire. Tous les annonceurs ou partenaires indiqués dans ce champ héritent d'un accès en lecture seule à la source d'inventaire. |
InventorySourceType
Types de sources d'inventaire possibles.
Enums | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
Le type de source d'inventaire n'est pas spécifié ou est inconnu dans cette version. |
INVENTORY_SOURCE_TYPE_PRIVATE |
Source d'inventaire privée. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
Package d'enchères. |
InventorySourceProductType
Types de produits possibles d'une source d'inventaire.
Enums | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
Le type de produit n'est pas spécifié ou est inconnu dans cette version. Vous ne pouvez pas modifier les sources d'inventaire de ce type de produit via l'API. |
PREFERRED_DEAL |
La source d'inventaire vend l'inventaire par le biais d'un accord préféré. |
PRIVATE_AUCTION |
La source d'inventaire vend l'inventaire via des enchères privées. |
PROGRAMMATIC_GUARANTEED |
La source d'inventaire vend l'inventaire via le programmatique garanti. |
TAG_GUARANTEED |
La source d'inventaire vend l'inventaire via des accords de tags garantis. |
YOUTUBE_RESERVE |
La source d'inventaire vend l'inventaire via YouTube Reserve. |
INSTANT_RESERVE |
La source d'inventaire vend l'inventaire via la Réservation instantanée. Vous ne pouvez pas modifier les sources d'inventaire de ce type de produit via l'API. |
GUARANTEED_PACKAGE |
La source d'inventaire vend l'inventaire via le package garanti. Vous ne pouvez pas modifier les sources d'inventaire de ce type de produit via l'API. |
PROGRAMMATIC_TV |
La source d'inventaire vend l'inventaire via la TV programmatique. Vous ne pouvez pas modifier les sources d'inventaire de ce type de produit via l'API. |
AUCTION_PACKAGE |
La source d'inventaire vend l'inventaire via le package d'enchères. Vous ne pouvez pas modifier les sources d'inventaire de ce type de produit via l'API. |
InventorySourceCommitment
Types d'engagements possibles pour une source d'inventaire.
Enums | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
L'engagement n'est pas spécifié ou est inconnu dans cette version. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
L'engagement est une diffusion garantie. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
L'engagement est une diffusion non garantie. |
InventorySourceDeliveryMethod
Modes de diffusion possibles pour une source d'inventaire.
Enums | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
Le mode de diffusion n'est pas spécifié ou est inconnu dans cette version. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
Le mode de diffusion est programmatique. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
Le mode de diffusion est "Tag". |
InventorySourceStatus
Paramètres liés à l'état de la source d'inventaire.
Représentation JSON |
---|
{ "entityStatus": enum ( |
Champs | |
---|---|
entityStatus |
Indique si la source d'inventaire peut être diffusée. Les valeurs acceptées sont |
entityPauseReason |
Motif fourni par l'utilisateur pour la mise en veille de cette source d'inventaire. Ne doit pas dépasser 100 caractères. Ne s'applique que lorsque |
sellerStatus |
Uniquement en sortie. État défini par le vendeur pour la source d'inventaire. Ne s'applique qu'aux sources d'inventaire synchronisées directement à partir des éditeurs. Les valeurs acceptables sont |
sellerPauseReason |
Uniquement en sortie. Motif fourni par le vendeur pour la mise en veille de cette source d'inventaire. Ne s'applique qu'aux sources d'inventaire synchronisées directement à partir des éditeurs et lorsque |
configStatus |
Uniquement en sortie. État de la configuration de la source d'inventaire. Ne s'applique qu'aux sources d'inventaire garantis. Les valeurs acceptables sont Vous devez configurer une source d'inventaire (renseignez les champs obligatoires, choisissez des créations et sélectionnez une campagne par défaut) avant de pouvoir la diffuser. |
InventorySourceConfigStatus
États de configuration possibles pour une source d'inventaire garanti.
Enums | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
L'état d'approbation n'est pas spécifié ou est inconnu dans cette version. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
État de départ d'une source d'inventaire garanti. La source d'inventaire dans cet état doit être configurée. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
État une fois que l'acheteur a configuré une source d'inventaire garanti. |
RateDetails
Paramètres de tarif de la source d'inventaire.
Représentation JSON |
---|
{ "inventorySourceRateType": enum ( |
Champs | |
---|---|
inventorySourceRateType |
Type de tarif. Les valeurs acceptées sont |
rate |
Tarif de la source d'inventaire. |
unitsPurchased |
Obligatoire pour les sources d'inventaire garanti. Nombre d'impressions garanties par le vendeur. |
minimumSpend |
Uniquement en sortie. Montant que l'acheteur s'est engagé à dépenser pour la source d'inventaire à l'avance. Ne s'applique qu'aux sources d'inventaire garantis. |
InventorySourceRateType
Types de tarifs possibles pour une source d'inventaire.
Enums | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
Le type de tarif n'est pas spécifié ou est inconnu dans cette version. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
Le type de tarif est CPM (fixe). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
Le type de tarif est CPM (plancher). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
Le type de tarif est Coût par jour. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
Le type de tarif est Tarif forfaitaire. |
Argent
Représente un montant associé à un type de devise.
Représentation JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Champs | |
---|---|
currencyCode |
Code de devise à trois lettres défini par la norme ISO 4217. |
units |
Unités entières du montant. Par exemple, si |
nanos |
Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si |
TimeRange
Une période.
Représentation JSON |
---|
{ "startTime": string, "endTime": string } |
Champs | |
---|---|
startTime |
Obligatoire. Limite inférieure d'une période (incluse). Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
endTime |
Obligatoire. Limite supérieure d'une période (incluse). Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: |
CreativeConfig
Configuration des exigences liées aux créations pour la source d'inventaire.
Représentation JSON |
---|
{ "creativeType": enum ( |
Champs | |
---|---|
creativeType |
Type de création pouvant être attribué à la source d'inventaire. Seuls les types suivants sont acceptés:
|
Champ d'union
Configuration des créations pouvant être attribuées à la source d'inventaire. |
|
displayCreativeConfig |
Configuration des créations display. Applicable lorsque |
videoCreativeConfig |
Configuration des créations vidéo. Applicable lorsque |
InventorySourceDisplayCreativeConfig
Configuration des créations display.
Représentation JSON |
---|
{
"creativeSize": {
object ( |
Champs | |
---|---|
creativeSize |
Exigences de taille pour les créations display pouvant être attribuées à la source d'inventaire. |
InventorySourceVideoCreativeConfig
Configuration des créations vidéo.
Représentation JSON |
---|
{ "duration": string } |
Champs | |
---|---|
duration |
Exigences concernant la durée des créations vidéo pouvant être attribuées à la source d'inventaire. Durée en secondes avec un maximum de neuf chiffres après la virgule, se terminant par " |
InventorySourceAccessors
Partenaire ou annonceurs ayant accès à la source d'inventaire.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union accessors . Partenaire ou annonceurs ayant accès à la source d'inventaire. accessors ne peut être qu'un des éléments suivants : |
|
partner |
Partenaire ayant accès à la source d'inventaire. |
advertisers |
Annonceurs ayant accès à la source d'inventaire. Tous les annonceurs doivent appartenir au même partenaire. |
PartnerAccessor
Partenaire ayant accès à la source d'inventaire.
Représentation JSON |
---|
{ "partnerId": string } |
Champs | |
---|---|
partnerId |
Identifiant du partenaire. |
AdvertiserAccessors
Annonceurs ayant accès à la source d'inventaire.
Représentation JSON |
---|
{ "advertiserIds": [ string ] } |
Champs | |
---|---|
advertiserIds[] |
Identifiants des annonceurs |
Méthodes |
|
---|---|
|
crée une source d'inventaire ; |
|
Modifie les accesseurs en lecture/écriture d'une source d'inventaire. |
|
Récupère une source d'inventaire. |
|
Répertorie les sources d'inventaire auxquelles l'utilisateur actuel peut accéder. |
|
Met à jour une source d'inventaire. |