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)
    }
  ],
  "subSitePropertyId": string,
  "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. Lo asigna 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)

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

• Para las fuentes de inventario no garantizadas, 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 forma única la fuente de inventario.

Debe ser único para todos los compradores de cada intercambio, pero no necesariamente para todos los intercambios.

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. Lo asigna el sistema.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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. Los detalles de 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 esta fuente de inventario inicia y deja de publicar anuncios.

object (CreativeConfig)

Los requisitos de las 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)

Los socios o anunciantes que tienen acceso de lectura/escritura a la fuente de inventario

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

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 ese socio tendrán automáticamente acceso de solo lectura a la fuente de inventario. 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 socios incluidos en 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 la fuente de inventario se puede publicar o no.

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 configura como ENTITY_STATUS_PAUSED.

enum (EntityStatus)

Solo salida. Es el estado que establece 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.

Se debe configurar una fuente de inventario (completa los campos obligatorios, elige las creatividades y selecciona una campaña predeterminada) antes de que se pueda publicar.

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

enum (InventorySourceRateType)

Indica 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 en la fuente de inventario por adelantado.

Solo se aplica a las fuentes de inventario garantizadas.

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

string

El código de moneda de tres letras definido en 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. Límite inferior de un intervalo de tiempo, inclusive.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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 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 de las creatividades de anuncios gráficos. Se aplica cuando creativeType es CREATIVE_TYPE_STANDARD.

object (InventorySourceVideoCreativeConfig)

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.

Es una duración en segundos con hasta nueve dígitos decimales que termina 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)

Es el socio con acceso a la fuente de inventario.

object (AdvertiserAccessors)

Indica los anunciantes que tienen 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 ID de los anunciantes.