REST Resource: videoAdvertisingOptions

Recurso: VideoAdvertisingOption

La configuración de publicidad de un video. La configuración identifica los tipos de anuncios que se pueden publicar en el video y los tiempos en que está permitida la reproducción de anuncios durante el video.

Representación JSON
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Campos
kind

string

Tipo de recurso de la API. Para este recurso, el valor es youtubePartner#videoAdvertisingOption.

adFormats[]

string

Una lista de los formatos de anuncios que el video puede mostrar. Nota: A partir de noviembre de 2023, solo se pueden habilitar o inhabilitar third_party_ads en esta columna. Consulta el artículo de asistencia para obtener más información. Los siguientes controles de formato del anuncio ya no están disponibles y no deberían incluirse en la solicitud a la API: instream_standard, display, preroll, postroll.

breakPosition[]

string

Punto en el que se produce la pausa durante la reproducción del video.

adBreaks[]

object (AdBreak)

Es una lista de los momentos en los que YouTube puede mostrar un anuncio in-stream durante la reproducción del video.

autoGeneratedBreaks

boolean

Habilita este video para las pausas de anuncios durante el video generadas automáticamente.

id

string

ID que YouTube utiliza para identificar de forma exclusiva el video asociado con la configuración de publicidad.

tpAdServerVideoId

string

Es un valor que permite que el servidor de anuncios de terceros identifique el video de manera única.

tpTargetingUrl

string

La URL base de un servidor de anuncios de terceros desde el cual YouTube puede recuperar los anuncios in-stream para el video.

tpUrlParameters

string

Una cadena de parámetro que se agrega al final de la solicitud al servidor de publicidad de terceros.

AdBreak

Un recurso adBreak contiene información sobre un momento en el que YouTube puede mostrar un anuncio in-stream durante la reproducción de un video.

Representación JSON
{
  "position": string,
  "midrollSeconds": integer
}
Campos
position

string

Punto en el que se produce la pausa durante la reproducción del video.

midrollSeconds

integer

Es el tiempo de la pausa publicitaria especificado como la cantidad de segundos después del inicio del video en los que se produce la pausa.

Métodos

get

Recupera la configuración de publicidad del video especificado.

getEnabledAds

Recupera los detalles sobre los tipos de anuncios permitidos para un socio o un video subido por un usuario especificado.

patch

Aplica parches en la configuración de publicidad del video especificado.

update

Actualiza la configuración de publicidad del video especificado.