Observação:o artigo Como obedecer às Políticas para desenvolvedores do YouTube fornece orientações e exemplos para ajudar você a garantir que seus clientes de API sigam partes específicas dos Termos e das Políticas (TOS) dos serviços de APIs do YouTube. O guia oferece informações sobre como o YouTube aplica certos aspectos dos TOS da API, 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 de serviços de API do YouTube ("Clientes de API").
Esses requisitos e diretrizes garantem que os clientes de API proporcionem uma experiência de usuário consistente, protegendo os interesses dos usuários, proprietários de conteúdo e anunciantes do YouTube. Essas regras fazem parte dos Termos de Serviço da API do YouTube e precisam ser seguidas no desenvolvimento e na implementação dos Clientes da API.
Os requisitos deste documento vão mudar para que possamos garantir experiências melhores aos usuários com os recursos atuais do YouTube. Eles também mudarão em resposta a recursos novos e atualizados do YouTube. Às vezes, essas mudanças podem exigir que você atualize seus clientes de API para atender aos novos requisitos. O histórico de revisões dos Termos de Serviço documenta todas as alterações. Por isso, verifique esse documento com frequência ou inscreva-se no feed RSS correspondente para ficar sabendo rapidamente das alterações que podem afetar seus clientes da API.
Além dos requisitos descritos neste documento, recomendamos que você siga as práticas recomendadas descritas nas Políticas dos serviços da API do YouTube, conforme mencionado em outras seções da documentação sobre os serviços da API do YouTube. Mesmo que não sejam estritamente necessárias, essas práticas ajudam seus clientes de API a se recuperarem mais rapidamente dos erros e a otimizar o uso de cotas caso usem serviços de API do YouTube que aloquem cotas. Ao mesmo tempo, essas práticas ajudam a garantir a integridade do ecossistema do YouTube e, acima de tudo, a proporcionar a melhor experiência possível aos usuários dos seus Clientes de API e dos Aplicativos do YouTube.
Player incorporado do YouTube e reprodução de vídeo
Os requisitos nesta seção são relacionados especificamente aos players incorporados do YouTube. As Políticas dos serviços da API do YouTube também incluem várias políticas relevantes para clientes da API que reproduzem conteúdo audiovisual do YouTube.
Tamanho do player do YouTube incorporado
É 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ções automáticas 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 de player autoplay ou iniciam programaticamente a reprodução automática usando o serviço da API do Player do IFrame do YouTube, o serviço da API do Player do YouTube para Android ou outro serviço da API do YouTube.
-
Os players incorporados que reproduzem um vídeo automaticamente devem iniciar a reprodução assim que a página é carregada ou assim que o player incorporado fica totalmente visível. No entanto, um cliente de API não deve 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 simultaneamente.
-
Qualquer miniatura do YouTube que inicia uma reprodução deve ter pelo menos 120 pixels de largura e 70 pixels de altura.
Atributos do player do YouTube
Os atributos e os parâmetros do player do YouTube, incluindo, por exemplo, a aparência da marca do YouTube no player, são especificados na documentação e especificações da API do YouTube (https://developers.google.com/youtube). Não é permitido fazer alterações no player do YouTube que não sejam explicitamente descritas na documentação da API.
Sobreposições e frames
Não é permitido mostrar sobreposições, frames ou outros elementos visuais em frente a qualquer parte de um player incorporado do YouTube, incluindo os controles do player. Da mesma forma, não é permitido usar sobreposições, molduras ou outros elementos visuais para ocultar qualquer parte do player incorporado, incluindo os controles do player.
Movimentações do mouse
Não é permitido usar eventos de mouseover 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 enviem conteúdo para várias plataformas, os usuários devem poder marcar e desmarcar as plataformas nas quais desejam enviar seus vídeos.
Requisitos de dados
Os clientes de API que permitem aos usuários fazer upload de vídeos para o YouTube precisam habilitar users para definir os valores da lista a seguir. As propriedades não listadas são opcionais.
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.title |
Obrigatório. O título do vídeo. O YouTube 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 retorna um erro quando o valor ultrapassa 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 do conteúdo e o parâmetro onBehalfOfContentOwner estiver definido, o usuário da API também deverá ser capaz de especificar o canal do YouTube para o qual o vídeo será 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) exibir o texto completo de um comentário ou resposta de um comentário ou (b) truncar o texto e oferecer ao usuário uma maneira de 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 a que os comentários estão associados (vídeos, canais etc.). O valor da propriedade snippet.topLevelComment do recurso commentThread é um recurso comment, e o replies.comments[] é um recurso comment. Como tal, 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 pertencer a um vídeo. | |
snippet.moderationStatus |
Obrigatório sob certas condições. Se o valor do parâmetro moderationStatus na solicitação de API for heldForReview ou likelySpam, a exibição vai precisar identificar claramente esse status usando o valor da propriedade, uma linguagem semelhante (por exemplo, "Este comentário está sendo retido para análise"), um cabeçalho (por exemplo, "Retido para análise") ou outra linguagem não ambígua. O método commentThreads.list permite a recuperação de comentários com base no status de moderação. |
|
Como adicionar comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades do 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 deverá exibir o título do vídeo. | |
| Outros requisitos | ||
Comment author's channel name |
Obrigatório. O cliente da API deve identificar claramente a conta de usuário do YouTube à qual o comentário será atribuído. Se as credenciais de autorização da solicitação identificarem um proprietário do conteúdo e o parâmetro onBehalfOfContentOwner estiver definido, o usuário da API também deverá conseguir especificar o canal do YouTube ao qual o comentário será atribuído. |
|
Adicionando respostas aos comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.textDisplay |
Obrigatório. O texto do comentário. O cliente da API precisa exibir o texto do comentário ao qual 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 deverá exibir 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 à qual a resposta do comentário será atribuída. Se as credenciais de autorização da solicitação identificarem um proprietário do conteúdo e o parâmetro onBehalfOfContentOwner estiver definido, o usuário da API também deverá ser capaz de especificar o canal do YouTube ao qual a resposta do comentário será atribuída. |
|
Editar ou excluir respostas de comentários
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.textDisplay |
Obrigatório. O texto do comentário. O cliente da API precisa exibir o texto do comentário que o usuário está editando ou excluindo 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 editando ou excluindo um comentário sobre um vídeo, o cliente da API deverá exibir o título do vídeo. | |
| Outros requisitos | ||
Comment author's channel name |
Obrigatório. O cliente da API deve identificar claramente a conta de usuário do YouTube à qual o comentário é atribuído. | |
Banir um usuário do chat ao vivo (ou remover o banimento)
| Nome | Descrição | |
|---|---|---|
| Propriedades do recurso | ||
snippet.title( channel) |
Obrigatório. O nome do canal do YouTube que foi banido ou cancelado. 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. | |