- Recurso: InventorySource
- InventorySourceType
- InventorySourceProductType
- InventorySourceCommitment
- InventorySourceDeliveryMethod
- InventorySourceStatus
- InventorySourceConfigStatus
- RateDetails
- InventorySourceRateType
- Dinero
- TimeRange
- CreativeConfig
- InventorySourceDisplayCreativeConfig
- InventorySourceVideoCreativeConfig
- InventorySourceAccessors
- PartnerAccessor
- AdvertiserAccessors
- Métodos
Recurso: InventorySource
Una fuente de inventario
Representación JSON |
---|
{ "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum ( |
Campos | |
---|---|
name |
Solo salida. Es el nombre del recurso de la fuente de inventario. |
inventorySourceId |
Solo salida. Es el ID único de la fuente de inventario. Lo asigna el sistema. |
displayName |
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 |
Indica el tipo de la fuente de inventario. |
inventorySourceProductType |
Solo salida. Es el tipo de producto de la fuente de inventario, que indica la forma en que vende el inventario. |
commitment |
Indica si la fuente de inventario tiene una publicación garantizada o no garantizada. |
deliveryMethod |
Es el método de publicación de la fuente de inventario.
|
dealId |
Es el ID en el espacio de intercambio que identifica de forma exclusiva la fuente de inventario. Debe ser único entre los compradores de cada intercambio, pero no necesariamente debe ser único entre ellos. |
status |
Es la configuración de estado de la fuente de inventario. |
exchange |
Es el intercambio al que pertenece la fuente de inventario. |
updateTime |
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: |
rateDetails |
Obligatorio. Los detalles de tarifas de la fuente de inventario. |
publisherName |
Es el nombre del publicador o vendedor de la fuente de inventario. |
timeRange |
Es el período en el que esta fuente de inventario comienza y deja de publicar anuncios. |
creativeConfigs[] |
Los requisitos de las creatividades de la fuente de inventario No se aplica a los paquetes de subasta. |
guaranteedOrderId |
Inmutable. Es el ID del pedido garantizado al que pertenece esta fuente de inventario. Solo se aplica cuando |
readWriteAccessors |
El socio o los anunciantes que tienen acceso de lectura o escritura a la fuente de inventario El resultado solo se produce cuando Obligatorio cuando Si |
readAdvertiserIds[] |
Solo salida. Son los ID de los anunciantes con acceso de solo lectura a la fuente de inventario. |
readPartnerIds[] |
Solo salida. Son los ID 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. |
InventorySourceType
Posibles tipos de fuentes de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_TYPE_UNSPECIFIED |
El tipo de fuente de inventario no se especificó o se desconoce en esta versión. |
INVENTORY_SOURCE_TYPE_PRIVATE |
Fuente de inventario privado. |
INVENTORY_SOURCE_TYPE_AUCTION_PACKAGE |
Paquete de subasta. |
InventorySourceProductType
Posibles tipos de productos de una fuente de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
No se especificó el tipo de producto o se desconoce en esta versión. La API no admite la modificación de fuentes de inventario de este tipo de producto. |
PREFERRED_DEAL |
La fuente de inventario vende inventario mediante Acuerdo preferido. |
PRIVATE_AUCTION |
La fuente de inventario vende inventario a través de una subasta privada. |
PROGRAMMATIC_GUARANTEED |
La fuente de inventario vende inventario a través de Programática garantizada. |
TAG_GUARANTEED |
La fuente de inventario vende inventario a través de la etiqueta garantizada. |
YOUTUBE_RESERVE |
La fuente de inventario vende inventario a través de YouTube Reserve. |
INSTANT_RESERVE |
La fuente de inventario vende inventario a través de Reserva instantánea. La API no admite la modificación de fuentes de inventario de este tipo de producto. |
GUARANTEED_PACKAGE |
La fuente de inventario vende inventario mediante un paquete garantizado. La API no admite la modificación de fuentes de inventario de este tipo de producto. |
PROGRAMMATIC_TV |
La fuente de inventario vende inventario mediante Programmtic TV. La API no admite la modificación de fuentes de inventario de este tipo de producto. |
AUCTION_PACKAGE |
La fuente de inventario vende inventario a través del paquete de subasta. La API no admite la modificación de fuentes de inventario de este tipo de producto. |
InventorySourceCommitment
Tipos de compromisos posibles para una fuente de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_COMMITMENT_UNSPECIFIED |
El compromiso no se especificó o se desconoce en esta versión. |
INVENTORY_SOURCE_COMMITMENT_GUARANTEED |
El compromiso es la entrega garantizada. |
INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED |
El compromiso es una entrega no garantizada. |
InventorySourceDeliveryMethod
Posibles métodos de publicación para una fuente de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
El método de entrega no se especificó o se desconoce en esta versión. |
INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC |
El método de publicación es programático. |
INVENTORY_SOURCE_DELIVERY_METHOD_TAG |
El método de envío es una etiqueta. |
InventorySourceStatus
Es la configuración relacionada con el estado de la fuente de inventario.
Representación JSON |
---|
{ "entityStatus": enum ( |
Campos | |
---|---|
entityStatus |
Indica si la fuente de inventario se puede publicar o no. Los valores aceptables son |
entityPauseReason |
Es el motivo proporcionado por el usuario para detener esta fuente de inventario. No debe superar los 100 caracteres. Solo se aplica cuando |
sellerStatus |
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 |
sellerPauseReason |
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 |
configStatus |
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 Se debe configurar una fuente de inventario (completa los campos obligatorios, elige las creatividades y selecciona una campaña predeterminada) para que se pueda publicar. |
InventorySourceConfigStatus
Son posibles estados de configuración para una fuente de inventario garantizada.
Enumeradores | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
No se especificó el estado de aprobación o se desconoce en esta versión. |
INVENTORY_SOURCE_CONFIG_STATUS_PENDING |
Es el estado inicial de una fuente de inventario garantizada. Se debe configurar la fuente de inventario en este estado. |
INVENTORY_SOURCE_CONFIG_STATUS_COMPLETED |
Es el estado después de que el comprador configura una fuente de inventario garantizada. |
RateDetails
Es la configuración relacionada con las tarifas de la fuente de inventario.
Representación JSON |
---|
{ "inventorySourceRateType": enum ( |
Campos | |
---|---|
inventorySourceRateType |
Es el tipo de tarifa. Los valores aceptables son |
rate |
Es la tarifa de la fuente de inventario. |
unitsPurchased |
Obligatorio para las fuentes de inventario garantizadas. Corresponde a la cantidad de impresiones garantizadas por el vendedor. |
minimumSpend |
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. |
InventorySourceRateType
Tipos de tarifas posibles para una fuente de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_RATE_TYPE_UNSPECIFIED |
No se especificó el tipo de tarifa o se desconoce en esta versión. |
INVENTORY_SOURCE_RATE_TYPE_CPM_FIXED |
El tipo de tarifa es CPM (Fija). |
INVENTORY_SOURCE_RATE_TYPE_CPM_FLOOR |
El tipo de tarifa es CPM (precio mínimo). |
INVENTORY_SOURCE_RATE_TYPE_CPD |
El tipo de tarifa es Costo por día. |
INVENTORY_SOURCE_RATE_TYPE_FLAT |
El tipo de tarifa es plana. |
Dinero
Representa un importe de dinero con su tipo de moneda.
Representación JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Campos | |
---|---|
currencyCode |
El código de moneda de tres letras definido en ISO 4217. |
units |
La unidad entera del importe. Por ejemplo, si |
nanos |
Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si |
TimeRange
Un intervalo de tiempo.
Representación JSON |
---|
{ "startTime": string, "endTime": string } |
Campos | |
---|---|
startTime |
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: |
endTime |
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: |
CreativeConfig
Configuración de requisitos de creatividades para la fuente de inventario.
Representación JSON |
---|
{ "creativeType": enum ( |
Campos | |
---|---|
creativeType |
Es el tipo de creatividad que se puede asignar a la fuente de inventario. Solo se admiten los siguientes tipos:
|
Campo de unión
Es la configuración de las creatividades que se pueden asignar a la fuente de inventario. |
|
displayCreativeConfig |
Es la configuración de las creatividades de anuncios gráficos. Se aplica cuando |
videoCreativeConfig |
Es la configuración de las creatividades de video. Se aplica cuando |
InventorySourceDisplayCreativeConfig
Es la configuración de las creatividades de anuncios gráficos.
Representación JSON |
---|
{
"creativeSize": {
object ( |
Campos | |
---|---|
creativeSize |
Son los requisitos de tamaño para las creatividades de anuncios gráficos que se pueden asignar a la fuente de inventario. |
InventorySourceVideoCreativeConfig
Es la configuración de las creatividades de video.
Representación JSON |
---|
{ "duration": string } |
Campos | |
---|---|
duration |
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 terminen en " |
InventorySourceAccessors
Es el socio o los anunciantes con acceso a la fuente de inventario.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión accessors . Es el socio o los anunciantes con acceso a la fuente de inventario. Las direcciones (accessors ) solo pueden ser una de las siguientes opciones: |
|
partner |
El socio con acceso a la fuente de inventario. |
advertisers |
Son los anunciantes con acceso a la fuente de inventario. Todos los anunciantes deben pertenecer al mismo socio. |
PartnerAccessor
El socio con acceso a la fuente de inventario.
Representación JSON |
---|
{ "partnerId": string } |
Campos | |
---|---|
partnerId |
Es el ID del socio. |
AdvertiserAccessors
Son los anunciantes con acceso a la fuente de inventario.
Representación JSON |
---|
{ "advertiserIds": [ string ] } |
Campos | |
---|---|
advertiserIds[] |
Son los ID de los anunciantes. |
Métodos |
|
---|---|
|
Crea una nueva fuente de inventario. |
|
Edita los descriptores de acceso de lectura y escritura de una fuente de inventario. |
|
Obtiene una fuente de inventario. |
|
Muestra una lista de las fuentes de inventario a las que puede acceder el usuario actual. |
|
Actualiza una fuente de inventario existente. |