Videos

Um recurso video representa um vídeo do YouTube.

Métodos

A API é compatível com os seguintes métodos para recursos videos:

getRating
Recupera as classificações que o usuário autorizado deu a uma lista de vídeos especificados. Faça um teste agora.
list
Retorna uma lista de vídeos que correspondem aos parâmetros da solicitação de API. Faça um teste agora.
batchGetStats
Recupera uma lista de estatísticas de vídeo que correspondem aos parâmetros da solicitação de API. Faça um teste agora.
inserir
Envia um vídeo para o YouTube e, se quiser, define os metadados dele.
update
Atualiza os metadados de um vídeo. Faça um teste agora.
delete
Exclui um vídeo do YouTube. Faça um teste agora.
rate
Adiciona ou remove uma marcação "Gostei" ou "Não gostei" de um vídeo. Faça um teste agora.
reportAbuse
Denunciar um vídeo por conteúdo abusivo. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind string
Identifica o tipo do recurso da API. O valor será youtube#video.
etag etag
A Etag deste recurso.
id string
O ID que o YouTube usa para identificar o vídeo de forma exclusiva.
snippet object
O objeto snippet contém detalhes básicos sobre o vídeo, como título, descrição e categoria.
snippet.publishedAt datetime
A data e a hora em que o vídeo foi publicado. Esse horário pode ser diferente daquele em que o vídeo foi enviado. Por exemplo, se um vídeo for enviado como privado e depois se tornar público, essa propriedade vai especificar o momento em que o vídeo se tornou público.

Há alguns casos especiais:
  • Se um vídeo for enviado como privado e os metadados dele forem recuperados pelo proprietário do canal, o valor da propriedade vai especificar a data e a hora em que o vídeo foi enviado.
  • Se um vídeo for enviado como não listado, o valor da propriedade também vai especificar a data e a hora em que o vídeo foi enviado. Nesse caso, qualquer pessoa que saiba o ID exclusivo do vídeo pode recuperar os metadados dele.
  • Se um vídeo for enviado como vídeo exclusivo para membros, o valor da propriedade vai especificar a data e a hora em que o vídeo foi enviado.
O valor é especificado no formato ISO 8601.
snippet.channelId string
O ID que o YouTube usa para identificar exclusivamente o canal em que o vídeo foi enviado. Esse valor pode mudar com o tempo, como quando um vídeo é reatribuído a um canal diferente (por exemplo, um canal de tema ou de artista).
snippet.title string
O título do vídeo. O valor da propriedade tem um comprimento máximo de 100 caracteres e pode conter todos os caracteres UTF-8 válidos, exceto < e >. Você precisa definir um valor para essa propriedade se chamar o método videos.update e estiver atualizando a parte snippet de um recurso video.
snippet.description string
A descrição do vídeo. O valor da propriedade tem um comprimento máximo de 5.000 bytes e pode conter todos os caracteres UTF-8 válidos, exceto < e >.

Para criar capítulos de vídeo, inclua marcações de tempo formatadas (por exemplo, 00:00) no texto da descrição.
snippet.thumbnails object
Um mapa de imagens em miniatura associadas ao vídeo. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura.
snippet.thumbnails.(key) object
Os valores de chave válidos são:
  • default: a imagem de miniatura padrão. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura.
  • medium: uma versão de maior resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura.
  • high: uma versão em alta resolução da imagem de miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
  • standard: uma versão da imagem em miniatura com resolução ainda maior do que a imagem de resolução high. Essa imagem está disponível para alguns vídeos e outros recursos que se referem a vídeos, como itens de playlist ou resultados da pesquisa. Esta imagem tem 640 px de largura e 480 px de altura.
  • maxres: uma versão em alta resolução da imagem da miniatura. Esse tamanho de imagem está disponível para alguns vídeos e outros recursos que se referem a vídeos, como itens de playlist ou resultados da pesquisa. Esta imagem tem 1.280 px de largura e 720 px de altura.
  • fhd: a versão em alta definição total (1080p) da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos. Esta imagem tem 1920 px de largura e 1080 px de altura.
  • qhd: a versão Quad HD (1440p / 2K) da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos. Esta imagem tem 2.560 px de largura e 1.440 px de altura.
  • uhd: a versão de resolução ultra-alta (4K) da imagem de miniatura. Esse tamanho de imagem está disponível para alguns vídeos. Esta imagem tem 3.840 px de largura e 2.160 px de altura.
snippet.thumbnails.(key).url string
O URL da imagem.
snippet.thumbnails.(key).width unsigned integer
A largura da imagem.
snippet.thumbnails.(key).height unsigned integer
A altura da imagem.
snippet.channelTitle string
Título do canal ao qual o vídeo pertence.
snippet.tags[] list
Uma lista de tags de palavras-chave associadas ao vídeo. As tags podem conter espaços. O valor da propriedade pode ter até 500 caracteres. Observe as seguintes regras sobre como o limite de caracteres é calculado:
  • O valor da propriedade é uma lista, e as vírgulas entre os itens contam para o limite.
  • Se uma tag tiver um espaço, o servidor de API vai processar o valor dela como se estivesse entre aspas, e as aspas vão contar para o limite de caracteres. Portanto, para fins de limites de caracteres, a tag Foo-Baz contém sete caracteres, mas a tag Foo Baz contém nove caracteres.
snippet.categoryId string
A categoria de vídeo do YouTube associada ao vídeo. Você precisa definir um valor para essa propriedade se chamar o método videos.update e estiver atualizando a parte snippet de um recurso video.
snippet.liveBroadcastContent string

Indica se o vídeo é uma transmissão ao vivo futura/ativa. O valor é none se o vídeo não for uma transmissão ao vivo futura/ativa.



Os valores válidos para essa propriedade são:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
O idioma do texto nas propriedades snippet.title e snippet.description do recurso video.
snippet.localized object
O objeto snippet.localized contém um título e uma descrição localizados para o vídeo ou o título no idioma padrão dos metadados do vídeo.
  • O texto localizado será retornado no snippet de recurso se a solicitação videos.list tiver usado o parâmetro hl para especificar um idioma para o qual o texto localizado deve ser retornado e o texto localizado estiver disponível nesse idioma.
  • Os metadados do idioma padrão são retornados se um valor de parâmetro hl não for especificado ou se um valor for especificado, mas os metadados localizados não estiverem disponíveis para o idioma especificado.
A propriedade contém um valor somente leitura. Use o objeto localizations para adicionar, atualizar ou excluir títulos localizados.
snippet.localized.title string
O título localizado do vídeo.
snippet.localized.description string
A descrição localizada do vídeo.
snippet.defaultAudioLanguage string
A propriedade default_audio_language especifica o idioma falado na faixa de áudio padrão do vídeo.
contentDetails object
O objeto contentDetails contém informações sobre o conteúdo do vídeo, incluindo a duração e uma indicação se as legendas estão disponíveis.
contentDetails.duration string
A duração do vídeo. O valor da propriedade é uma duração ISO 8601. Por exemplo, para um vídeo de pelo menos um minuto e menos de uma hora, a duração está no formato PT#M#S, em que as letras PT indicam que o valor especifica um período, e as letras M e S se referem à duração em minutos e segundos, respectivamente. Os caracteres # que precedem as letras M e S são números inteiros que especificam o número de minutos (ou segundos) do vídeo. Por exemplo, um valor de PT15M33S indica que o vídeo tem 15 minutos e 33 segundos de duração.

Se o vídeo tiver pelo menos uma hora de duração, o formato será PT#H#M#S, em que o # antes da letra H especifica a duração do vídeo em horas, e todos os outros detalhes são os mesmos descritos acima. Se o vídeo tiver pelo menos um dia de duração, as letras P e T serão separadas, e o formato do valor será P#DT#H#M#S. Consulte a especificação ISO 8601 para mais detalhes.
contentDetails.dimension string
Indica se o vídeo está disponível em 3D ou 2D.
contentDetails.definition string
Indica se o vídeo está disponível em alta definição (HD) ou apenas em definição padrão.

Os valores válidos para essa propriedade são:
  • hd
  • sd
contentDetails.caption string
Indica se as legendas estão disponíveis para o vídeo.

Os valores válidos para essa propriedade são:
  • false
  • true
contentDetails.licensedContent boolean
Indica se o vídeo representa conteúdo licenciado, ou seja, se ele foi enviado para um canal vinculado a um parceiro de conteúdo do YouTube e reivindicado por esse parceiro.
contentDetails.regionRestriction object
O objeto regionRestriction contém informações sobre os países em que um vídeo pode ou não ser assistido. O objeto vai conter a propriedade contentDetails.regionRestriction.allowed ou contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Uma lista de códigos de região que identificam os países onde o vídeo pode ser assistido. Se esta propriedade estiver presente e um país não estiver listado em seu valor, o vídeo será bloqueado para ser exibido nesse país. Se esta propriedade estiver presente e contiver uma lista vazia, o vídeo será bloqueado em todos os países.
contentDetails.regionRestriction.blocked[] list
Uma lista de códigos de região que identificam os países em que o vídeo está bloqueado. Se esta propriedade estiver presente e um país não estiver listado em seu valor, o vídeo será visível nesse país. Se esta propriedade estiver presente e contiver uma lista vazia, o vídeo será visível em todos os países.
contentDetails.contentRating object
Especifica as classificações que o vídeo recebeu em vários sistemas de classificação.
contentDetails.contentRating.acbRating string
A classificação do Australian Classification Board (ACB) ou da Australian Communications and Media Authority (ACMA) do vídeo. As classificações da ACMA são usadas para classificar a programação de TV infantil.

Os valores válidos para essa propriedade são:
  • acbC: programas que receberam uma classificação C da Australian Communications and Media Authority. Esses programas são destinados a crianças que não estejam em idade pré-escolar e que tenham menos de 14 anos.
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP: programas que receberam uma classificação P da Australian Communications and Media Authority. Esses programas são destinados a crianças em idade pré-escolar.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
A classificação do vídeo de acordo com a Autorità per le Garanzie nelle Comunicazioni (AGCOM) da Itália.

Os valores válidos para essa propriedade são:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
A classificação da Anatel (Asociación Nacional de Televisión) do vídeo para a televisão chilena.

Os valores válidos para essa propriedade são:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
A classificação do vídeo de acordo com o British Board of Film Classification (BBFC).

Os valores válidos para essa propriedade são:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
A classificação do vídeo do Conselho de Censores de Filmes e Vídeos da Tailândia.

Os valores válidos para essa propriedade são:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
A classificação do vídeo de acordo com o Conselho de Classificação de Mídia da Áustria (Bundesministerium für Unterricht, Kunst und Kultur).

Os valores válidos para essa propriedade são:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14 anos ou mais
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa: sem restrições
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Sistema de classificação para TV canadense: Canadian TV Classification System. A classificação do vídeo da Canadian Radio-Television and Telecommunications Commission (CRTC) para transmissões em inglês canadense. Para mais informações, consulte o site do Canadian Broadcast Standards Council.

Os valores válidos para essa propriedade são:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
A classificação do vídeo da Comissão de Radiodifusão e Telecomunicações Canadenses (CRTC, na sigla em inglês) para transmissões em francês canadense. Para mais informações, consulte o site do Canadian Broadcast Standards Council.

Os valores válidos para essa propriedade são:
  • catvfr13plus: maiores de 13 anos
  • catvfr16plus – 16+
  • catvfr18plus – 18 anos ou mais
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
A classificação do vídeo de acordo com o Central Board of Film Certification (CBFC - Índia).

Os valores válidos para essa propriedade são:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
A classificação do vídeo de acordo com o Consejo de Calificación Cinematográfica (Chile).

Os valores válidos para essa propriedade são:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
A classificação do vídeo pela Comissão de Classificação de Espectáculos de Portugal.

Os valores válidos para essa propriedade são:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
A classificação do vídeo na Suíça.

Os valores válidos para essa propriedade são:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
A classificação do vídeo no Canadian Home Video Rating System (CHVRS).

Os valores válidos para essa propriedade são:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
A classificação do vídeo de acordo com a Commission de Contrôle des Films (Bélgica).

Os valores válidos para essa propriedade são:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
A classificação do vídeo de acordo com o CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) da Romênia.

Os valores válidos para essa propriedade são:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp: AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Sistema de classificação na França: Commission de classification cinematographique

Os valores válidos para essa propriedade são:
  • cnc10 – 10
  • cnc12 – 12
  • cnc16 – 16
  • cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
A classificação do vídeo do Conseil supérieur de l'audiovisuel da França, que classifica o conteúdo de transmissão.

Os valores válidos para essa propriedade são:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction: interdição
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
A classificação do vídeo de acordo com a Commission de surveillance de la classification des films (CSCF) de Luxemburgo.

Os valores válidos para essa propriedade são:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
A classificação do vídeo na República Tcheca.

Os valores válidos para essa propriedade são:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
A classificação do vídeo pelo Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil).

Os valores válidos para essa propriedade são:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Motivos que explicam por que o vídeo recebeu a classificação do DJCTQ (Brasil).
contentDetails.contentRating.ecbmctRating string
Sistema de classificação na Turquia: Conselho de Avaliação e Classificação do Ministério da Cultura e do Turismo

Os valores válidos para essa propriedade são:
  • ecbmct13a – 13A
  • ecbmct13plus – 13 anos ou mais
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18 anos ou mais
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6 anos ou mais
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
A classificação do vídeo na Estônia.

Os valores válidos para essa propriedade são:
  • eefilmK12 – Ensino fundamental e médio
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – Ensino fundamental I
  • eefilmL – G
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
A classificação do vídeo no Egito.

Os valores válidos para essa propriedade são:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
A classificação do vídeo de acordo com o Eirin (映倫). Eirin é o sistema de classificação japonês.

Os valores válidos para essa propriedade são:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
A classificação do vídeo do Conselho de Censura de Filmes da Malásia.

Os valores válidos para essa propriedade são:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
A classificação do vídeo do Escritório de Administração de Filmes, Jornais e Artigos de Hong Kong.

Os valores válidos para essa propriedade são:
  • fcoI – I
  • fcoIi – II
  • fcoIia: IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Essa propriedade foi descontinuada em 2 de novembro de 2015. Use a propriedade contentDetails.contentRating.cncRating.

A classificação do vídeo de acordo com o Centre national du cinéma et de l'image animé (Ministério da Cultura da França).

Os valores válidos para essa propriedade são:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
A classificação do vídeo de acordo com o Conselho de Cinema e Publicações da África do Sul.

Os valores válidos para essa propriedade são:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Motivos que explicam por que o vídeo recebeu a classificação do FPB (África do Sul).
contentDetails.contentRating.fskRating string
A classificação do vídeo de acordo com a Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Alemanha).

Os valores válidos para essa propriedade são:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6: FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
A classificação do vídeo na Grécia.

Os valores válidos para essa propriedade são:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – Ensino fundamental e médio
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
A classificação do vídeo de acordo com o Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Espanha).

Os valores válidos para essa propriedade são:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
A classificação do vídeo de acordo com o Irish Film Classification Office (IFCO - Irlanda). Consulte o site da IFCO para mais informações.

Os valores válidos para essa propriedade são:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ifco15a – 15A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
A classificação do vídeo em Israel.

Os valores válidos para essa propriedade são:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
A classificação do vídeo de acordo com o INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina).

Os valores válidos para essa propriedade são:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (somente para maiores de 18 anos, exibição condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (apenas para maiores de 16 anos)
  • incaaSam18 – 18 (somente para maiores de 18 anos)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
A classificação do vídeo de acordo com o Conselho de Classificação de Filmes do Quênia.

Os valores válidos para essa propriedade são:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Países Baixos).

Os valores válidos para essa propriedade são:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
A classificação do vídeo de acordo com o Conselho de Classificação de Mídia da Coreia (영상물등급위원회). O KMRB classifica vídeos na Coreia do Sul.

Os valores válidos para essa propriedade são:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll: 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
A classificação do vídeo do Lembaga Sensor Film da Indonésia.

Os valores válidos para essa propriedade são:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
A classificação do vídeo de acordo com o Conselho de Classificação Etária de Filmes de Malta.

Os valores válidos para essa propriedade são:
  • mccaa12 – 12
  • mccaa12a – 12A
  • mccaa14 – 14: essa classificação foi removida da nova estrutura de classificação introduzida em 2013.
  • mccaa15 – 15
  • mccaa16 – 16: essa classificação foi removida da nova estrutura de classificação introduzida em 2013.
  • mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
A classificação do vídeo do Conselho de Mídia para Crianças e Jovens do Instituto de Cinema Dinamarquês (Det Danske Filminstitut).

Os valores válidos para essa propriedade são:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
O sistema de classificação do vídeo para o Vietnã: MCST

Os valores válidos para essa propriedade são:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating string
A classificação do vídeo da Autoridade de Desenvolvimento de Mídia (MDA, na sigla em inglês) de Singapura e, especificamente, do Conselho de Censores de Filmes (BFC, na sigla em inglês).

Os valores válidos para essa propriedade são:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
A classificação do vídeo de acordo com a Medietilsynet, a Autoridade de Mídia da Noruega.

Os valores válidos para essa propriedade são:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
A classificação do vídeo do Kansallinen Audiovisuaalinen Instituutti (Instituto Nacional Audiovisual) da Finlândia.

Os valores válidos para essa propriedade são:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
A classificação do vídeo do Ministero dei Beni e delle Attività Culturali e del Turismo (Itália).

Os valores válidos para essa propriedade são:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
A classificação do vídeo de acordo com o Ministério da Cultura da Colômbia.

Os valores válidos para essa propriedade são:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned: banido
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
A classificação do vídeo de acordo com o Ministério da Cultura de Taiwan (文化部).

Os valores válidos para essa propriedade são:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
A classificação da Motion Picture Association of America (MPAA) do vídeo.

Os valores válidos para essa propriedade são:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
A classificação da Motion Picture Association of America para trailers e prévias de filmes.

Os valores válidos para essa propriedade são:
  • mpaatGb – GB (faixa verde – aprovado para todos os públicos)
  • mpaatRb – RB (Red Band - Recommended for ages 17+)
contentDetails.contentRating.mtrcbRating string
A classificação do vídeo de acordo com o Conselho de Classificação e Análise de Filmes e Televisão (Filipinas).

Os valores válidos para essa propriedade são:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18: R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
A classificação do vídeo de acordo com o Maldives National Bureau of Classification.

Os valores válidos para essa propriedade são:
  • nbc12plus – 12 anos ou mais
  • nbc15plus – 15 anos ou mais
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu: PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
A classificação do vídeo de acordo com o Bulgarian National Film Center.

Os valores válidos para essa propriedade são:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
A classificação do vídeo do National Film and Video Censors Board da Nigéria.

Os valores válidos para essa propriedade são:
  • nfvcb12 – 12
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
A classificação do vídeo do Nacionãlais Kino centrs (Centro Nacional de Cinema da Letônia).

Os valores válidos para essa propriedade são:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
A classificação do vídeo de acordo com o Office of Film and Literature Classification (OFLC - Nova Zelândia).

Os valores válidos para essa propriedade são:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
A classificação do vídeo no Peru.

Os valores válidos para essa propriedade são:
  • pefilm14 – 14
  • pefilm18 – 18
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
A classificação do vídeo na Venezuela.

Os valores válidos para essa propriedade são:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
A classificação da Diretoria Geral de Rádio, Televisão e Cinematografia (México) do vídeo.

Os valores válidos para essa propriedade são:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – D
  • rtcUnrated
contentDetails.contentRating.rteRating string
A classificação do vídeo da Raidió Teilifís Éireann da Irlanda.

Os valores válidos para essa propriedade são:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
A classificação do vídeo de acordo com o Registro Nacional de Filmes da Federação Russa (MKRF - Rússia).

Os valores válidos para essa propriedade são:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
A classificação do vídeo na Eslováquia.

Os valores válidos para essa propriedade são:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
A classificação do vídeo na Islândia.

Os valores válidos para essa propriedade são:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – G
  • smaisUnrated
contentDetails.contentRating.smsaRating string
A classificação do vídeo do Statens medieråd (Conselho Nacional de Mídia da Suécia).

Os valores válidos para essa propriedade são:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – Todas as idades
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
A classificação do vídeo de acordo com as diretrizes de classificação indicativa para TV (TVPG, na sigla em inglês).

Os valores válidos para essa propriedade são:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY: conteúdo infantil
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Uma classificação que o YouTube usa para identificar conteúdo com restrição de idade.

Os valores válidos para essa propriedade são:
  • ytAgeRestricted
contentDetails.projection string
Especifica o formato de projeção do vídeo.

Os valores válidos para essa propriedade são:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Indica se o usuário que fez o envio do vídeo forneceu uma imagem de miniatura personalizada para ele. Essa propriedade só fica visível para quem enviou o vídeo.
status object
O objeto status contém informações sobre os status de envio, processamento e privacidade do vídeo.
status.uploadStatus string
O status do vídeo enviado.

Os valores válidos para essa propriedade são:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Esse valor explica por que um vídeo não foi enviado. Essa propriedade só estará presente se a propriedade uploadStatus indicar que o upload falhou.

Os valores válidos para essa propriedade são:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Esse valor explica por que o YouTube rejeitou um vídeo enviado. Essa propriedade só estará presente se a propriedade uploadStatus indicar que o upload foi rejeitado.

Os valores válidos para essa propriedade são:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
O status de privacidade do vídeo. Em uma solicitação videos.insert, se você não especificar um valor para essa propriedade, o status de privacidade do vídeo enviado será definido como public por padrão. Alguns envios podem ser definidos como private por padrão com base nas configurações da conta do criador de conteúdo, conforme explicado na Central de Ajuda do YouTube. Os vídeos enviados de projetos de API não verificados não estão restritos ao modo de visualização privada.

Os valores válidos para essa propriedade são:
  • private
  • public
  • unlisted
status.publishAt datetime
A data e a hora em que o vídeo está programado para ser publicado. Ele só pode ser definido se o status de privacidade do vídeo for privado. O valor é especificado no formato ISO 8601. Observe os dois pontos adicionais a seguir sobre o comportamento dessa propriedade:
  • Se você definir o valor dessa propriedade ao chamar o método videos.update, também precisará definir o valor da propriedade status.privacyStatus como private, mesmo que o vídeo já seja privado.
  • Essa propriedade só pode ser definida se o status de privacidade do vídeo for private e ele nunca tiver sido publicado.
  • Se a solicitação programar um vídeo para ser publicado em algum momento no passado, ele será publicado imediatamente. Assim, o efeito de definir a propriedade status.publishAt para uma data e hora no passado é o mesmo de mudar o privacyStatus do vídeo de private para public.
status.license string
A licença do vídeo.

Os valores válidos para essa propriedade são:
  • creativeCommon
  • youtube
status.embeddable boolean
Esse valor indica se o vídeo pode ser incorporado a outro site.
status.publicStatsViewable boolean
Esse valor indica se as estatísticas de vídeo detalhadas na página de exibição do vídeo estão visíveis ao público. Por padrão, essas estatísticas são visíveis, e estatísticas como a contagem de visualizações e as classificações de um vídeo ainda estarão visíveis publicamente, mesmo que o valor dessa propriedade esteja definido como false.
status.madeForKids boolean
Esse valor indica se o vídeo foi designado como conteúdo para crianças e contém o status atual de "conteúdo para crianças" do vídeo. Por exemplo, o status pode ser determinado com base no valor da propriedade selfDeclaredMadeForKids. Consulte a Central de Ajuda do YouTube para mais informações sobre como definir o público do seu canal, vídeos ou transmissões.
status.selfDeclaredMadeForKids boolean
Em uma solicitação videos.insert ou videos.update, essa propriedade permite que o proprietário do canal defina o vídeo como conteúdo para crianças. Em uma solicitação videos.list, o valor da propriedade só será retornado se o proprietário do canal tiver autorizado a solicitação de API.
status.containsSyntheticMedia boolean
Em uma solicitação videos.insert ou videos.update, essa propriedade permite que o proprietário do canal divulgue que um vídeo contém conteúdo realista alterado ou sintético (A/S). Saiba mais sobre as políticas do YouTube relacionadas a conteúdo A/S.

Exemplos de conteúdo A/S incluem vídeos que:
  • Fazer uma pessoa real parecer dizer ou fazer algo que não disse nem fez
  • Alterar a filmagem de um evento ou lugar real
  • Gerar uma cena com aparência realista que não existiu de verdade
statistics object
O objeto statistics contém estatísticas sobre o vídeo.
statistics.viewCount unsigned long

É o número de visualizações do vídeo.

A partir de 24 de agosto de 2026, para todos os formatos de vídeo (longos, transmissões ao vivo e Shorts) em um canal, viewCount será atualizado para contar as visualizações no momento em que um vídeo começa a ser reproduzido (inclui reprodução automática, passar o ponteiro sobre o vídeo e clicar/tocar para reproduzir).
statistics.likeCount unsigned long
O número de usuários que indicaram que gostaram do vídeo.
statistics.dislikeCount unsigned long
Observação:a propriedade statistics.dislikeCount foi definida como particular em 13 de dezembro de 2021. Isso significa que a propriedade será incluída em uma resposta da API somente se a solicitação de API tiver sido autenticada pelo proprietário do vídeo. Consulte o histórico de revisões para mais informações.

O número de usuários que indicaram que não gostaram do vídeo.
statistics.favoriteCount unsigned long
Observação:essa propriedade foi descontinuada. A descontinuação entra em vigor em 28 de agosto de 2015. O valor da propriedade agora é sempre definido como 0.
statistics.commentCount unsigned long
O número de comentários no vídeo.
paidProductPlacementDetails object
O objeto paidProductPlacementDetails contém informações sobre a inserção paga de produto no vídeo.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Defina como true se o conteúdo usar inserção paga de produto. O padrão é false.
player object
O objeto player contém informações que você usaria para reproduzir o vídeo em um player incorporado.
player.embedHtml string
Uma tag <iframe> que incorpora um player para reproduzir o vídeo.
  • Se a solicitação de API para recuperar o recurso especificar um valor para os parâmetros maxHeight e/ou maxWidth, o tamanho do player incorporado será dimensionado para atender aos requisitos de maxHeight e/ou maxWidth.
  • Se a proporção do vídeo for desconhecida, o player incorporado vai usar o formato 4:3 por padrão.
player.embedHeight long
A altura do player incorporado retornada na propriedade player.embedHtml. Essa propriedade só será retornada se a solicitação especificar um valor para os parâmetros maxHeight e/ou maxWidth e a proporção do vídeo for conhecida.
player.embedWidth long
A largura do player incorporado retornada na propriedade player.embedHtml. Essa propriedade só é retornada se a solicitação especificou um valor para os parâmetros maxHeight e/ou maxWidth e a proporção da tela do vídeo é conhecida.
topicDetails object
O objeto topicDetails encapsula informações sobre temas associados ao vídeo.

Importante:consulte as definições das propriedades topicDetails.relevantTopicIds[] e topicDetails.topicIds[], bem como o histórico de revisões para mais detalhes sobre as próximas mudanças relacionadas aos IDs de temas.
topicDetails.topicIds[] list
Importante:essa propriedade foi descontinuada em 10 de novembro de 2016. A API não retorna mais valores para essa propriedade, e todos os tópicos associados a um vídeo agora são retornados pelo valor da propriedade topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Uma lista de IDs de temas relevantes para o vídeo.

Essa propriedade foi descontinuada em 10 de novembro de 2016. Ele será compatível até 10 de novembro de 2017.

Importante:devido à descontinuação do Freebase e da API Freebase, os IDs de temas começaram a funcionar de maneira diferente a partir de 27 de fevereiro de 2017. Naquela época, o YouTube começou a retornar um pequeno conjunto de IDs de tópicos selecionados.
topicDetails.topicCategories[] list
Uma lista de URLs da Wikipédia que fornecem uma descrição de alto nível do conteúdo do vídeo.
recordingDetails object
O objeto recordingDetails encapsula informações sobre o local, a data e o endereço em que o vídeo foi gravado.
recordingDetails.locationDescription string
Essa propriedade foi descontinuada em 1º de junho de 2017. Confira mais detalhes no comunicado sobre a descontinuação.

A descrição em texto do local onde o vídeo foi gravado.
recordingDetails.location object
Essa propriedade foi descontinuada. Todas as propriedades secundárias (latitude, longitude, altitude) estão descontinuadas.

As informações de geolocalização associadas ao vídeo. Os valores da propriedade filha identificam o local que o proprietário do vídeo quer associar a ele. O valor é editável, pode ser pesquisado em vídeos públicos e pode ser exibido aos usuários em vídeos públicos.
recordingDetails.location.latitude double
Essa propriedade foi descontinuada em 1º de junho de 2017. Consulte o comunicado sobre a descontinuação para mais detalhes.

Latitude em graus.
recordingDetails.location.longitude double
Essa propriedade foi descontinuada em 1º de junho de 2017. Consulte o comunicado sobre a descontinuação para mais detalhes.

Longitude em graus.
recordingDetails.location.altitude double
Essa propriedade foi descontinuada em 9 de julho de 2018. Confira mais detalhes no comunicado sobre a descontinuação.

Altitude acima do elipsoide de referência, em metros.
recordingDetails.recordingDate datetime
A data e a hora em que o vídeo foi gravado. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
O objeto fileDetails encapsula informações sobre o arquivo de vídeo enviado ao YouTube, incluindo resolução, duração, codecs de áudio e vídeo, taxas de bits de transmissão e muito mais. Esses dados só podem ser recuperados pelo proprietário do vídeo.

O objeto fileDetails só será retornado se a propriedade processingDetails.fileAvailability tiver um valor de available.
fileDetails.fileName string
O nome do arquivo enviado. Este campo estará presente se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado.
fileDetails.fileSize unsigned long
O tamanho do arquivo enviado em bytes. Este campo estará presente se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado.
fileDetails.fileType string
O tipo do arquivo enviado, conforme detectado pelo mecanismo de processamento de vídeo do YouTube. No momento, o YouTube só processa arquivos de vídeo, mas esse campo está presente se um arquivo de vídeo ou outro tipo de arquivo foi enviado.

Os valores válidos para essa propriedade são:
  • archive: o arquivo é um arquivo ZIP, como um .zip.
  • audio: o arquivo é de um tipo de arquivo de áudio conhecido, como .mp3.
  • document: o arquivo é um documento ou arquivo de texto, como um documento do MS Word.
  • image: o arquivo é um arquivo de imagem, como .jpeg.
  • other: o arquivo é de outro tipo de arquivo que não é de vídeo.
  • project: o arquivo é um projeto de vídeo, como um projeto do Microsoft Windows Movie Maker, que não contém dados de vídeo reais.
  • video – O arquivo é de um tipo de arquivo de vídeo conhecido, como .mp4.
fileDetails.container string
O formato de contêiner do arquivo de vídeo enviado.
fileDetails.videoStreams[] list
Uma lista de streams de vídeo contidos no arquivo de vídeo enviado. Cada item da lista contém metadados detalhadas sobre um stream de vídeo.
fileDetails.videoStreams[].widthPixels unsigned integer
A largura do conteúdo de vídeo codificado em pixels. É possível calcular a proporção de codificação do vídeo como width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
A altura do conteúdo de vídeo codificado em pixels.
fileDetails.videoStreams[].frameRateFps double
É o frame rate do fluxo de vídeo, em quadros por segundo.
fileDetails.videoStreams[].aspectRatio double
A proporção de exibição do conteúdo de vídeo, que especifica a proporção em que o vídeo deve ser mostrado.
fileDetails.videoStreams[].codec string
O codec de vídeo usado pelo stream.
fileDetails.videoStreams[].bitrateBps unsigned long
A taxa de bits do stream de vídeo, em bits por segundo.
fileDetails.videoStreams[].rotation string
O quanto o YouTube precisa girar o conteúdo de origem original para exibir o vídeo corretamente.

Os valores válidos para essa propriedade são:
  • clockwise – O vídeo precisa ser girado 90 graus no sentido horário.
  • counterClockwise – O vídeo precisa ser girado 90 graus no sentido anti-horário.
  • none: o vídeo não precisa ser girado.
  • other: o vídeo precisa ser girado de outra forma, não trivial.
  • upsideDown: o vídeo precisa ser girado de cabeça para baixo.
fileDetails.videoStreams[].vendor string
Um valor que identifica exclusivamente um fornecedor de vídeo. Normalmente, o valor é um código de fornecedor de quatro letras.
fileDetails.audioStreams[] list
Uma lista de streams de áudio contidos no arquivo de vídeo enviado. Cada item da lista contém metadados detalhados sobre um stream de áudio.
fileDetails.audioStreams[].channelCount unsigned integer
O número de canais de áudio que o stream contém.
fileDetails.audioStreams[].codec string
O codec de áudio usado pelo stream.
fileDetails.audioStreams[].bitrateBps unsigned long
A taxa de bits do stream de áudio, em bits por segundo.
fileDetails.audioStreams[].vendor string
Um valor que identifica exclusivamente um fornecedor de vídeo. Normalmente, o valor é um código de fornecedor de quatro letras.
fileDetails.durationMs unsigned long
A duração do vídeo enviado em milissegundos.
fileDetails.bitrateBps unsigned long
A taxa de bits combinada (vídeo e áudio) do arquivo de vídeo enviado em bits por segundo.
fileDetails.creationTime string
A data e a hora em que o arquivo de vídeo enviado foi criado. O valor é especificado no formato ISO 8601. No momento, os seguintes formatos ISO 8601 são aceitos:
  • Somente data: YYYY-MM-DD
  • Horário sem fuso: YYYY-MM-DDTHH:MM:SS
  • Horário com fuso horário: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
O objeto processingDetails encapsula informações sobre o progresso do YouTube no processamento do arquivo de vídeo enviado. As propriedades do objeto identificam o status de processamento atual e uma estimativa do tempo restante até que o YouTube termine o processamento do vídeo. Esta parte também indica se os diferentes tipos de dados ou de conteúdo, como detalhes do arquivo ou imagens em miniatura, estão disponíveis para o vídeo.

O objeto processingProgress foi projetado para ser consultado, de modo que o vídeo enviado possa acompanhar o progresso do YouTube no processamento do arquivo de vídeo enviado. Esses dados só podem ser recuperados pelo proprietário do vídeo.
processingDetails.processingStatus string
O status de processamento do vídeo. Esse valor indica se o YouTube conseguiu processar o vídeo ou se ele ainda está sendo processado.

Os valores válidos para essa propriedade são:
  • failed: falha no processamento do vídeo. Consulte ProcessingFailureReason.
  • processing: o vídeo está sendo processado. Consulte ProcessingProgress.
  • succeeded: o vídeo foi processado.
  • terminated – As informações de processamento não estão mais disponíveis.
processingDetails.processingProgress object
O objeto processingProgress contém informações sobre o progresso do YouTube no processamento do vídeo. Os valores só são relevantes se o status de processamento do vídeo for processing.
processingDetails.processingProgress.partsTotal unsigned long
Uma estimativa do número total de partes que precisam ser processadas para o vídeo. O número pode ser atualizado com estimativas mais precisas enquanto o YouTube processa o vídeo.
processingDetails.processingProgress.partsProcessed unsigned long
O número de partes do vídeo que o YouTube já processou. Para estimar a porcentagem do vídeo que o YouTube já processou, calcule:
100 * parts_processed / parts_total

. Como o número estimado de partes pode aumentar sem um aumento correspondente no número de partes já processadas, é possível que o progresso calculado diminua periodicamente enquanto o YouTube processa um vídeo.
processingDetails.processingProgress.timeLeftMs unsigned long
Uma estimativa da quantidade de tempo, em milissegundos, que o YouTube precisa para terminar de processar o vídeo.
processingDetails.processingFailureReason string
O motivo pelo qual o YouTube não conseguiu processar o vídeo. Essa propriedade só terá um valor se o valor da propriedade processingStatus for failed.

Os valores válidos para essa propriedade são:
  • other: falha em algum outro componente de processamento.
  • streamingFailed: não foi possível enviar o vídeo para os streamers.
  • transcodeFailed: falha na transcodificação do conteúdo.
  • uploadFailed: falha na entrega do arquivo.
processingDetails.fileDetailsAvailability string
Esse valor indica se os detalhes do arquivo estão disponíveis para o vídeo enviado. Para recuperar os detalhes do arquivo de um vídeo, solicite a parte fileDetails na sua solicitação videos.list().
processingDetails.processingIssuesAvailability string
Esse valor indica se o mecanismo de processamento de vídeo gerou sugestões que podem melhorar a capacidade do YouTube de processar o vídeo, avisos que explicam problemas de processamento de vídeo ou erros que causam problemas de processamento de vídeo. Para receber essas sugestões, solicite a parte suggestions na sua solicitação videos.list().
processingDetails.tagSuggestionsAvailability string
Esse valor indica se as sugestões de palavras-chave (tags) estão disponíveis para o vídeo. As tags podem ser adicionadas aos metadados de um vídeo para facilitar que outros usuários encontrem-no. Para receber essas sugestões, solicite a parte suggestions na sua solicitação videos.list().
processingDetails.editorSuggestionsAvailability string
Esse valor indica se as sugestões de edição de vídeo, que podem melhorar a qualidade do vídeo ou a experiência de reprodução, estão disponíveis para o vídeo. Para recuperar essas sugestões, solicite a parte suggestions na sua solicitação videos.list().
processingDetails.thumbnailsAvailability string
Esse valor indica se as imagens em miniatura foram geradas para o vídeo.
suggestions object
O objeto suggestions encapsula sugestões que identificam oportunidades para melhorar a qualidade do vídeo ou os metadados do vídeo enviado. Esses dados só podem ser recuperados pelo proprietário do vídeo.

O objeto suggestions só será retornado se a propriedade processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability tiver um valor de available.
suggestions.processingErrors[] list
Uma lista de erros que impedem o YouTube de processar o vídeo enviado. Esses erros indicam que, independente do status de processamento atual do vídeo, ele quase certamente será failed.

Os valores válidos para essa propriedade são:
  • archiveFile: um arquivo de arquivo (por exemplo, um arquivo ZIP).
  • audioFile: o arquivo contém apenas áudio (por exemplo, um arquivo MP3).
  • docFile: documento ou arquivo de texto (por exemplo, documento do MS Word).
  • imageFile: arquivo de imagem (por exemplo, uma imagem JPEG).
  • notAVideoFile: outro arquivo que não é de vídeo.
  • projectFile: arquivo de projeto de filme (por exemplo, projeto do Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Uma lista de motivos pelos quais o YouTube pode ter dificuldade para transcodificar o vídeo enviado ou que podem resultar em uma transcodificação incorreta. Esses avisos são gerados antes de o YouTube realmente processar o arquivo de vídeo enviado. Além disso, eles identificam problemas que não indicam necessariamente que o processamento do vídeo vai falhar, mas que ainda podem causar problemas, como problemas de sincronização, artefatos de vídeo ou uma faixa de áudio ausente.

Os valores válidos para essa propriedade são:
  • hasEditlist – No momento, não é possível editar listas.
  • inconsistentResolution: resoluções de contêiner e stream conflitantes.
  • problematicAudioCodec – Foi usado um codec de áudio que causa problemas.
  • problematicVideoCodec: foi usado um codec de vídeo que causa problemas.
  • unknownAudioCodec: codec de áudio não reconhecido. É provável que a transcodificação falhe.
  • unknownContainer: formato do arquivo não reconhecido. É provável que a transcodificação falhe.
  • unknownVideoCodec: codec de vídeo não reconhecido. É provável que a transcodificação falhe.
suggestions.processingHints[] list
Uma lista de sugestões que podem melhorar a capacidade do YouTube de processar o vídeo.

Os valores válidos para essa propriedade são:
  • nonStreamableMov: o arquivo MP4 não pode ser transmitido, o que vai deixar o processamento mais lento.
  • sendBestQualityVideo: provavelmente existe uma versão de melhor qualidade do vídeo.
suggestions.tagSuggestions[] list
Uma lista de tags de palavras-chave que podem ser adicionadas aos metadados do vídeo para aumentar a probabilidade de os usuários encontrarem seu conteúdo ao pesquisar ou navegar no YouTube.
suggestions.tagSuggestions[].tag string
A tag de palavra-chave sugerida para o vídeo.
suggestions.tagSuggestions[].categoryRestricts[] list
Um conjunto de categorias de vídeo para as quais a tag é relevante. Você pode usar essas informações para exibir sugestões de tags apropriadas com base na categoria de vídeo que o usuário que faz upload associa ao vídeo. Por padrão, sugestões de tags são relevantes para todas as categorias se não houver restrições definidas para a palavra-chave.
suggestions.editorSuggestions[] list
Uma lista de operações de edição de vídeo que podem melhorar a qualidade do vídeo ou a experiência de reprodução do vídeo enviado.

Os valores válidos para essa propriedade são:
  • audioQuietAudioSwap: a faixa de áudio parece estar sem som e pode ser trocada por uma de melhor qualidade.
  • videoAutoLevels: os níveis de brilho da imagem parecem incorretos e podem ser corrigidos.
  • videoCrop – As margens (opacas) detectadas ao redor da imagem podem ser cortadas.
  • videoStabilize: o vídeo parece tremido e pode ser estabilizado.
liveStreamingDetails object
O objeto liveStreamingDetails contém metadados sobre uma transmissão de vídeo ao vivo. O objeto só vai estar presente em um recurso video se o vídeo for uma transmissão ao vivo futura, em andamento ou concluída.
liveStreamingDetails.actualStartTime datetime
O horário em que a transmissão realmente começou. O valor é especificado no formato ISO 8601. Esse valor só vai estar disponível quando a transmissão começar.
liveStreamingDetails.actualEndTime datetime
O horário em que a transmissão realmente terminou. O valor é especificado no formato ISO 8601. Esse valor só vai estar disponível quando a transmissão terminar.
liveStreamingDetails.scheduledStartTime datetime
O horário em que a transmissão está programada para começar. O valor é especificado no formato ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
O horário em que a transmissão está programada para terminar. O valor é especificado no formato ISO 8601. Se o valor estiver vazio ou a propriedade não estiver presente, a transmissão será programada para continuar indefinidamente.
liveStreamingDetails.concurrentViewers unsigned long
O número de espectadores que estão assistindo a transmissão no momento. A propriedade e o valor dela vão estar presentes se a transmissão tiver espectadores atuais e o proprietário não tiver ocultado a contagem de visualizações do vídeo. O YouTube para de rastrear o número de espectadores simultâneos de uma transmissão quando ela termina. Portanto, essa propriedade não identifica o número de espectadores que assistem um vídeo arquivado de uma transmissão ao vivo que já terminou.
As contagens de espectadores simultâneos retornadas pela API YouTube Data podem ser diferentes das contagens processadas e sem spam disponíveis no YouTube Analytics. Saiba mais sobre as métricas de transmissão ao vivo na Central de Ajuda do YouTube.
liveStreamingDetails.activeLiveChatId string
O ID do chat ao vivo ativo no momento que está anexado a este vídeo. Esse campo só é preenchido se o vídeo for uma transmissão ao vivo com chat ao vivo. Quando a transmissão fizer a transição para a conclusão, esse campo será removido e o chat ao vivo será encerrado. Para transmissões persistentes, o ID do chat ao vivo não será mais vinculado a esse vídeo, mas sim ao novo vídeo exibido na página persistente.
brandPartner object
O objeto brandPartner contém detalhes sobre a marca parceira vinculada ao vídeo para o acesso da marca parceira iniciado pelo criador de conteúdo (CI BPA).
brandPartner.channelId string
O ID do canal externo da marca parceira. Esse campo precisa começar com "UC". É necessário definir channelId ou channelHandle ao estabelecer o acesso, mas apenas channelId é retornado na resposta.
brandPartner.channelHandle string
O identificador do canal da marca parceira. Esse campo precisa começar com "@". channelId ou channelHandle precisa ser definido ao estabelecer o acesso, mas apenas channelId é retornado na resposta.
localizations object
O objeto localizations contém traduções dos metadados do vídeo.
localizations.(key) object
O idioma do texto localizado associado ao valor da chave. O valor é uma string que contém um código de idioma BCP-47.
localizations.(key).title string
O título localizado do vídeo.
localizations.(key).description string
A descrição localizada do vídeo.