REST Resource: inventorySources

{
  "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
  ]
}

string

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

string (int64 format)

Solo salida. Es el ID único de la fuente de inventario. El sistema lo asigna.

string

Es el nombre visible de la fuente del inventario.

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

enum (InventorySourceType)

Indica el tipo de fuente del inventario.

enum (InventorySourceProductType)

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

enum (InventorySourceCommitment)

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

enum (InventorySourceDeliveryMethod)

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

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

string

Es el ID en el espacio del mercado que identifica de forma exclusiva la fuente del inventario.

Debe ser único para todos los compradores dentro de cada mercado, pero no necesariamente para todos los mercados.

object (InventorySourceStatus)

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

enum (Exchange)

Es el intercambio al que pertenece la fuente de inventario.

string (Timestamp format)

Solo salida. La marca de tiempo de la última actualización de la fuente del inventario. Asignada por el sistema.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

object (RateDetails)

Obligatorio. Son los detalles de las tarifas de la fuente de inventario.

string

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

object (TimeRange)

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

object (CreativeConfig)

Los requisitos de las creatividades de la fuente del inventario

No se aplica a los paquetes de subasta.

string

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

Solo es aplicable cuando commitment es INVENTORY_SOURCE_COMMITMENT_GUARANTEED.

object (InventorySourceAccessors)

El socio o los anunciantes que tienen acceso de lectura y escritura a la fuente de inventario

Resultado solo cuando commitment es INVENTORY_SOURCE_COMMITMENT_GUARANTEED, en cuyo caso los descriptores de acceso de lectura/escritura se heredan del orden superior garantizado.

Obligatorio cuando commitment es INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED.

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

string (int64 format)

Solo salida. Los IDs de los anunciantes con acceso de solo lectura a la fuente de inventario

string (int64 format)

Solo salida. Son los IDs de los socios con 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 del inventario.

{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "sellerStatus": enum (EntityStatus),
  "sellerPauseReason": string,
  "configStatus": enum (InventorySourceConfigStatus)
}

enum (EntityStatus)

Indica si se puede publicar o no la fuente de inventario.

Los valores aceptables son ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED y ENTITY_STATUS_PAUSED. El valor predeterminado es ENTITY_STATUS_ACTIVE.

string

Es el motivo proporcionado por el usuario para detener esta fuente de inventario.

No debe superar los 100 caracteres.

Solo se aplica cuando entityStatus se establece como ENTITY_STATUS_PAUSED.

enum (EntityStatus)

Solo salida. Es el estado que estableció el vendedor para la fuente del inventario.

Solo se aplica a las fuentes de inventario sincronizadas directamente desde los publicadores. Los valores aceptables son ENTITY_STATUS_ACTIVE y ENTITY_STATUS_PAUSED.

string

Solo salida. Es el motivo que proporcionó el vendedor para detener esta fuente de inventario.

Solo se aplica a las fuentes de inventario sincronizadas directamente desde los publicadores y cuando sellerStatus se establece como ENTITY_STATUS_PAUSED.

enum (InventorySourceConfigStatus)

Solo salida. Es el estado de configuración de la fuente de inventario.

Solo se aplica a las fuentes de inventario garantizado. Los valores aceptables son INVENTORY_SOURCE_CONFIG_STATUS_PENDING y INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED.

Para que se pueda publicar, se debe configurar una fuente de inventario (completar los campos obligatorios, elegir las creatividades y seleccionar una campaña predeterminada).

{
  "inventorySourceRateType": enum (InventorySourceRateType),
  "rate": {
    object (Money)
  },
  "unitsPurchased": string,
  "minimumSpend": {
    object (Money)
  }
}

enum (InventorySourceRateType)

Es el tipo de tarifa.

Los valores aceptables son INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED, INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR y INVENTORY_SOURCE_RATE_TYPE_CPD.

object (Money)

Es la tarifa de la fuente del inventario.

string (int64 format)

Obligatorio para las fuentes de inventario garantizado. Es la cantidad de impresiones que garantiza el vendedor.

object (Money)

Solo salida. Es el importe que el comprador se comprometió a invertir en la fuente de inventario por adelantado.

Solo se aplica a las fuentes de inventario garantizado.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Es el código de moneda de tres letras, según ISO 4217.

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", 1 unidad es un dólar estadounidense.

integer

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si units es positivo, nanos debe ser positivo o cero. Si units es cero, nanos puede ser positivo, cero o negativo. Si units es negativo, nanos debe ser negativo o cero. Por ejemplo, –$1.75 se representa como units=-1 y nanos=-750,000,000.

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

Obligatorio. Es el límite inferior de un período, inclusive.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Obligatorio. Es el límite superior de un período, inclusive.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

{
  "creativeType": enum (CreativeType),

  // Union field creative_config_scheme can be only one of the following:
  "displayCreativeConfig": {
    object (InventorySourceDisplayCreativeConfig)
  },
  "videoCreativeConfig": {
    object (InventorySourceVideoCreativeConfig)
  }
  // End of list of possible types for union field creative_config_scheme.
}

enum (CreativeType)

Es el tipo de creatividad que se puede asignar a la fuente de inventario. Solo se admiten los siguientes tipos:

• CREATIVE_TYPE_STANDARD
• CREATIVE_TYPE_VIDEO

object (InventorySourceDisplayCreativeConfig)

Es la configuración para las creatividades de anuncios gráficos. Se aplica cuando creativeType es CREATIVE_TYPE_STANDARD.

object (InventorySourceVideoCreativeConfig)

Es la configuración de las creatividades de video. Se aplica cuando creativeType es CREATIVE_TYPE_VIDEO.

{
  "creativeSize": {
    object (Dimensions)
  }
}

object (Dimensions)

Son los requisitos de tamaño para las creatividades de display que se pueden asignar a la fuente de inventario.

{
  "duration": string
}

string (Duration format)

Son los requisitos de duración para las creatividades de video que se pueden asignar a la fuente de inventario.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

{

  // Union field accessors can be only one of the following:
  "partner": {
    object (PartnerAccessor)
  },
  "advertisers": {
    object (AdvertiserAccessors)
  }
  // End of list of possible types for union field accessors.
}

object (PartnerAccessor)

El socio con acceso a la fuente de inventario.

object (AdvertiserAccessors)

Los anunciantes con acceso a la fuente de inventario. Todos los anunciantes deben pertenecer al mismo socio.

{
  "partnerId": string
}

string (int64 format)

El ID del socio

{
  "advertiserIds": [
    string
  ]
}

string (int64 format)

Los IDs de los anunciantes