YouTube

Consultar e administrar vídeos, canais e playlists do YouTube.

Integrações e ferramentasComunicaçãoConexão: Credencial protegida

O que faz

Integre o YouTube ao fluxo. Busque vídeos e obtenha os vídeos em alta, os detalhes e as categorias de vídeos, as informações de um canal, todos os vídeos de um canal, as playlists de um canal, os itens de uma playlist e os comentários de um vídeo.

Quando usar: Use quando o seu fluxo precisar consultar e administrar vídeos, canais e playlists do YouTube.

Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

Adicione YouTube ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
Escolha a operação. O painel mostra só os campos que essa operação usa.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Operações

Operação	O que faz
Buscar vídeos	Busca vídeos com o bloco YouTube.
Obter vídeos em alta	Obtém vídeos em alta com o bloco YouTube.
Obter detalhes do vídeo	Obtém detalhes do vídeo com o bloco YouTube.
Obter categorias de vídeo	Obtém categorias de vídeo com o bloco YouTube.
Obter informações do canal	Obtém informações do canal com o bloco YouTube.
Obter vídeos do canal	Obtém vídeos do canal com o bloco YouTube.
Obter playlists do canal	Obtém playlists do canal com o bloco YouTube.
Obter itens da playlist	Obtém itens da playlist com o bloco YouTube.
Obter comentários do vídeo	Obtém comentários do vídeo com o bloco YouTube.

Campos

Mostrar campos de

Operação
Escolhe qual ação este bloco executará.
Opções:
Buscar vídeos · Obter vídeos em alta · Obter detalhes do vídeo · Obter categorias de vídeo · Obter informações do canal · Obter vídeos do canal · Obter playlists do canal · Obter itens da playlist · Obter comentários do vídeo
Padrão:
Buscar vídeos
Consulta de busca
Obrigatório conforme a operação
Informa a consulta usada para localizar ou transformar dados.
Aparece em:
Buscar vídeos
Exemplo:
SELECT * FROM clientes WHERE status = 'ativo'
Máximo de resultados
Em campos adicionais
Define um valor numérico, quantidade ou limite da operação.
Aparece em:
Buscar vídeos
Exemplo:
10
Token da página
Em campos adicionais
Token de paginação (vindo de nextPageToken).
Aparece em:
Buscar vídeos
Exemplo:
Token de paginação (vindo de nextPageToken)
Filtrar por ID do canal
Em campos adicionais
Filtre os resultados de um canal específico.
Aparece em:
Buscar vídeos
Exemplo:
id-do-recurso
Filtro de transmissão ao vivo
Em campos adicionais
Escolhe uma das opções aceitas por este campo.
Aparece em:
Buscar vídeos
Opções:
Todos os vídeos · Ao vivo agora · Transmissões programadas · Transmissões encerradas
Exemplo:
Todos os vídeos
Publicado depois de
Em campos adicionais
Mostra só vídeos publicados depois desta data e hora, no formato ISO 8601 em UTC (ex.: 2025-01-01T00:00:00Z).
Aparece em:
Buscar vídeos
Exemplo:
2024-01-01T00:00:00Z
Publicado antes de
Em campos adicionais
Mostra só vídeos publicados antes desta data e hora, no formato ISO 8601 em UTC (ex.: 2025-12-31T23:59:59Z).
Aparece em:
Buscar vídeos
Exemplo:
2024-12-31T23:59:59Z
Duração do vídeo
Em campos adicionais
Escolhe uma das opções aceitas por este campo.
Aparece em:
Buscar vídeos
Opções:
Qualquer · Curto (<4 min) · Médio (4-20 min) · Longo (>20 min)
Padrão:
Qualquer
Ordem
Em campos adicionais
Escolhe uma das opções aceitas por este campo.
Aparece em:
Buscar vídeos
Opções:
Relevância · Data (mais recentes primeiro) · Visualizações · Avaliação · Título
Padrão:
Relevância
ID da categoria
Em campos adicionais
Use "Obter categorias de vídeo" para encontrar os IDs.
Aparece em:
Buscar vídeos
Exemplo:
id-do-recurso
Qualidade do vídeo
Em campos adicionais
Escolhe uma das opções aceitas por este campo.
Aparece em:
Buscar vídeos
Opções:
Qualquer · HD · Padrão
Padrão:
Qualquer
Legendas
Em campos adicionais
Informa o conteúdo de texto que será enviado ou processado.
Aparece em:
Buscar vídeos
Opções:
Qualquer · Com legendas · Sem legendas
Padrão:
Qualquer
Código da região
Em campos adicionais
País de referência, em código de duas letras (ex.: BR): direciona a busca e define de qual país vêm os vídeos em alta e as categorias.
Aparece em:
Buscar vídeos, Obter vídeos em alta, Obter categorias de vídeo
Exemplo:
US, GB, JP
Código do idioma
Em campos adicionais
Dá preferência a vídeos mais relevantes para um idioma, em código de duas letras (ex.: pt); vídeos em outros idiomas ainda podem aparecer.
Aparece em:
Buscar vídeos
Exemplo:
pt-BR
Pesquisa segura
Em campos adicionais
Define a consulta ou o filtro aplicado aos dados.
Aparece em:
Buscar vídeos
Opções:
Moderada · Nenhum · Rigorosa
Padrão:
Moderada
ID do vídeo
Obrigatório conforme a operação
Informe o ID do vídeo do YouTube.
Aparece em:
Obter detalhes do vídeo
Exemplo:
id-do-recurso
Idioma
Em campos adicionais
Idioma em que os nomes das categorias de vídeo do YouTube serão devolvidos, em código de idioma (ex.: pt).
Aparece em:
Obter categorias de vídeo
Exemplo:
en, es, fr (para os nomes das categorias)
Nome de usuário do canal
Informe o nome de usuário do canal (se não usar o ID do canal).
Aparece em:
Obter informações do canal
Exemplo:
Exemplo de atendimento
ID da playlist
Obrigatório conforme a operação
Informe o ID da playlist do YouTube.
Aparece em:
Obter itens da playlist
Exemplo:
id-do-recurso
Chave de API do YouTube
ObrigatórioDado protegido
Informe a chave de API do YouTube.
Padrão:
Segredo protegido

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <youtube.items>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<youtube.items>`	json	Lista de itens retornados.
`<youtube.totalResults>`	number	Número total de resultados.
`<youtube.nextPageToken>`	string	Token da próxima página.
`<youtube.videoId>`	string	ID do vídeo.
`<youtube.title>`	string	Título do vídeo ou do canal.
`<youtube.description>`	string	Descrição do vídeo ou do canal.
`<youtube.channelId>`	string	ID do canal.
`<youtube.channelTitle>`	string	Nome do canal.
`<youtube.publishedAt>`	string	Data de publicação.
`<youtube.duration>`	string	Duração do vídeo.
`<youtube.viewCount>`	number	Número de visualizações.
`<youtube.likeCount>`	number	Número de curtidas.
`<youtube.commentCount>`	number	Número de comentários.
`<youtube.favoriteCount>`	number	Número de favoritos.
`<youtube.thumbnail>`	string	URL da miniatura.
`<youtube.tags>`	json	Tags do vídeo.
`<youtube.categoryId>`	string	ID da categoria do vídeo.
`<youtube.definition>`	string	Definição do vídeo (hd/sd).
`<youtube.caption>`	string	Indica se tem legendas (true/false).
`<youtube.licensedContent>`	boolean	Indica se é conteúdo licenciado.
`<youtube.privacyStatus>`	string	Status de privacidade.
`<youtube.liveBroadcastContent>`	string	Status da transmissão ao vivo.
`<youtube.defaultLanguage>`	string	Idioma padrão.
`<youtube.defaultAudioLanguage>`	string	Idioma padrão do áudio.
`<youtube.isLiveContent>`	boolean	Indica se o vídeo é ou foi uma transmissão ao vivo.
`<youtube.scheduledStartTime>`	string	Horário de início programado da transmissão ao vivo.
`<youtube.actualStartTime>`	string	Horário real de início da transmissão ao vivo.
`<youtube.actualEndTime>`	string	Horário de término da transmissão ao vivo.
`<youtube.concurrentViewers>`	number	Espectadores agora (só ao vivo).
`<youtube.activeLiveChatId>`	string	ID do chat ao vivo.
`<youtube.subscriberCount>`	number	Número de inscritos.
`<youtube.videoCount>`	number	Total de vídeos.
`<youtube.customUrl>`	string	URL personalizada do canal.
`<youtube.country>`	string	País do canal.
`<youtube.uploadsPlaylistId>`	string	ID da playlist de envios.
`<youtube.bannerImageUrl>`	string	URL do banner do canal.
`<youtube.hiddenSubscriberCount>`	boolean	Indica se o número de inscritos está oculto.
`<youtube.assignable>`	boolean	Indica se a categoria pode ser atribuída.

Exemplo de uso

Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.

InícioYouTubepróxima etapa

Operação: Buscar vídeos
Consulta de busca: SELECT * FROM clientes WHERE status = 'ativo'

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa: Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal: Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte: Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <youtube.items>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece: Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada: Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
O serviço recusou a chamada ou devolveu erro: Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

O que faz

Antes de começar

Passo a passo

Operações

Campos

Operação

Consulta de busca

Máximo de resultados

Token da página

Filtrar por ID do canal

Filtro de transmissão ao vivo

Publicado depois de

Publicado antes de

Duração do vídeo

Ordem

ID da categoria

Qualidade do vídeo

Legendas

Código da região

Código do idioma

Pesquisa segura

ID do vídeo

Idioma

Nome de usuário do canal

ID da playlist

Chave de API do YouTube

Saídas

Exemplo de uso

Erros comuns e como resolver

Blocos relacionados