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

Es 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. Para obtener más información, consulta este artículo de asistencia. Los siguientes controles de formato de anuncios ya no están disponibles y no se deben incluir en la solicitud a la API: instream_standard, display, preroll, postroll.
breakPosition[]

string

Es el punto en el que se produce la pausa durante la reproducción de video.
adBreaks[]

object (AdBreak)

Una lista de 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 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 identifica el video de manera única para el servidor de anuncios de terceros.
tpTargetingUrl

string

Es la URL base de un servidor de anuncios de terceros desde el cual YouTube puede recuperar anuncios in-stream para el video.
tpUrlParameters

string

Es una cadena de parámetro para agregar al final de la solicitud al servidor de anuncios 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

Es el punto en el que se produce la pausa durante la reproducción de video.
midrollSeconds

integer

Indica el tiempo de la pausa publicitaria especificado como la cantidad de segundos posteriores al 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.