REST Resource: videoAdvertisingOptions

Recurso: VideoAdvertisingOption

As configurações de publicidade para um vídeo. As configurações identificam os tipos de anúncios que podem ser exibidos durante o vídeo, bem como em que momentos os anúncios podem ser exibidos durante o vídeo.

Representação JSON 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Campos
kind

string

O tipo do recurso da API. Para esse recurso, o valor é youtubePartner#videoAdvertisingOption.
adFormats[]

string

Uma lista de formatos de anúncios que o vídeo pode mostrar. Observação: a partir de novembro de 2023, apenas thirdParty poderá ser ativado/desativado nesta coluna. Consulte o artigo de suporte para mais informações. Os seguintes controles de formato de anúncio não estão mais disponíveis e não devem ser incluídos na solicitação da API: instream_standard, display, preroll, postroll.
breakPosition[]

string

O ponto em que o intervalo ocorre durante a reprodução do vídeo.
adBreaks[]

object (AdBreak)

Uma lista de momentos em que o YouTube pode mostrar um anúncio in-stream durante a reprodução do vídeo.
autoGeneratedBreaks

boolean

Ativa este vídeo para intervalos de anúncios intermediários gerados automaticamente. Se a opção "autoGeneratedBreaks" estiver definida como "true" em um vídeo com intervalos de anúncios definidos, nossos sistemas vão identificar locais para mostrar anúncios, além dos espaços de anúncios inseridos manualmente.
id

string

O ID que o YouTube usa para identificar exclusivamente o vídeo associado às configurações de publicidade.
tpAdServerVideoId

string

Um valor que identifica o vídeo de forma exclusiva para o servidor de anúncios de terceiros.
tpTargetingUrl

string

O URL base de um servidor de anúncios de terceiros de onde o YouTube pode recuperar anúncios in-stream para o vídeo.
tpUrlParameters

string

Uma string de parâmetro a ser anexada ao final da solicitação ao servidor de anúncios de terceiros.

AdBreak

Um recurso adBreak contém informações sobre um momento em que o YouTube pode mostrar um anúncio in-stream durante a reprodução de vídeo.

Representação JSON 
{
  "position": string,
  "midrollSeconds": integer
}
Campos
position

string

O ponto em que o intervalo ocorre durante a reprodução do vídeo.
midrollSeconds

integer

O tempo do intervalo de anúncio especificado como o número de segundos após o início do vídeo quando o intervalo ocorre.

Métodos

get

 Recupera as configurações de publicidade para o vídeo especificado.

getEnabledAds

 Recupera detalhes sobre os tipos de anúncios permitidos para um vídeo enviado por um parceiro ou usuário especificado.

patch

 Corrige as configurações de publicidade do vídeo especificado.

update

 Atualiza as configurações de publicidade para o vídeo especificado.