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. Asignada por el sistema.

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.

enum (InventorySourceType)

Indica el tipo de la fuente de 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 de intercambio que identifica de manera inequívoca a la fuente de inventario.

Debe ser único entre los compradores dentro de cada intercambio, pero no necesariamente entre ellos.

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. Es la marca de tiempo de la última actualización de la fuente de 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 de inventario.

object (TimeRange)

Es el intervalo de tiempo en el que se inicia y se detiene la publicación de anuncios en esta fuente de inventario.

object (CreativeConfig)

Son los requisitos de creatividades de la fuente de 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 se aplica cuando commitment es INVENTORY_SOURCE_COMMITMENT_GUARANTEED.

object (InventorySourceAccessors)

El socio o los anunciantes que tienen acceso de lectura/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 establece un socio en este campo, todos los anunciantes de ese socio tendrán acceso de solo lectura a la fuente de inventario automáticamente. Estos anunciantes no se incluirán en readAdvertiserIds.

string (int64 format)

Solo salida. Son 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 de 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 de 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 proporcionado por 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 en 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 garantizadas. 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 (completa los campos obligatorios, elige las creatividades y selecciona 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 de inventario.

string (int64 format)

Obligatorio para las fuentes de inventario garantizadas. Indica la cantidad de impresiones garantizadas por el vendedor.

object (Money)

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

Solo se aplica a las fuentes de inventario garantizadas.

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

string

Es el código de moneda de tres letras definido en la norma ISO 4217.

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", entonces 1 unidad es 1 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. El límite inferior de un intervalo de tiempo, 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. Límite superior de un intervalo de tiempo, 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 creatividades de anuncios gráficos que se pueden asignar a la fuente de inventario.

{
  "duration": string
}

string (Duration format)

Son los requisitos de duración de 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)

Son los IDs de los anunciantes.