Videos

Um recurso de video representa um vídeo do YouTube.

Métodos

A API suporta 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 de solicitação da API. Faça um teste agora.

insert

Envia um vídeo para o YouTube e, opcionalmente, define os metadados do vídeo.

update

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

delete

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

rate

Adiciona uma classificação gostei ou não gostei a um vídeo ou remove uma classificação de um vídeo. Faça um teste agora.

Representação de recurso

A estrutura JSON abaixo 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
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "mpaaRating": string,
      "tvpgRating": string,
      "bbfcRating": string,
      "chvrsRating": string,
      "eirinRating": string,
      "cbfcRating": string,
      "fmocRating": string,
      "icaaRating": string,
      "acbRating": string,
      "oflcRating": string,
      "fskRating": string,
      "kmrbRating": string,
      "djctqRating": string,
      "russiaRating": string,
      "rtcRating": string,
      "ytRating": string
    }
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean
  },
  "statistics": {
    "viewCount": unsigned long,
    "likeCount": unsigned long,
    "dislikeCount": unsigned long,
    "favoriteCount": unsigned long,
    "commentCount": unsigned long
  },
  "player": {
    "embedHtml": string
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ]
  },
  "recordingDetails": {
    "locationDescription": string,
    "location": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "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,
    "recordingLocation": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "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
    ]
  }
}

Propriedades

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

Propriedades
kind	string 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.
snippet	object O objeto snippet contém detalhes básicos sobre o vídeo, como seu título, sua descrição e sua categoria.
snippet.publishedAt	datetime A data e a hora em que o vídeo foi enviado. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId	string O ID que o YouTube usa para identificar de forma exclusiva o canal ao qual o vídeo foi enviado.
snippet.title	string O título do vídeo.
snippet.description	string A descrição do vídeo.
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 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.
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 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. Este campo só é visível para o usuário que faz upload do vídeo.
snippet.categoryId	string A categoria de vídeo do YouTube associada ao vídeo.
contentDetails	object O objeto contentDetails contém informações sobre o conteúdo do vídeo, incluindo sua duração e proporção.
contentDetails.duration	string A duração do vídeo. O valor da tag é uma duração ISO 8601 no formato PT#M#S, onde as letras PT indicam que o valor especifica um período e M e S se referem à duração em minutos em segundos, respectivamente. Os caracteres # que precedem as letras M e S são inteiros que especificam o número de minutos (ou segundos) do vídeo. Por exemplo, um valor PT15M51S indica que o vídeo tem 15 minutos e 51 segundos de duração.
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 esta 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 esta propriedade são: false true
contentDetails.licensedContent	boolean Indica se o vídeo representa um conteúdo licenciado, o que significa que o conteúdo foi reivindicado por um parceiro de conteúdo do YouTube.
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 conterá a propriedade contentDetails.regionRestriction.allowed ou contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[]	list A lista de códigos de região que identificam os países onde o vídeo é visível. 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 A lista de códigos de região que identificam os países onde 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.mpaaRating	string A classificação da Motion Picture Association of America (MPAA) de vídeos. Os valores válidos para esta propriedade são: mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.tvpgRating	string A classificação de Orientação dos pais para a televisão (TVPG, na sigla em inglês) de vídeos. Os valores válidos para esta propriedade são: tvpg14 – TV-14 tvpgG – TV-G tvpgMa – TV-MA tvpgPg – TV-PG tvpgUnrated tvpgY – TV-Y tvpgY7 – TV-Y7 tvpgY7Fv – TV-Y7-FV
contentDetails.contentRating.bbfcRating	string A classificação do British Board of Film Classification (BBFC) de vídeos. Os valores válidos para esta propriedade são: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.chvrsRating	string A classificação do Sistema Canadense de Classificação de Vídeos Caseiros (CHVRS, na sigla em inglês) de vídeos. Os valores válidos para esta propriedade são: chvrs14a – 14A chvrs18a – 18A chvrsE – E chvrsG – G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.eirinRating	string A classificação do Eirin (映倫) de vídeos. O Eirin é o sistema de classificação japonês. Os valores válidos para esta propriedade são: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.cbfcRating	string A classificação da Junta Central de Certificação de Filmes (CBFC, na sigla em inglês - Índia) de vídeos. Os valores válidos para esta propriedade são: cbfcA – A cbfcS – S cbfcU – U cbfcUA – U/A cbfcUnrated
contentDetails.contentRating.fmocRating	string A classificação do Centre national du cinéma et de l'image animé (Ministério da Cultura da França) de vídeos. Os valores válidos para esta propriedade são: fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.icaaRating	string A classificação do Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Espanha) de vídeos. Os valores válidos para esta propriedade são: icaa12 – 12 icaa13 – 13 icaa16 – 16 icaa18 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX – X
contentDetails.contentRating.acbRating	string A classificação do Conselho de Classificação da Austrália (ACB, na sigla em inglês) de vídeos. Os valores válidos para esta propriedade são: acbE – E acbG – G acbM – M acbMa15plus – MA15+ acbPg – PG acbR18plus – R18+ acbUnrated
contentDetails.contentRating.oflcRating	string A classificação do Office of Film and Literature Classification (OFLC - Nova Zelândia) de vídeos. Os valores válidos para esta propriedade são: oflcG – G oflcM – M oflcPg – PG oflcR13 – R13 oflcR15 – R15 oflcR16 – R16 oflcR18 – R18 oflcUnrated
contentDetails.contentRating.fskRating	string A classificação do Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Alemanha) de vídeos. Os valores válidos para esta propriedade são: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.kmrbRating	string A classificação da Avaliação de Plataforma de Média da Coreia (영상물등급위원회) de vídeos. A KMRB (na sigla em inglês) classifica vídeos na Coréia do Sul. Os valores válidos para esta propriedade são: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.djctqRating	string A classificação do Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil) de vídeos. Os valores válidos para esta propriedade são: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.russiaRating	string A classificação Registro Nacional de Filmes da Federação Russa (MKRF, na sigla em russo - Rússia) de vídeos. Os valores válidos para esta propriedade são: russia0 – 0+ russia12 – 12+ russia16 – 16+ russia18 – 18+ russia6 – 6+ russiaUnrated
contentDetails.contentRating.rtcRating	string A classificação da Direção Geral de Rádio, Televisão e Cinematografia (México) de vídeos. Os valores válidos para esta propriedade são: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
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 esta propriedade são: ytAgeRestricted
status	object O objeto status contém informações sobre o envio, processamento e status de privacidade do vídeo.
status.uploadStatus	string O status do vídeo enviado. Os valores válidos para esta propriedade são: deleted failed processed rejected uploaded
status.failureReason	string Este valor explica por que um vídeo não conseguiu ser enviado. Esta propriedade só estará presente se a propriedade uploadStatus indicar que o envio falhou. Os valores válidos para esta propriedade são: codec conversion emptyFile invalidFile tooSmall uploadAborted
status.rejectionReason	string Este valor explica por que o YouTube rejeitou um vídeo enviado. Esta propriedade só estará presente se a propriedade uploadStatus indicar que o envio foi rejeitado. Os valores válidos para esta propriedade são: claim copyright duplicate inappropriate length termsOfUse trademark uploaderAccountClosed uploaderAccountSuspended
status.privacyStatus	string Status de privacidade do vídeo. Os valores válidos para esta propriedade são: private public unlisted
status.license	string A licença do vídeo. Os valores válidos para esta propriedade são: creativeCommon youtube
status.embeddable	boolean Este valor indica se o vídeo pode ser incorporado em outro website.
status.publicStatsViewable	boolean Este valor indica se as estatísticas estendidas do vídeo da página de exibição do vídeo 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 classificações de um vídeo continuarão visíveis publicamente, mesmo que o valor dessa propriedade seja definido como false.
statistics	object O objeto statistics contém estatísticas sobre o vídeo.
statistics.viewCount	unsigned long A quantidade de visualizações do vídeo.
statistics.likeCount	unsigned long A quantidade de usuários que indicaram ter gostado do vídeo concedendo uma avaliação positiva.
statistics.dislikeCount	unsigned long A quantidade de usuários que indicou não ter gostado do vídeo concedendo uma classificação negativa.
statistics.favoriteCount	unsigned long A quantidade de usuários que marcou o vídeo como favorito no momento.
statistics.commentCount	unsigned long A quantidade de comentários do vídeo.
player	object O objeto player contém informações que você deve usar para reproduzir o vídeo em um player integrado.
player.embedHtml	string Uma tag <iframe> que incorpora um player que reproduzirá o vídeo.
topicDetails	object O objeto topicDetails encapsula informações sobre tópicos Freebase associados ao vídeo.
topicDetails.topicIds[]	list A lista de IDs de tópicos Freebase que estão centralmente associados ao vídeo. Esses são tópicos em destaque central no vídeo. Pode-se dizer que o vídeo se trata principalmente sobre cada uma deles. Você pode recuperar informações sobre cada tópico usando a API de tópicos Freebase.
topicDetails.relevantTopicIds[]	list Semelhante a topic_id, exceto pelo fato de que esses tópicos são meramente relevantes para o vídeo. Esses são tópicos que podem ser mencionados ou aparecer no vídeo. Você pode recuperar informações sobre cada tópico usando a API de tópicos Freebase.
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 O texto de descrição do local onde o vídeo foi gravado.
recordingDetails.location	object As informações de localização geográfica associadas ao vídeo.
recordingDetails.location.latitude	double Latitude em graus.
recordingDetails.location.longitude	double Longitude em graus.
recordingDetails.location.altitude	double 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.sZ).
fileDetails	object O objeto fileDetails encapsula informações sobre o arquivo de vídeo que foi enviado para o YouTube, incluindo a resolução, a duração, o áudio e os codecs de vídeo do arquivo, as taxas de bits do fluxo, entre outros. Esses dados só podem ser recuperados pelo proprietário do vídeo.
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ídeos do YouTube. Atualmente, o YouTube só processa arquivos de vídeo, mas esse campo estará presente se um arquivo de vídeo ou outro tipo de arquivo tiver sido enviado. Os valores válidos para esta propriedade são: archive – O arquivo é um de arquivamento, como um .zip. audio – O arquivo é um tipo de arquivo de áudio conhecido, como um .mp3. document – O arquivo é documento ou arquivo de texto, como um documento do MS Word. image – O arquivo é um 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 vídeo conhecido, como um .mp4.
fileDetails.container	string O formato do contêiner do arquivo de vídeo enviado.
fileDetails.videoStreams[]	list A 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 codificada 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 exibido.
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 rodar o conteúdo original da origem para exibir corretamente o vídeo. Os valores válidos para esta propriedade são: clockwise – O vídeo precisa ser girado em 90 graus no sentido horário. counterClockwise – O vídeo precisa ser girado em 90 graus 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 de forma exclusiva um fornecedor de vídeo. Normalmente, o valor é um código de fornecedor de quatro letras.
fileDetails.audioStreams[]	list A 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 A quantidade de canais de áudio que o stream contém.
fileDetails.audioStreams[].codec	string O codec de áudio que o stream utiliza.
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 de forma exclusiva 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.recordingLocation	object Coordenadas geográficas que identificam o local onde o vídeo enviado foi gravado. As coordenadas são definidas usando WGS 84.
fileDetails.recordingLocation.latitude	double Latitude em graus.
fileDetails.recordingLocation.longitude	double Longitude em graus.
fileDetails.recordingLocation.altitude	double Altitude acima do elipsoide de referência, em metros.
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 Tempo com fuso horário: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object O objeto processingProgress 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 para que o vídeo enviado possa 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. Este 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 no processamento do vídeo. Consulte ProcessingFailureReason. processing – O vídeo está sendo processado no momento. 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 andamento que o YouTube teve no processamento do vídeo. Os valores são realmente relevantes apenas se o status de processamento do vídeo for processing.
processingDetails.processingProgress.partsTotal	unsigned long Uma estimativa da quantidade 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 A quantidade de partes do vídeo que o YouTube já processou. Você pode estimar a porcentagem do vídeo que o YouTube já processou calculando: 100 * parts_processed / parts_total Como a estimativa da quantidade de partes pode aumentar sem um aumento correspondente de sua quantidade já processada, é possível que o andamento calculado possa diminuir 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 o processamento do vídeo.
processingDetails.processingFailureReason	string O motivo pelo qual o YouTube falhou ao processar o vídeo. Esta propriedade só terá um valor se o valor da propriedade processingStatus for failed. Os valores válidos para esta propriedade são: other – Falha em algum outro componente de processamento. streamingFailed – O vídeo não pôde ser enviado aos streamers. transcodeFailed – Falha na transcodificação do conteúdo. uploadFailed – Falha na entrega do arquivo.
processingDetails.fileDetailsAvailability	string Este valor indica se os detalhes do arquivo estão disponíveis para o vídeo enviado. Você pode recuperar os detalhes de um arquivo de vídeo solicitando a parte fileDetails em sua solicitação videos.list().
processingDetails.processingIssuesAvailability	string Este valor indica se o mecanismo de processamento de vídeos gerou sugestões que possam melhorar a capacidade do YouTube de processar o vídeo, avisos que explicam os problemas de processamento do vídeo ou erros que causam problemas de processamento do vídeo. Você pode recuperar essas sugestões, solicitando a parte suggestions em sua solicitação videos.list().
processingDetails.tagSuggestionsAvailability	string Este 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 recuperar essas sugestões, solicitando a parte suggestions em sua solicitação videos.list().
processingDetails.editorSuggestionsAvailability	string Este 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 recuperar essas sugestões, solicitando a parte suggestions em sua solicitação videos.list().
processingDetails.thumbnailsAvailability	string Este 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 para o vídeo enviado. Esses dados só podem ser recuperados pelo proprietário do vídeo.
suggestions.processingErrors[]	list A lista de erros que impedirão que o YouTube processe o vídeo enviado. Esses erros indicam que, no final, independentemente do status de processamento atual do vídeo, o status será certamente failed. Os valores válidos para esta propriedade são: archiveFile – Um arquivo de arquivamento (por exemplo, um arquivo ZIP). audioFile – Um arquivo que contenha 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 não 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 em transcodificar o vídeo enviado ou que possa resultar em uma transcodificação errônea. 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 necessariamente indicam que o processamento do vídeo falhará, mas que ele pode causar problemas, como de sincronização, artefatos de vídeo ou uma faixa de áudio em falta. Os valores válidos para esta propriedade são: hasEditlist – Edita listas não suportadas no momento. inconsistentResolution – Recipiente e resoluções de stream conflitantes. problematicAudioCodec – Codec de áudio conhecido por causar problemas foi usado. problematicVideoCodec – Codec de vídeo conhecido por causar problemas foi usado. unknownAudioCodec – Codec de áudio desconhecido. É provável que haja falha na transcodificação. unknownContainer – Formato de arquivo desconhecido. É provável que haja falha na transcodificação. unknownVideoCodec – Codec de vídeo desconhecido. É provável que haja falha na transcodificação.
suggestions.processingHints[]	list A lista de sugestões que podem melhorar a capacidade do YouTube de processar o vídeo. Os valores válidos para esta propriedade são: nonStreamableMov – O arquivo MP4 não é passível de stream. Isso retardará o processamento. sendBestQualityVideo – Provavelmente há uma versão de melhor qualidade do vídeo.
suggestions.tagSuggestions[]	list A 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 A 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 esta propriedade são: audioQuietAudioSwap – A faixa de áudio aparece silenciosa e pode ser trocada por uma de melhor qualidade. videoAutoLevels – Os níveis de brilho da imagem parecem desregulados e podem ser corrigidos. videoCrop – As margens (foscas) detectadas em torno da imagem podem ser cortadas. videoStabilize – O vídeo parece frágil e pode ser estabilizado.