Videos

Todos os vídeos enviados por meio do endpoint videos.insert de projetos de API não verificados criados após 28 de julho de 2020 ficarão restritos ao modo de visualização particular. Para remover essa restrição, cada projeto de API precisa passar por uma auditoria para verificar a conformidade com os Termos de Serviço. Consulte o Histórico de revisões da API para mais detalhes.

Um recurso video representa um vídeo do YouTube.

Métodos

A API oferece suporte aos seguintes métodos para recursos videos:

getRating

Recupera as avaliaçõ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 de solicitação da API. Faça um teste agora.

inserir

Faz upload de um vídeo no YouTube e, opcionalmente, define os metadados dele.

update

Atualiza os metadados de um vídeo. Faça um teste agora.

excluir

Exclui um vídeo do YouTube. Faça um teste agora.

taxa

Adicionar uma classificação "Gostei" ou "Não gostei" a um vídeo ou remover uma classificação de um vídeo. Faça um teste agora.

reportAbuse

Denunciar um vídeo por incluir 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propriedades

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

Propriedades
kind	string Identifica o tipo de recurso da API. O valor será youtube#video.
etag	etag A Etag desse recurso.
id	string O ID que o YouTube usa para identificar de forma exclusiva o vídeo.
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 período pode ser diferente do horário em que o vídeo foi enviado. Por exemplo, se um vídeo for enviado como privado e, depois, definido como público, essa propriedade 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 do vídeo forem recuperados pelo proprietário do canal, o valor da propriedade 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 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. O valor é especificado no formato ISO 8601.
snippet.channelId	string O ID que o YouTube usa para identificar de forma exclusiva o canal em que o vídeo foi enviado.
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ê precisará 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 tamanho máximo de 5.000 bytes e pode conter todos os caracteres UTF-8 válidos, exceto < e >.
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 As chaves-valor válidas são: default – A imagem em 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 resolução mais alta 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 de alta resolução da imagem em 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 com resolução ainda maior da imagem em miniatura do que a imagem com resolução high. Essa imagem está disponível para alguns vídeos e outros recursos relacionados a vídeos, como itens de playlist ou resultados de pesquisa. Esta imagem tem 640 px de largura e 480 px de altura. maxres – A versão de resolução mais alta da imagem em miniatura. Esse tamanho de imagem está disponível para alguns vídeos e outros recursos relacionados a vídeos, como itens de playlist ou resultados de pesquisa. Esta imagem tem 1.280 px de largura e 720 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 O título do canal a que 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 tem um comprimento máximo de 500 caracteres. Observe as seguintes regras sobre a forma como o limite de caracteres é calculado: O valor da propriedade é uma lista, e as vírgulas entre os itens da lista são contabilizadas no limite. Se uma tag tiver um espaço, o servidor da API processará o valor da tag como se ele estivesse entre aspas, e as aspas contam para o limite de caracteres. Portanto, em relação aos 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 conteúdo. Defina um valor para essa propriedade se você 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. Ou será "nenhum" 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 para os 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 precisa ser retornado e o texto localizado estiver disponível nesse idioma. Os metadados do idioma padrão serã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 do vídeo localizado.
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 da disponibilidade de legendas para o vídeo.
contentDetails.duration	string A duração do vídeo. O valor da propriedade é uma duração ISO 8601. Por exemplo, para um vídeo com pelo menos um minuto e menos de uma hora de duração, 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. Se o vídeo tiver pelo menos uma hora, a duração vai estar no formato 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, 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, o que significa que o conteúdo foi enviado a um canal vinculado a um parceiro de conteúdo do YouTube e depois reivindicado por esse parceiro.
contentDetails.regionRestriction	object O objeto regionRestriction contém informações sobre os países onde um vídeo é (ou não) visível. 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 regionais que identificam os países em que o vídeo é 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 esquemas de classificação.
contentDetails.contentRating.acbRating	string A classificação do Conselho de Classificação da Austrália (ACB, na sigla em inglês) ou da Autoridade Australiana de Comunicações e Mídia (ACMA, na sigla em inglês) dos vídeos. As classificações da ACMA são usadas para classificar a programação de televisão para crianças. Os valores válidos para essa propriedade são: acbC: programas que receberam a classificação C da Australian Communications and Media Authority. Esses programas são destinados a crianças (exceto crianças em idade pré-escolar) que têm menos de 14 anos. acbE a L acbG a G acbM a M acbMa15plus a MA15+ acbP: programas que receberam a classificação P da Australian Communications and Media Authority. Esses programas são destinados a crianças em idade pré-escolar. acbPg – PG acbR18plus a R18+ acbUnrated
contentDetails.contentRating.agcomRating	string A classificação do vídeo feita pela Autorità per le Garanzie nelle Comunicazioni (AGCOM) da Itália. Os valores válidos para essa propriedade são: agcomT a T agcomUnrated agcomVm14 a VM 14 agcomVm18 a VM 18
contentDetails.contentRating.anatelRating	string A classificação do vídeo da Anatel (Asociación Nacional de Televisión) para a televisão chilena. Os valores válidos para essa propriedade são: anatelA - A anatelF a F anatelI – I anatelI10 a I-10 anatelI12 a I-12 anatelI7 a I-7 anatelR a D anatelUnrated
contentDetails.contentRating.bbfcRating	string A classificação do Conselho Britânico de Classificação de Filmes (BBFC, na sigla em inglês) do vídeo. Os valores válidos para a propriedade são: bbfc12 a 12 bbfc12a a 12 A bbfc15 a 15 bbfc18 a 18 bbfcPg – PG bbfcR18 a R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string A classificação do vídeo feita pelo Conselho de Cinema e Censores da Tailândia. Os valores válidos para essa propriedade são: bfvc13 a 13 bfvc15 a 15 bfvc18 a 18 bfvc20 a 20 bfvcB a B bfvcE a L bfvcG a G bfvcUnrated
contentDetails.contentRating.bmukkRating	string É a classificação do vídeo feita pelo Conselho de Classificação de Mídia da Áustria (Bundesministerium für Unterricht, Kunst und Kultur). Os valores válidos para a propriedade são: De bmukk10 a mais de 10 De bmukk12 a mais de 12 anos De bmukk14 a mais de 14 anos De bmukk16 a mais de 16 anos De bmukk6 a 6 anos ou mais De bmukk8 a 8 anos ou mais bmukkAa: irrestrito bmukkUnrated
contentDetails.contentRating.catvRating	string Sistema de classificação para TV canadense – Sistema de classificação de TV canadense É a classificação do vídeo feita pela Comissão Canadense de Rádio e Televisão e Telecomunicações (CRTC, na sigla em inglês) para transmissões em inglês canadense. Para mais informações, consulte o site do Conselho de Padrões de Transmissão do Canadá. Os valores válidos para esta propriedade são: De catv14plus a mais de 14 anos De catv18plus a mais de 18 anos catvC a C catvC8 a C8 catvG a G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string É a classificação do vídeo feita pela Comissão Canadense de Rádio e Televisão e Telecomunicações (CRTC, na sigla em inglês) para transmissões em francês canadense. Para mais informações, consulte o site do Conselho de Padrões de Transmissão do Canadá. Os valores válidos para esta propriedade são: De catvfr13plus a mais de 13 anos De catvfr16plus a mais de 16 anos De catvfr18plus a mais de 18 anos De catvfr8plus a 8 anos ou mais catvfrG a G catvfrUnrated
contentDetails.contentRating.cbfcRating	string A classificação do Conselho Central de Certificação de Filmes (CBFC, na sigla em inglês) do vídeo. Os valores válidos para a propriedade são: cbfcA - A cbfcS – P cbfcU – U cbfcUnrated cbfcUA – U/A cbfcUA7plus – U/A cbfcUA13plus – U/A cbfcUA16plus – U/A
contentDetails.contentRating.cccRating	string A classificação do Consejo de Calificación Cinematográfica (Chile). Os valores válidos para esta propriedade são: De ccc14 a mais de 14 anos De ccc18 a mais de 18 anos ccc18s – A partir dos 18 anos – contenido mesma ccc18v a mais de 18 anos: contenido excesivamente violento ccc6 – A partir dos 6 anos - Inconveniente para menores de 7 anos cccTe – Todo o espectador cccUnrated
contentDetails.contentRating.cceRating	string A classificação do vídeo feita pela Comissão de Classificação de Espect ́culos de Portugal. Os valores válidos para esta propriedade são: cceM12 a 12 cceM14 a 14 cceM16 a 16 cceM18 a 18 cceM4 a 4 cceM6 a 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 a 12 chfilm16 a 16 chfilm18 a 18 chfilm6 a 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string A classificação do sistema de classificação de vídeos caseiros (CHVRS, na sigla em inglês) do vídeo. Os valores válidos para essa propriedade são: chvrs14a a 14 A chvrs18a a 18 A chvrsE a L chvrsG a G chvrsPg – PG chvrsR a D chvrsUnrated
contentDetails.contentRating.cicfRating	string A classificação do vídeo feita pela Commission de Contrôle des Films (Bélgica). Os valores válidos para essa propriedade são: cicfE a L cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string A classificação do vídeo feita pela CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) da Romênia. Os valores válidos para essa propriedade são: cna12 a 12 cna15 a 15 cna18 a 18 De cna18plus a mais de 18 anos cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Sistema de classificação na França – Commission de ranking cinematographique Os valores válidos para essa propriedade são: cnc10 a 10 cnc12 a 12 cnc16 a 16 cnc18 a 18 cncE a L cncT a T cncUnrated
contentDetails.contentRating.csaRating	string A classificação do vídeo feita pelo Conseil supérieur de l?audiovisuel da França, que avalia o conteúdo transmitido. Os valores válidos para esta propriedade são: csa10 a 10 csa12 a 12 csa16 a 16 csa18 a 18 csaInterdiction: interdição csaT a T csaUnrated
contentDetails.contentRating.cscfRating	string A classificação do vídeo feita pela Comissão de vigilância da vigilância da classificação de filmes (CSCF, na sigla em inglês) de Luxemburgo. Os valores válidos para esta propriedade são: cscf12 a 12 cscf16 a 16 cscf18 a 18 cscf6 a 6 cscf9 a 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 a 12 czfilm14 a 14 czfilm18 a 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string A classificação do Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil) do vídeo. Os valores válidos para essa propriedade são: djctq10 a 10 djctq12 a 12 djctq14 a 14 djctq16 a 16 djctq18 a 18 djctqL a G djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Motivos que explicam por que o vídeo recebeu a classificação DJCQT (Brasil).
contentDetails.contentRating.ecbmctRating	string Sistema de classificação na Turquia – Conselho de Avaliação e Classificação do Ministério da Cultura e Turismo Os valores válidos para esta propriedade são: ecbmct13a a 13 A De ecbmct13plus a mais de 13 anos ecbmct15a a 15 A De ecbmct15plus a mais de 15 anos De ecbmct18plus a mais de 18 anos ecbmct7a a 7 A De ecbmct7plus a 7 anos ou mais ecbmctG a G ecbmctUnrated ecbmct6a a 6 A De ecbmct6plus a 6 anos ou mais ecbmct10a a 10 A De ecbmct10plus a mais de 10 De ecbmct16plus a mais de 16 anos
contentDetails.contentRating.eefilmRating	string A classificação do vídeo na Estônia. Os valores válidos para essa propriedade são: eefilmK12 a ensinos fundamental e médio De eefilmK14 a ensinos fundamental e médio De eefilmK16 a ensinos fundamental e médio eefilmK6 a ensinos fundamental e médio eefilmL a G eefilmMs12 a MS-12 eefilmMs6 a 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 a 18 egfilmBn a BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string A classificação do Eirin (映倫) do vídeo. Eirin é o sistema de classificação japonês. Os valores válidos para essa propriedade são: eirinG a G De eirinPg12 a PG-12 eirinR15plus a R15+ eirinR18plus a R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string A classificação do vídeo feita pelo Conselho de Censura de Filmes da Malásia. Os valores válidos para essa propriedade são: fcbm13 a 13 fcbm16 a 16 fcbm18 a 18 fcbm18pa a 18 PA fcbm18pl a 18 PL fcbm18sg a 18 SG fcbm18sx a 18SX fcbmP12 a P12 fcbmP13 a P13 De fcbmPg13 a PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string A classificação do vídeo da Agência de Cinema, Jornal e de Artigos de Hong Kong. Os valores válidos para esta propriedade são: fcoI – I fcoIi a II fcoIia a IIA fcoIib a IIB fcoIii a III fcoUnrated
contentDetails.contentRating.fmocRating	string Esta propriedade foi descontinuada em 2 de novembro de 2015. Em vez disso, use a propriedade contentDetails.contentRating.cncRating. A classificação do Centre National du cinéma et de l'image animé (Ministério da Cultura da França) do vídeo. Os valores válidos para esta propriedade são: fmoc10 a 10 fmoc12 a 12 fmoc16 a 16 fmoc18 a 18 fmocE a L fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string A classificação do vídeo feita pelo Conselho de Publicação e Filmes da África do Sul. Os valores válidos para essa propriedade são: fpb10 a 10 fpb1012Pg – 10 a 12 anos fpb13 a 13 fpb16 a 16 fpb18 a 18 fpb79Pg – 7 a 9 PG fpbA - A fpbPg – PG fpbUnrated fpbX18 a X18 fpbXx a XX
contentDetails.contentRating.fpbRatingReasons[]	list Motivos que explicam por que o vídeo recebeu a classificação FPB (África do Sul).
contentDetails.contentRating.fskRating	string A classificação do Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Alemanha) do vídeo. Os valores válidos para essa propriedade são: fsk0 a FSK 0 fsk12 a FSK 12 fsk16 a FSK 16 fsk18 a FSK 18 fsk6 a 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 a L grfilmK a K grfilmK12 a ensinos fundamental e médio grfilmK13 a ensinos fundamental e médio De grfilmK15 a ensinos fundamental e médio De grfilmK17 a ensinos fundamental e médio De grfilmK18 a ensinos fundamental e médio grfilmUnrated
contentDetails.contentRating.icaaRating	string A classificação do Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA, Espanha) do vídeo. Os valores válidos para esta propriedade são: icaa12 a 12 icaa13 a 13 icaa16 a 16 icaa18 a 18 icaa7 a 7 icaaApta: APTA icaaUnrated icaaX a X
contentDetails.contentRating.ifcoRating	string A classificação do Escritório de Classificação de Filmes da Irlanda (IFCO, na sigla em inglês) da Irlanda. Consulte o site da IFCO (em inglês) para mais informações. Os valores válidos para essa propriedade são: ifco12 a 12 ifco12a a 12 A ifco15 a 15 ifco15a a 15 A ifco16 a 16 ifco18 a 18 ifcoG a 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 a 12 ilfilm16 a 16 ilfilm18 a 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string A classificação do INCAA (Instituto Nacional de Cine y Artes Audiovisuales, Argentina) do vídeo. Os valores válidos para esta propriedade são: incaaAtp: ATP (Apta para todo publico) incaaC – X (Solo apta para Mayores de 18 anos, de exhibición condicionada) incaaSam13 – 13 (Solo apta para Mayores de 13 años) incaaSam16 – 16 (Solo apta para Mayores de 16 Años) incaaSam18 – 18 (Solo apta para Mayores de 18 años) incaaUnrated
contentDetails.contentRating.kfcbRating	string A classificação do vídeo feita pelo Conselho de Classificação de Filmes do Quênia. Os valores válidos para essa propriedade são: kfcb16plus a 16 kfcbG – GE kfcbPg – PG kfcbR a 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Países Baixos). Os valores válidos para esta propriedade são: kijkwijzer12 a 12 kijkwijzer14 a 14 kijkwijzer16 a 16 kijkwijzer18 a 18 kijkwijzer6 a 6 kijkwijzer9 a 9 kijkwijzerAl – AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string A classificação do Conselho de Classificação de Mídia da Coreia (Sujeito à Coreia do Sul, Classificação de Classificação de Mídia da Coreia do Sul, Dê sugestões de Classificação 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 armazenadas 람전 kmrbAll – 多체관람자 kmrbR – 청소년 관람불 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string A classificação do vídeo feita pela Lembaga Sensor Film da Indonésia. Os valores válidos para essa propriedade são: lsf13 a 13 lsf17 a 17 lsf21 a 21 lsfA - A lsfBo – BO lsfD a D lsfR a D lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string É a classificação do vídeo feita pelo Conselho de Classificação Indicativa de Filmes de Malta. Os valores válidos para essa propriedade são: mccaa12 a 12 mccaa12a a 12 A mccaa14 – 14: esta classificação foi removida da nova estrutura de classificação, introduzida em 2013. mccaa15 a 15 mccaa16 – 16: esta classificação foi removida da nova estrutura de classificação, introduzida em 2013. mccaa18 a 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string A classificação do vídeo feita pelo Conselho de Mídia do Instituto Dinamarquês de Cinema (Det Danske Filminstitut) para crianças e jovens. Os valores válidos para esta propriedade são: mccyp11 a 11 mccyp15 a 15 mccyp7 a 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 De mcst16plus a mais de 16 anos mcstC13 a C13 mcstC16 a C16 mcstC18 a C18 mcstP a P mcstUnrated mcstT13 a T13 mcstT16 a T16 mcstT18 a T18 mcstK a K
contentDetails.contentRating.mdaRating	string A classificação do vídeo feita pela Autoridade de Desenvolvimento de Mídia (MDA, na sigla em inglês) de Singapura e, especificamente, pelo Board of Film Censors (BFC). Os valores válidos para essa propriedade são: mdaG a G mdaM18 a M18 mdaNc16 a NC16 mdaPg – PG De mdaPg13 a PG13 mdaR21 a R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string A classificação do vídeo feita por Medietilsynet, a Autoridade de Mídia da Noruega. Os valores válidos para esta propriedade são: medietilsynet11 a 11 medietilsynet12 a 12 medietilsynet15 a 15 medietilsynet18 a 18 medietilsynet6 a 6 medietilsynet7 a 7 medietilsynet9 a 9 medietilsynetA - A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string A classificação do vídeo feita pelo Kansallinen Audiovisuaalinen Instituutti (Instituto Nacional de Audiovisual) da Finlândia. Os valores válidos para esta propriedade são: meku12 a 12 meku16 a 16 meku18 a 18 meku7 a 7 mekuS – P 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 esta propriedade são: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string A classificação do Ministerio de Cultura (Colômbia) do vídeo. Os valores válidos para essa propriedade são: moc12 a 12 moc15 a 15 moc18 a 18 moc7 a 7 mocBanned – Banido mocE a L mocT a T mocUnrated mocX a X
contentDetails.contentRating.moctwRating	string A classificação do vídeo feita pelo Ministério da Cultura de Taiwan (Gmail 化部) Os valores válidos para a propriedade são: moctwG a G moctwP a P moctwPg – PG moctwR a D moctwR12 a R-12 moctwR15 a 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 a G mpaaNc17 – NC-17 mpaaPg – PG De mpaaPg13 a PG-13 mpaaR a D 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 esta propriedade são: mpaatGb – GB (Green Band - Aprovado para todos os públicos) mpaatRb – RB (banda vermelha – recomendado para maiores de 17 anos)
contentDetails.contentRating.mtrcbRating	string A classificação do vídeo feita pelo Conselho de Classificação e Análise de Filmes e Televisão (Filipinas). Os valores válidos para a propriedade são: mtrcbG a G mtrcbPg – PG mtrcbR13 a R-13 mtrcbR16 a R-16 De mtrcbR18 a R-18 mtrcbUnrated mtrcbX a X
contentDetails.contentRating.nbcRating	string A classificação do vídeo feita pelo Departamento Nacional de Classificação das Maldivas. Os valores válidos para esta propriedade são: De nbc12plus a mais de 12 anos De nbc15plus a mais de 15 anos De nbc18plus a mais de 18 anos nbc18plusr a 18 anos ou mais nbcG a G nbcPg – PG nbcPu: unidade de processamento nbcUnrated
contentDetails.contentRating.nfrcRating	string A classificação do vídeo do Bulgária National Film Center. Os valores válidos para esta propriedade são: nfrcA - A nfrcB a B nfrcC a C nfrcD a D nfrcUnrated nfrcX a X
contentDetails.contentRating.nfvcbRating	string A classificação do vídeo feita pela National Film and Video Censors Board da Nigéria. Os valores válidos para essa propriedade são: nfvcb12 a 12 nfvcb12a a 12 A nfvcb15 a 15 nfvcb18 a 18 nfvcbG a G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string A classificação do vídeo feita pelos Nacionãlais Kino centrs (Centro Nacional de Cinema da Letônia). Os valores válidos para essa propriedade são: De nkclv12plus a mais de 12 anos De nkclv18plus a mais de 18 anos De nkclv7plus a 7 anos ou mais nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string A classificação do Office of Film and Literature Classification (OFLC - Nova Zelândia) do vídeo. Os valores válidos para essa propriedade são: oflcG a G oflcM a M oflcPg – PG oflcR13 a R13 oflcR15 a R15 oflcR16 a R16 oflcR18 a R18 oflcRp13 a RP13 oflcRp16 a RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string A classificação do vídeo no Peru. Os valores válidos para essa propriedade são: pefilm14 a 14 pefilm18 a 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 a B resorteviolenciaC a C resorteviolenciaD a D resorteviolenciaE a L resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string A classificação da Direção 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 a B rtcB15 a B15 rtcC a C rtcD a D rtcUnrated
contentDetails.contentRating.rteRating	string A classificação do vídeo feita por Raidió Teilifís Éireann da Irlanda. Os valores válidos para essa propriedade são: rteCh – Suíça rteGa – GA rteMa a MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string A classificação no Registro Nacional de Filmes da Federação Russa (MKRF, na sigla em russo) do vídeo. Os valores válidos para esta propriedade são: De russia0 a 0 ou mais De russia12 a mais de 12 anos De russia16 a mais de 16 anos De russia18 a mais de 18 anos De russia6 a 6 anos ou mais russiaUnrated
contentDetails.contentRating.skfilmRating	string A classificação do vídeo na Eslováquia. Os valores válidos para essa propriedade são: skfilmG a G skfilmP2 a P2 skfilmP5 a P5 skfilmP8 a 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 a 12 smais14 a 14 smais16 a 16 smais18 a 18 smais7 a 7 smaisL a G smaisUnrated
contentDetails.contentRating.smsaRating	string A classificação do vídeo feita por Statens medieråd (Conselho Nacional de Mídia da Suécia). Os valores válidos para esta propriedade são: smsa11 a 11 smsa15 a 15 smsa7 a 7 smsaA – Todas as idades smsaUnrated
contentDetails.contentRating.tvpgRating	string A classificação do conteúdo com diretrizes da família para TV (TVPG, na sigla em inglês) do vídeo. Os valores válidos para essa propriedade são: tvpgG – TV-G tvpgMa – TV-MA tvpgPg – TV-PG tvpgUnrated tvpgY – TV-Y tvpgY7 a TV-Y7 tvpgY7Fv – TV-Y7-FV De pg14 a 14 anos
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 esta propriedade são: 360 rectangular
contentDetails.hasCustomThumbnail	boolean Indica se o usuário que fez o envio enviou uma imagem em miniatura personalizada para o vídeo. Esta propriedade só é visível para o usuário que fez o envio do 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. Esta 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. 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. Só é possível defini-la se o status de privacidade do vídeo é privado. O valor é especificado no formato ISO 8601. Observe os dois pontos 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. Se sua solicitação programar a publicação de um vídeo em algum momento no passado, ele será publicado imediatamente. Dessa forma, o efeito de definir a propriedade status.publishAt para uma data e hora anteriores é o mesmo que mudar a privacyStatus do vídeo de private para public.
status.license	string A licença do vídeo. Os valores válidos para esta propriedade são: creativeCommon youtube
status.embeddable	boolean Esse valor indica se o vídeo pode ser incorporado em outro site.
status.publicStatsViewable	boolean Esse valor indica se as estatísticas estendidas do vídeo na página de exibição dele são visíveis publicamente. Por padrão, essas estatísticas são visíveis, e estatísticas como a contagem de visualizações e as notas de um vídeo ainda ficarão visíveis publicamente, mesmo que o valor dessa propriedade seja definido como false.
status.madeForKids	boolean Esse valor indica se o vídeo foi designado como feito para crianças e contém o status atual de conteúdo para crianças. Por exemplo, o status pode ser determinado com base no valor da propriedade selfDeclaredMadeForKids. Acesse a Central de Ajuda do YouTube para mais informações sobre como configurar o público do seu canal, vídeos ou transmissões.
status.selfDeclaredMadeForKids	boolean Em uma solicitação videos.insert ou videos.update, esta propriedade permite que o proprietário do canal designe o vídeo como direcionado a crianças. Em uma solicitação videos.list, o valor da propriedade só é retornado se o proprietário do canal autorizar a solicitação de API.
statistics	object O objeto statistics contém estatísticas sobre o vídeo.
statistics.viewCount	unsigned long O número de vezes que o vídeo foi assistido.
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 passou a ser particular desde 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. Veja 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 está em vigor desde 28 de agosto de 2015. Agora, o valor da propriedade estará sempre definido como 0.
statistics.commentCount	unsigned long O número de comentários do vídeo.
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 que reproduz o vídeo. Se a solicitação de API para extrair o recurso especificar um valor para os parâmetros maxHeight e/ou maxWidth, o tamanho do player incorporado será dimensionado para atender aos requisitos maxHeight e/ou maxWidth. Se a proporção do vídeo for desconhecida, o player incorporado usará o formato 4:3 por padrão.
player.embedHeight	long A altura do player incorporado retornado na propriedade player.embedHtml. Essa propriedade só será retornada se a solicitação tiver especificado 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 retornado na propriedade player.embedHtml. Essa propriedade só será retornada se a solicitação tiver especificado um valor para os parâmetros maxHeight e/ou maxWidth e a proporção do vídeo for 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[], além do histórico de revisões para mais detalhes sobre as próximas mudanças relacionadas aos IDs de tópicos.
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 temas 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. Eles terão suporte até 10 de novembro de 2017. Importante:devido à descontinuação do Freebase e da API Freebase, os IDs de tópico começaram a funcionar de forma 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. Veja os IDs de tópicos compatíveis a partir de 15 de fevereiro de 2017 Tópicos Temas de música /m/04rlf Música (tema principal) /m/02mscn música cristã /m/0ggq0m Música clássica /m/01lyv País /m/02lkt Música eletrônica /m/0glt670 Música hip-hop /m/05rwpb Música independente /m/03_d0 Jazz /m/028sqc Música da Ásia /m/0g293 Música da América Latina /m/064t9 Música pop /m/06cqb Reggae /m/06j6l Ritmo e blues /m/06by7 Rock /m/0gywn Soul Temas de jogos /m/0bzvm2 Jogos (tema principal) /m/025zzc Jogo de ação /m/02ntfj Jogo de ação e aventura /m/0b1vjn Jogo casual /m/02hygl Videogame de música /m/04q1x3q Videogame de lógica /m/01sjng Videogame de corrida /m/0403l3g Videogame de RPG /m/021bp2 Videogame de simulação /m/022dc6 Jogo de esportes /m/03hf_rm Videogame de estratégia Temas de esportes /m/06ntj Esportes (tema pai) /m/0jm_ Futebol americano /m/018jz Beisebol /m/018w8 Basquete /m/01cgz Boxe /m/09xp_ Críquete /m/02vx4 Futebol americano /m/037hz Golfe /m/03tmr Hóquei no gelo /m/01h7lh Artes marciais mistas /m/0410tth Esportes a motor /m/07bs0 Tênis /m/07_53 Vôlei Temas de entretenimento /m/02jjt Entretenimento (tema principal) /m/09kqc Humor /m/02vxn Filmes /m/05qjc Artes cênicas /m/066wd Luta profissional /m/0f2f9 Programas de TV Temas de estilo de vida /m/019_rr Estilo de vida (tema pai) /m/032tl Moda /m/027x7n Fitness /m/02wbm Comida /m/03glg Hobby /m/068hy Animais de estimação /m/041xxh Atratividade física [Beleza] /m/07c1v Tecnologia /m/07bxq Turismo /m/07yv9 Vehicles Temas sociais /m/098wr Sociedade (tema principal) /m/09s1f Empresa /m/0kt51 Saúde /m/01h6rj Militar /m/05qt0 Política /m/06bvp Religião Outros tópicos /m/01k8wb Conhecimento
topicDetails.topicCategories[]	list Uma lista de URLs da Wikipédia com uma descrição detalhada do conteúdo do vídeo.
recordingDetails	object O objeto recordingDetails encapsula informações sobre o local, a data e o endereço onde o vídeo foi gravado.
recordingDetails.locationDescription	string Esta propriedade foi descontinuada em 1o de junho de 2017. Consulte o anúncio de descontinuação para saber mais. O texto de descrição do local onde o vídeo foi gravado.
recordingDetails.location	object 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 ao vídeo. O valor é editável, pesquisável em vídeos públicos e pode ser exibido aos usuários no caso de vídeos públicos.
recordingDetails.location.latitude	double Esta propriedade foi descontinuada em 1o de junho de 2017. Consulte o anúncio de descontinuação para saber mais. Latitude em graus.
recordingDetails.location.longitude	double Esta propriedade foi descontinuada em 1o de junho de 2017. Consulte o anúncio de descontinuação para saber mais. Longitude em graus.
recordingDetails.location.altitude	double Esta propriedade foi descontinuada em 9 de julho de 2018. Consulte o anúncio de descontinuação para saber mais. 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 a resolução, a duração, os codecs de áudio e vídeo e as taxas de bits do stream. 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 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. Atualmente, o YouTube processa apenas arquivos de vídeo, mas esse campo estará presente mesmo se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado. Estes são os valores válidos para esta propriedade: archive: o arquivo é um de arquivamento, como um .zip. audio: o arquivo é um tipo de arquivo de áudio conhecido, como um .mp3. document: é um documento ou arquivo de texto, como um documento do MS Word. image: o arquivo é um arquivo de imagem, como uma imagem .jpeg. other – O arquivo é outro tipo de arquivo não vídeo. project – O arquivo é um arquivo de 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 é um tipo de arquivo de vídeo conhecido, como um .mp4.
fileDetails.container	string O formato do 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 do vídeo codificada em pixels. Você pode 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 do vídeo codificado em pixels.
fileDetails.videoStreams[].frameRateFps	double É o frame rate do stream de vídeo, em quadros por segundo.
fileDetails.videoStreams[].aspectRatio	double A proporção de exibição do conteúdo do vídeo, que especifica a proporção em que o vídeo deve ser mostrado.
fileDetails.videoStreams[].codec	string O codec de vídeo que o stream usa.
fileDetails.videoStreams[].bitrateBps	unsigned long A taxa de bits do stream de vídeo, em bits por segundo.
fileDetails.videoStreams[].rotation	string O valor que o YouTube precisa para alternar o conteúdo original de origem para exibir corretamente o vídeo. Os valores válidos para essa propriedade são: clockwise – O vídeo precisa ser girado em 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 alguma 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 que o stream usa.
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. Atualmente, os seguintes formatos ISO 8601 são suportados: Apenas data: YYYY-MM-DD Tempo simples: 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 desenvolvido para ser pesquisado. Assim, o vídeo enviado pode acompanhar o progresso que o YouTube teve 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 o vídeo ainda está sendo processado. Os valores válidos para esta propriedade são: failed – Falha ao processar o vídeo. Consulte ProcessingFailureReason. processing – O vídeo está sendo processado. Consulte ProcessingProgress. succeeded – O vídeo foi processado com sucesso. terminated – O processamento de informações não está mais disponível.
processingDetails.processingProgress	object O objeto processingProgress contém informações sobre o progresso feito pelo 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 Estimativa do número total de partes que precisam ser processadas no 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. É possível estimar a porcentagem do vídeo que o YouTube já processou calculando: 100 * parts_processed / parts_total Como o número estimado de partes pode aumentar sem um aumento correspondente no número de partes que já foram processadas, é possível que o progresso calculado possa diminuir periodicamente enquanto o YouTube processa um vídeo.
processingDetails.processingProgress.timeLeftMs	unsigned long Estimativa do tempo necessário, em milissegundos, para o YouTube processar o vídeo.
processingDetails.processingFailureReason	string O motivo pelo qual o YouTube não conseguiu processar o vídeo. Essa propriedade só vai ter um valor se o valor da propriedade processingStatus for failed. Os valores válidos para ela são: other: falha em algum outro componente de processamento. streamingFailed – O vídeo não pôde ser enviado aos streamers. transcodeFailed: ocorreu uma 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. Você pode recuperar os detalhes do arquivo de um vídeo solicitando 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. Você pode extrair essas sugestões solicitando a parte suggestions na sua solicitação videos.list().
processingDetails.tagSuggestionsAvailability	string Esse valor indica se as sugestões de palavra-chave (tag) 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. Você pode extrair essas sugestões solicitando 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. Você pode extrair essas sugestões solicitando a parte suggestions na sua solicitação videos.list().
processingDetails.thumbnailsAvailability	string Esse valor indica se imagens em miniatura foram geradas para o vídeo.
suggestions	object O objeto suggestions encapsula sugestões que identificam oportunidades para melhorar a qualidade ou os metadados do vídeo enviado. Esses dados só podem ser recuperados pelo proprietário do vídeo. O objeto suggestions só vai ser retornado se a propriedade processingDetails.tagSuggestionsAvailability ou processingDetails.editorSuggestionsAvailability tiver o valor available.
suggestions.processingErrors[]	list Uma lista de erros que vão impedir que o YouTube processe o vídeo enviado. Esses erros indicam que, no final, independentemente do status de processamento atual do vídeo, esse status provavelmente será failed. Os valores válidos para essa propriedade são: archiveFile: um 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 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 pode 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 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: contêiner e resoluções de stream conflitantes. problematicAudioCodec: foi usado um codec de áudio conhecido por causar problemas. problematicVideoCodec – Foi usado um codec de vídeo conhecido por causar problemas. unknownAudioCodec – Codec de áudio não reconhecido. É provável que ocorra uma falha na transcodificação. unknownContainer – Formato de arquivo não reconhecido. É provável que ocorra uma falha na transcodificação. unknownVideoCodec – Codec de vídeo não reconhecido. É provável que ocorra uma falha na transcodificação.
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. Isso vai deixar o processamento mais lento. sendBestQualityVideo – Provavelmente existe uma versão do vídeo com melhor qualidade.
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 localizarem seu vídeo 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 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 aparece silenciosa e pode ser trocada por outra de melhor qualidade. videoAutoLevels: os níveis de brilho da imagem parecem desregulados e podem ser corrigidos. videoCrop: as margens (foscas) 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, ao vivo ou concluída.
liveStreamingDetails.actualStartTime	datetime A hora em que a transmissão começou. O valor é especificado no formato ISO 8601. Esse valor não estará disponível até o início da transmissão.
liveStreamingDetails.actualEndTime	datetime A hora em que a transmissão realmente terminou. O valor é especificado no formato ISO 8601. Este valor não estará disponível até que a transmissão termine.
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. A propriedade e o valor dela estarão 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 identificaria o número de espectadores que estão assistindo um vídeo arquivado de uma transmissão ao vivo que já terminou. As contagens de espectadores simultâneos que a API YouTube Data retorna podem ser diferentes das contagens de espectadores simultâneos processados e sem spam disponíveis no YouTube Analytics. Saiba mais sobre as métricas de transmissões ao vivo na Central de Ajuda do YouTube.
liveStreamingDetails.activeLiveChatId	string O ID do chat ao vivo ativo anexado a este vídeo. Esse campo só será preenchido se o vídeo for uma transmissão ao vivo com chat ao vivo. Quando as transições de transmissão forem concluídas, esse campo será removido e o chat ao vivo será fechado. No caso de transmissões persistentes, o ID do chat ao vivo não será mais vinculado a esse vídeo, e sim ao novo vídeo exibido na página persistente.
localizations	object O objeto localizations contém traduções dos metadados do vídeo.
localizations.(key)	object O idioma do texto localizado associado à chave-valor. O valor é uma string que contém um código de idioma BCP-47.
localizations.(key).title	string O título do vídeo localizado.
localizations.(key).description	string A descrição localizada do vídeo.