REST Resource: partners.inventorySources

Recurso: InventorySource

Es una fuente de inventario.

Representación 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
  ]
}
Campos
name

string

Solo salida. Es el nombre del recurso de la fuente de inventario.
inventorySourceId

string (int64 format)

Solo salida. Es el ID único de la fuente de inventario. Asignado por el sistema.
displayName

string

Es el nombre visible de la fuente de inventario.

Debe estar codificado en UTF-8 con un tamaño máximo de 240 bytes.
inventorySourceType

enum (InventorySourceType)

Indica el tipo de fuente de inventario.
inventorySourceProductType

enum (InventorySourceProductType)

Solo salida. Es el tipo de producto de la fuente de inventario, que indica la forma en que se vende el inventario.
commitment

enum (InventorySourceCommitment)

Indica si la fuente de inventario tiene una publicación garantizada o no garantizada.
deliveryMethod

enum (InventorySourceDeliveryMethod)

Es el método de publicación de la fuente de inventario.

  • Para las fuentes de inventario no garantizadas, el único valor aceptable es INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
  • Para las fuentes de inventario garantizado, los valores aceptables son INVENTORY_SOURCE_DELIVERY_METHOD_TAG y INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC.
dealId

string

Es el ID en el espacio de intercambio que identifica de forma única la fuente de inventario.

Debe ser único para cada comprador dentro de cada intercambio, pero no necesariamente único en todos los intercambios.
status

object (InventorySourceStatus)

Es la configuración de estado de la fuente de inventario.
exchange

enum (Exchange)

Es el intercambio al que pertenece la fuente de inventario.
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización de la fuente de inventario. Asignado por el sistema.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
rateDetails

object (RateDetails)

Obligatorio. Son los detalles de la tarifa de la fuente de inventario.
publisherName

string

Es el nombre del publicador o vendedor de la fuente de inventario.
timeRange

object (TimeRange)

Es el período en el que esta fuente de inventario comienza y deja de publicar anuncios.
creativeConfigs[]

object (CreativeConfig)

Son los requisitos de creatividad de la fuente de inventario.

No corresponde a los paquetes de subasta.
guaranteedOrderId

string

Inmutable. Es el ID del pedido garantizado al que pertenece esta fuente de inventario.

Solo se aplica cuando commitment es INVENTORY_SOURCE_COMMITMENT_GUARANTEED.
readWriteAccessors

object (InventorySourceAccessors)

Son los socios o anunciantes que tienen acceso de lectura y escritura a la fuente de inventario.

Solo se genera un resultado cuando commitment es INVENTORY_SOURCE_COMMITMENT_GUARANTEED, en cuyo caso los descriptores de acceso de lectura y escritura se heredan del pedido garantizado superior.

Es obligatorio cuando commitment es INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

Si commitment es INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED y se establece un socio en este campo, todos los anunciantes de este socio tendrán automáticamente acceso de solo lectura a la fuente de inventario. Estos anunciantes no se incluirán en readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

Solo salida. Son los IDs de los anunciantes con acceso de solo lectura a la fuente de inventario.
readPartnerIds[]

string (int64 format)

Solo salida. Son los IDs de los socios que tienen acceso de solo lectura a la fuente de inventario.

Todos los anunciantes de los socios de este campo heredan el acceso de solo lectura a la fuente de inventario.

Métodos

get

 Obtiene un acuerdo de fuente de inventario.

list

 Enumera los acuerdos de fuentes de inventario.