- 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 |
Denota 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 se 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 única la fuente de inventario. Debe ser único para todos los compradores de cada intercambio, pero no necesariamente para todos los intercambios. |
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 intervalo de tiempo en el que esta fuente de inventario inicia 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 |
Los socios o anunciantes que tienen acceso de lectura/escritura a la fuente de inventario Se genera solo cuando Obligatorio cuando Si |
readAdvertiserIds[] |
Solo salida. Son los IDs de los anunciantes con acceso de solo lectura a la fuente de inventario. |
readPartnerIds[] |
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. |
InventorySourceType
Tipos de fuentes de inventario posibles.
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
Son los posibles tipos de productos de una fuente de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_PRODUCT_TYPE_UNSPECIFIED |
En esta versión, no se especificó el tipo de producto o se desconoce. 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 mediante subasta privada. |
PROGRAMMATIC_GUARANTEED |
La fuente de inventario vende inventario mediante Programática garantizada. |
TAG_GUARANTEED |
La fuente de inventario vende el inventario mediante la etiqueta garantizada. |
YOUTUBE_RESERVE |
La fuente de inventario vende inventario mediante YouTube Reserve. |
INSTANT_RESERVE |
La fuente de inventario vende inventario mediante 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 el 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 mediante un paquete de subasta. La API no admite la modificación de fuentes de inventario de este tipo de producto. |
InventorySourceCommitment
Tipos de compromiso 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
Métodos de publicación posibles para una fuente de inventario.
Enumeradores | |
---|---|
INVENTORY_SOURCE_DELIVERY_METHOD_UNSPECIFIED |
El método de publicación 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 publicación es el etiquetado. |
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) antes de que se pueda publicar. |
InventorySourceConfigStatus
Son los posibles estados de configuración para una fuente de inventario garantizada.
Enumeradores | |
---|---|
INVENTORY_SOURCE_CONFIG_STATUS_UNSPECIFIED |
El estado de aprobación no se especificó 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 que ocurre 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 |
Indica 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. Indica 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 |
El tipo de tarifa no se especificó 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 (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 |
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 creatividades de anuncios gráficos que se pueden asignar a la fuente de inventario. |
InventorySourceVideoCreativeConfig
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. Es una duración en segundos con hasta nueve dígitos decimales que termina en " |
InventorySourceAccessors
El socio o los anunciantes con acceso a la fuente de inventario
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión accessors . El socio o los anunciantes con acceso a la fuente de inventario Las direcciones (accessors ) solo pueden ser una de las siguientes opciones: |
|
partner |
Es el socio con acceso a la fuente de inventario. |
advertisers |
Indica los anunciantes que tienen acceso a la fuente de inventario. Todos los anunciantes deben pertenecer al mismo socio. |
PartnerAccessor
Es el socio con acceso a la fuente de inventario.
Representación JSON |
---|
{ "partnerId": string } |
Campos | |
---|---|
partnerId |
El ID del socio. |
AdvertiserAccessors
Indica los anunciantes que tienen acceso a la fuente de inventario.
Representación JSON |
---|
{ "advertiserIds": [ string ] } |
Campos | |
---|---|
advertiserIds[] |
Son los ID de los anunciantes. |
Métodos |
|
---|---|
|
Crea una fuente de inventario nueva. |
|
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. |