REST Resource: partners.inventorySources

Ressource : InventorySource

Une source d'inventaire.

Représentation JSON
{
  "name": string,
  "inventorySourceId": string,
  "displayName": string,
  "inventorySourceType": enum (InventorySourceType),
  "inventorySourceProductType": enum (InventorySourceProductType),
  "commitment": enum (InventorySourceCommitment),
  "deliveryMethod": enum (InventorySourceDeliveryMethod),
  "dealId": string,
  "status": {
    object (InventorySourceStatus)
  },
  "exchange": enum (Exchange),
  "updateTime": string,
  "rateDetails": {
    object (RateDetails)
  },
  "publisherName": string,
  "timeRange": {
    object (TimeRange)
  },
  "creativeConfigs": [
    {
      object (CreativeConfig)
    }
  ],
  "guaranteedOrderId": string,
  "readWriteAccessors": {
    object (InventorySourceAccessors)
  },
  "readAdvertiserIds": [
    string
  ],
  "readPartnerIds": [
    string
  ]
}
Champs
name

string

Uniquement en sortie. Nom de ressource de la source d'inventaire.

inventorySourceId

string (int64 format)

Uniquement en sortie. Identifiant unique de la source d'inventaire. Attribué par le système.

displayName

string

Nom à afficher de la source d'inventaire.

Doit être encodé en UTF-8 avec une taille maximale de 240 octets.

inventorySourceType

enum (InventorySourceType)

Indique le type de la source d'inventaire.

inventorySourceProductType

enum (InventorySourceProductType)

Uniquement en sortie. Type de produit de la source d'inventaire, indiquant la manière dont elle vend l'inventaire.

commitment

enum (InventorySourceCommitment)

Indique si la source d'inventaire est garantie ou non garantie.

deliveryMethod

enum (InventorySourceDeliveryMethod)

Mode de diffusion de la source d'inventaire.

  • Pour les sources d'inventaire non garanti, la seule valeur acceptable est INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Pour les sources d'inventaire garanti, les valeurs acceptées sont INVENTORY_SOURCE_DELIVERY_METHOD_TAG et INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

ID de l'espace de la place de marché qui identifie de manière unique la source d'inventaire.

Il doit être unique pour chaque acheteur au sein de chaque place de marché, mais pas nécessairement d'une place de marché à l'autre.

status

object (InventorySourceStatus)

Paramètres d'état de la source d'inventaire.

exchange

enum (Exchange)

La place de marché à laquelle appartient la source d'inventaire.

updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la dernière mise à jour de la source d'inventaire. Attribué par le système.

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

rateDetails

object (RateDetails)

Obligatoire. Détails du tarif de la source d'inventaire.

publisherName

string

Nom de l'éditeur/du vendeur de la source d'inventaire.

timeRange

object (TimeRange)

Période pendant laquelle cette source d'inventaire commence et arrête de diffuser des annonces.

creativeConfigs[]

object (CreativeConfig)

Exigences de la source d'inventaire concernant les créations.

Non applicable aux packages d'enchères.

guaranteedOrderId

string

Immuable. ID de l'ordre garanti auquel appartient cette source d'inventaire.

Ne s'applique que lorsque commitment est défini sur INVENTORY_SOURCE_COMMITMENT_GUARANTEED.

readWriteAccessors

object (InventorySourceAccessors)

Partenaire ou annonceurs disposant d'un accès en lecture/écriture à la source d'inventaire.

Sortie uniquement lorsque commitment est défini sur INVENTORY_SOURCE_COMMITMENT_GUARANTEED, auquel cas les accesseurs en lecture/écriture sont hérités de l'ordre garanti parent.

Obligatoire lorsque commitment est défini sur INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Si commitment est défini sur INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED et qu'un partenaire est défini dans ce champ, tous les annonceurs de ce partenaire auront automatiquement un accès en lecture seule à la source d'inventaire. Ces annonceurs ne seront pas inclus dans readAdvertiserIds.

readAdvertiserIds[]

string (int64 format)

Uniquement en sortie. ID des annonceurs disposant d'un accès en lecture seule à la source d'inventaire.

readPartnerIds[]

string (int64 format)

Uniquement en sortie. ID des partenaires disposant d'un accès en lecture seule à la source d'inventaire.

Tous les annonceurs des partenaires de ce champ héritent d'un accès en lecture seule à la source d'inventaire.

Méthodes

get

Récupère un accord de source d'inventaire.

list

Répertorie les accords de source d'inventaire.