Observação:o cumprimento das políticas para desenvolvedores do YouTube oferece orientações e exemplos para garantir que seus clientes de API sigam partes específicas dos Termos e Políticas (TOS da API) dos serviços de API do YouTube. O guia oferece informações sobre como o YouTube aplica determinados aspectos dos TOS das APIs, mas não substitui nenhum documento existente.
Este documento define os requisitos funcionais mínimos para clientes de API que implementam ou fornecem acesso a recursos específicos dos serviços de API do YouTube ("clientes de API").
Esses requisitos e diretrizes garantem que os clientes da API ofereçam uma experiência de usuário consistente que proteja os interesses dos usuários do YouTube, proprietários de conteúdo e anunciantes. Essas regras são parte integrante dos Termos de Serviço da API do YouTube e precisam ser seguidas no desenvolvimento e na implementação de qualquer cliente da API.
Os requisitos deste documento podem mudar para garantir uma melhor experiência do usuário com os recursos atuais do YouTube. Elas também vão mudar de acordo com os recursos novos e atualizados do YouTube. Às vezes, essas mudanças podem exigir que você atualize os clientes de API para atender a novos requisitos. O histórico de revisões dos Termos de Serviço vai documentar todas as mudanças. Por isso, verifique esse documento com frequência ou assine o feed RSS para saber rapidamente sobre as mudanças que podem afetar seus clientes de API.
Além dos requisitos deste documento, recomendamos que você siga as práticas recomendadas descritas nas Políticas dos serviços de API do YouTube e em outros lugares na documentação dos serviços de API do YouTube. Mesmo quando não são estritamente necessárias, essas práticas ajudam os clientes de API a se recuperar mais rapidamente dos erros e a otimizar o uso da cota se eles usam serviços da API do YouTube que alocam a cota. Ao mesmo tempo, essas práticas ajudam a garantir a integridade do ecossistema do YouTube e, acima de tudo, a oferecer a melhor experiência possível aos usuários dos clientes de API e dos aplicativos do YouTube.
Player incorporado do YouTube e reprodução de vídeo
Os requisitos desta seção se referem especificamente aos players do YouTube incorporados. As políticas dos serviços de API do YouTube também incluem várias políticas relevantes para clientes de API que reproduzem conteúdo audiovisual do YouTube.
Tamanho do player incorporado do YouTube
É necessário que os players incorporados tenham uma Janela de visualização de pelo menos 200 px por 200 px. Se o player mostra controles, ele tem que ser grande o suficiente para exibir completamente os controles sem encolher a Janela visualização abaixo do tamanho mínimo. Recomendamos que players de 16:9 tenham pelo menos 480 pixels de largura e 270 pixels de altura.
Reprodução automática e com script
Esta seção aborda as reproduções automáticas. Ela se aplica aos players incorporados do YouTube que usam o parâmetro do player autoplay ou iniciam a reprodução automática de forma programática usando o serviço da API IFrame Player do YouTube ou outro serviço da API do YouTube.
-
Os players incorporados que reproduzem um vídeo automaticamente precisam iniciar a reprodução imediatamente quando a página é carregada ou assim que o player incorporado fica totalmente visível. No entanto, um cliente da API não pode iniciar uma reprodução automática até que o player esteja visível e mais da metade dele esteja visível na página ou tela.
-
Uma página ou tela não pode ter mais de um player do YouTube que reproduz conteúdo automaticamente ao mesmo tempo.
-
Qualquer miniatura do YouTube que inicia uma reprodução precisa ter pelo menos 120 pixels de largura e 70 pixels de altura.
Atributos do player do YouTube
Os atributos e parâmetros do player do YouTube, incluindo a aparência da marca do YouTube no player, são especificados na documentação e nas especificações da API do YouTube (https://developers.google.com/youtube). Não faça mudanças no player do YouTube que não sejam descritas explicitamente pela documentação da API.
Sobreposições e frames
Não é permitido mostrar sobreposições, frames ou outros elementos visuais na frente de qualquer parte de um player incorporado do YouTube, incluindo os controles do player. Da mesma forma, não use sobreposições, frames ou outros elementos visuais para ocultar qualquer parte de um player incorporado, incluindo os controles do player.
Movimentações do mouse
Não use eventos de passagem do cursor ou toque em um player do YouTube para iniciar qualquer ação em nome do usuário, como abrir uma janela ou se inscrever em um canal.
Como enviar vídeos
Se os clientes de API permitirem que os usuários façam upload de conteúdo para várias plataformas, eles poderão selecionar e desmarcar as plataformas para as quais querem enviar os vídeos.
Requisitos de dados
Os clientes de API que permitem que os usuários enviem vídeos para o YouTube precisam permitir que os usuários definam os valores na lista a seguir. Todas as propriedades que não estiverem listadas são opcionais.
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.title |
Obrigatório. O título do vídeo. O YouTube vai retornar um erro se o valor exceder 100 caracteres. O YouTube aceita todos os caracteres UTF-8 válidos, exceto < e >.
| |
snippet.description |
Obrigatório. A descrição do vídeo. O YouTube vai retornar um erro se o valor exceder 5.000 bytes. O YouTube aceita todos os caracteres UTF-8 válidos, exceto < e >. |
|
status.privacyStatus |
Obrigatório. A configuração de privacidade do vídeo. Os usuários precisam poder escolher se o vídeo enviado será público, privado ou não listado. | |
| Parâmetros de solicitação | ||
onBehalfOfContentOwnerChannel |
Obrigatório sob certas condições. Se as credenciais de autorização da solicitação identificarem um proprietário de conteúdo e o parâmetro onBehalfOfContentOwner estiver definido, o usuário da API também precisará especificar o canal do YouTube para o qual o vídeo está sendo enviado. |
|
Como mostrar comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.textDisplay |
Obrigatório. O texto do comentário. O cliente da API precisa (a) mostrar o texto completo de um comentário ou resposta a um comentário ou (b) truncar o texto e oferecer uma maneira de o espectador acessar facilmente o texto completo da versão truncada. Esse requisito se aplica a todos os comentários e respostas a comentários, independentemente do tipo de recurso associado a eles (vídeos, canais etc.). O valor da propriedade snippet.topLevelComment do recurso commentThread é um recurso comment, e a propriedade replies.comments[] é uma lista de recursos comment. Portanto, esse requisito também se aplica às propriedades snippet.topLevelComment.snippet.textDisplay e replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Obrigatório (sugestão). O título do canal.
|
|
snippet.title( video) |
Obrigatório sob certas condições (sugestão). O título do vídeo. Esse valor precisa ser exibido se o comentário estiver relacionado a um vídeo. | |
snippet.moderationStatus |
Obrigatório sob certas condições. Se o valor do parâmetro moderationStatus na solicitação da API for heldForReview ou likelySpam, a exibição precisará identificar claramente esse status usando o valor da propriedade, uma linguagem semelhante (por exemplo, "Este comentário está sendo retido para revisão"), um cabeçalho (por exemplo, "Retido para revisão") ou outra linguagem inequívoca. O método commentThreads.list oferece suporte à capacidade de recuperar comentários com base no status de moderação. |
|
Como adicionar comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades de recurso | ||
snippet.title( channel) |
Obrigatório. O título do canal.
|
|
snippet.title( video) |
Obrigatório. Se o usuário estiver adicionando um comentário sobre um vídeo, o cliente da API precisará mostrar o título do vídeo. | |
| Outros requisitos | ||
Comment author's channel name |
Obrigatório. O cliente da API precisa identificar claramente a conta de usuário do YouTube a que o comentário será atribuído. Se as credenciais de autorização da solicitação identificarem um proprietário de conteúdo e o parâmetro onBehalfOfContentOwner estiver definido, o usuário da API também precisará especificar o canal do YouTube a que o comentário será atribuído. |
|
Como adicionar respostas a comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.textDisplay |
Obrigatório. O texto do comentário. O cliente da API precisa mostrar o texto do comentário que o usuário está respondendo de acordo com as regras definidas na seção Exibição de comentários deste documento. | |
snippet.title( channel) |
Obrigatório. O título do canal.
|
|
snippet.title( video) |
Obrigatório. Se o usuário estiver respondendo a um comentário sobre um vídeo, o cliente da API precisará mostrar o título do vídeo. | |
| Outros requisitos | ||
Comment author's channel name |
Obrigatório. O cliente da API precisa identificar claramente a conta de usuário do YouTube a que a resposta do comentário será atribuída. Se as credenciais de autorização da solicitação identificarem um proprietário de conteúdo e o parâmetro onBehalfOfContentOwner estiver definido, o usuário da API também precisará especificar o canal do YouTube a que a resposta do comentário será atribuída. |
|
Editar ou excluir respostas a comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.textDisplay |
Obrigatório. O texto do comentário. O cliente da API precisa mostrar o texto do comentário que o usuário está editando ou excluindo de acordo com as regras definidas na seção Exibir comentários deste documento. | |
snippet.title( channel) |
Obrigatório. O título do canal.
|
|
snippet.title( video) |
Obrigatório. Se o usuário estiver editando ou excluindo um comentário sobre um vídeo, o cliente da API precisará mostrar o título do vídeo. | |
| Outros requisitos | ||
Comment author's channel name |
Obrigatório. O cliente da API precisa identificar claramente a conta de usuário do YouTube atribuída ao comentário. | |
Banir um usuário do chat ao vivo (ou remover uma proibição)
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.title( channel) |
Obrigatório. O nome do canal do YouTube que está sendo banido ou desbanido. Além disso, o nome precisa estar vinculado ao canal ou o URL do canal também precisa ser exibido. | |
| Outros requisitos | ||
| Nome do canal do autor do comentário | Obrigatório. O cliente da API precisa identificar claramente a conta de usuário do YouTube que está sendo usada para adicionar ou remover a proibição. | |