Primeiro: qual arquivo você precisa?
O Dante usa um cliente OAuth para computador: a configuração que permite pedir sua autorização no Google. O arquivo é gerado pelo próprio Google — você não precisa montar um JSON à mão.
No Dante Studio, esta conexão permite enviar vídeos já exportados para o YouTube e identificar o canal de destino. O JSON sozinho não autoriza o acesso: você ainda fará login e aprovará as permissões.
- A conta Google que administra o canal do YouTube.
- O Dante Studio instalado no Mac, sem gravação ou envio em andamento durante a configuração.
- Um navegador com acesso à internet e à pasta Downloads.
Conceito: credenciais da API do YouTube. Caminhos do aplicativo conferidos no código do Dante Studio.
Crie um projeto no Google Cloud
O projeto reúne a configuração da sua integração.
- Abra o Google Cloud Console e entre na sua conta Google.
- No seletor de projetos, no topo da página, escolha Novo projeto / New project.
- Dê um nome fácil de reconhecer, como Dante Studio pessoal, e conclua a criação.
- Aguarde a criação. No painel de Notificações (ícone de sino, no topo), clique em Selecionar projeto na confirmação. Você também pode usar o seletor do topo e clicar no nome do projeto. Confira o nome selecionado antes de continuar.
Referência: preparação do projeto para a API do YouTube. Use apenas a parte de configuração; o Dante não exige instalar Python.
Ative a API do YouTube
Ela permite ao aplicativo conversar com o YouTube.
- Abra APIs e serviços → Biblioteca (APIs & Services → Library).
- Pesquise YouTube Data API v3 e abra o resultado oficial do Google.
- Clique em Ativar / Enable. Se aparecer Gerenciar / Manage, a API já está habilitada.
Referência: habilitar a YouTube Data API v3.
Identifique o aplicativo
Esses dados aparecem na autorização do Google.
- Abra o menu ☰ → APIs e serviços → Tela de permissão OAuth, como no vídeo. Esse caminho abre a Google Auth Platform. Em outras versões do Console, a opção pode aparecer como Tela de consentimento OAuth.
- Na visão geral, clique em Começar / Get started, se a configuração ainda não existe.
- Em Informações do app, digite o nome do aplicativo e escolha o e-mail de suporte. Clique em Avançar.
- Em Público, escolha Externo para este uso pessoal e clique em Avançar.
- Em Dados de contato, informe um e-mail seu e avance. Pode ser o mesmo e-mail usado como suporte.
- Em Concluir, leia os termos; se concordar, marque a confirmação, clique em Continuar e finalize em Criar.
- Nome do aplicativo
- Dante Studio — uso pessoal
- E-mail de suporte
- Seu e-mail de contato
- Público / Audience
- Externo / External, para sua conta pessoal Google
- Contato do projeto
- Um e-mail seu que você acompanha
Se já estiver configurado, revise os dados em Branding e Público-alvo / Audience. A opção Interno / Internal é destinada a organizações Google Cloud.
Referência: primeiros passos no Google Auth Platform.
Adicione sua conta como usuário de teste
Comece com acesso restrito às contas que você indicar.
- Na lateral da Google Auth Platform, abra Público-alvo / Audience. Para este uso inicial pessoal, mantenha o projeto em Teste / Testing.
- Role até Usuários de teste e clique em + Adicionar. O painel lateral Adicionar usuários será aberto.
- Informe o e-mail Google usado para entrar na conta que administra o canal e clique em Salvar. Confira se esse e-mail aparece na lista. Não informe o nome do canal nem o @ do YouTube.
- Se vai conectar contas Google diferentes, adicione os respectivos e-mails também.
Referências: inclusão dos usuários e regras do modo de teste.
Declare as duas permissões do Studio
“Escopo” é o nome técnico de uma permissão.
- Abra Acesso a dados / Data Access e Adicionar ou remover escopos / Add or Remove Scopes.
- No painel Atualize os escopos selecionados, use Filtro para pesquisar
youtube.readonlye marque a caixa da linha correspondente. Remova o filtro pelo × do termo, pesquiseyoutube.uploade marque essa linha também. Não desmarque a primeira permissão ao trocar a busca. Se preferir a entrada manual, cole os dois endereços abaixo, um por linha.
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube.readonly- youtube.upload
- Permite enviar vídeos ao YouTube.
- youtube.readonly
- Permite consultar informações do YouTube, incluindo o canal conectado.
- Se usou a entrada manual, clique primeiro em Adicionar à tabela. Depois clique em Atualizar, na parte inferior do painel. Confira se as duas permissões aparecem na página Acesso a dados. No vídeo, elas já aparecem após Atualizar; se a sua versão do Console também mostrar Salvar, confirme esse botão.
Referências: configurar escopos no Console e permissões oficiais do YouTube. Endereços conferidos no código do Dante Studio.
Crie o cliente e baixe o JSON
Esta é a etapa que gera o arquivo para o Dante.
- Abra Clientes / Clients e clique em Criar cliente / Create client.
- Em tipo de aplicativo, escolha App para computador / Desktop app.
- No campo Nome, dê um nome à credencial, como Dante Studio — meu Mac, e clique em Criar. É uma identificação para você reconhecer esse cliente; não precisa ser o nome exato do computador.
- Na janela Cliente OAuth criado, clique em Baixar JSON, na parte inferior, e confirme o download. Só depois feche em OK. Não basta copiar o ID ou a chave exibidos: o Dante importa o arquivo JSON completo.
O fluxo de computador usa um retorno local no Mac. Você não precisa cadastrar um site. Se aparecerem campos de origens JavaScript, confira se escolheu o tipo “Web” por engano.
Referências: criar cliente Desktop, disponibilidade do segredo e retorno local no computador.
Importe e salve no Dante Studio
A configuração fica na área de Exportações.
- No Dante Studio, abra Exportações.
- Na área Seu canal no YouTube, clique em Configurar YouTube.
- Em JSON do Google Cloud, selecione o arquivo baixado na etapa 6. O aplicativo aceita um JSON de até 32 KB.
- Clique em Salvar credenciais. Escolher o arquivo sozinho ainda não salva a configuração.
- Aguarde a mensagem Credenciais salvas e clique em Fechar.
Credenciais e autorização ficam no cofre do sistema — no Mac, o Acesso às Chaves. Não são incluídas nos projetos ou vídeos exportados. O arquivo original de Downloads continua existindo: guarde-o em local protegido e não o publique no GitHub nem envie por mensagens.
Se já existe um canal conectado, a troca do JSON fica bloqueada. Veja a orientação sobre troca de conta na ajuda antes de desconectar.
Conecte com Google e confira o canal
A autorização acontece no navegador do Google.
- De volta a Exportações, clique em Conectar com Google.
- Escolha a conta que você adicionou como usuário de teste. Se houver seleção de identidade ou canal, escolha o destino correto.
- Confira o nome do projeto e as duas permissões solicitadas. Autorize somente se corresponderem à configuração que você criou.
- Volte ao Dante Studio e confira o nome do canal na área de conexão. O estado esperado é Canal conectado. Escolha um vídeo exportado para enviar.
- A configuração está concluída quando o canal correto aparece. Você não precisa enviar um vídeo para terminar este guia.
O Google pode mostrar um aviso de aplicativo não verificado. Confira seu projeto e sua conta antes de autorizar.
Referência: avisos e acesso em modo de teste. Botões e estados conferidos no Dante Studio.
Conectar não publica seus vídeos.
O envio é uma ação separada. Quando quiser publicar, abra Exportações e use Enviar ao YouTube no cartão do vídeo desejado.
- Credenciais salvas: o Studio conhece seu cliente Google.
- Canal conectado: você autorizou o acesso à conta.
- Enviar um vídeo: escolha o arquivo, revise título, descrição, capa, visibilidade e demais campos antes de confirmar.
Após um envio, confira o resultado no YouTube Studio. O processamento do vídeo pode continuar depois de terminar a transferência.
Travou em alguma etapa?
Encontre o sintoma e confira a configuração correspondente.
O Dante diz que o JSON não é de “Aplicativo para computador”
Volte à etapa 6 e baixe a credencial Desktop. O importador espera um objeto installed com client_id e client_secret, em arquivo de até 32 KB. JSON de conta de serviço ou cliente Web não serve. Não renomeie campos para tentar convertê-lo: crie o tipo correto.
Perdi o JSON ou o Google só mostra o final do segredo
Não monte um arquivo com o segredo mascarado. Para uma nova configuração pessoal, crie outro cliente Desktop, baixe o JSON imediatamente e salve-o em Exportações → Configurar YouTube; depois conecte o canal novamente. Se já estiver conectado, veja a orientação de troca de conta abaixo. Preserve o cliente antigo se ainda for usado em outro lugar. Orientação oficial sobre os segredos.
Acesso negado, erro 403 ou conta fora da lista de teste
Se o erro menciona usuários de teste, confira o e-mail da etapa 4. org_internal indica restrição à organização. Contas corporativas podem exigir aprovação do administrador. Regras de público e restrições.
Conectou antes, mas agora pede login novamente
Use Conectar com Google novamente; veja o prazo da etapa 4. Produção pode exigir verificação do Google e não significa aprovação automática. Teste e produção.
Apareceu invalid_client ou redirect_uri_mismatch
Confira o tipo Desktop e se a credencial importada ainda existe no projeto. Importe o JSON correto, sem alterações. O Dante usa um endereço local temporário 127.0.0.1 para receber a autorização; não é preciso cadastrar esse endereço como um site. Fluxo OAuth para computador.
Conectei o canal errado ou preciso trocar o JSON
O Studio mantém uma conexão de canal por vez. Para trocar, use Desconectar e depois Conectar com Google, escolhendo a conta/identidade correta. Para trocar o JSON, desconecte antes de abrir Configurar YouTube.
Atenção: o botão Desconectar revoga a autorização no Google e pode afetar outras instalações que usam essa autorização. Não o use durante um envio. Quando oferecida após falha da revogação, a opção Remover apenas deste computador apaga somente o acesso local.
Se o canal pertence a uma Conta de marca, o usuário de teste precisa administrá-la. Acesso de Contas de marca.
Importar, salvar ou conectar está desabilitado
Aguarde a operação em andamento terminar. A importação e a troca de credenciais também ficam bloqueadas enquanto existe um canal conectado. O botão Salvar credenciais exige um JSON válido selecionado. Feche o diálogo depois de salvar para acessar Conectar com Google.
Sobre este manual
Guia independente do Dante Studio. A organização e os nomes do Console podem variar com o idioma e as atualizações do Google; os nomes em inglês ajudam a localizar as opções. Os exemplos de nomes são sugestões, e a ilustração do arquivo não contém uma credencial.
Conferência deste roteiro: as etapas 1 a 6 foram revisadas com a fala e as telas do tutorial Integração com YouTube, de 5 min 54 s, e com as referências oficiais abaixo. O vídeo termina no download do JSON. As etapas 7 e 8 complementam o tutorial com os controles da integração no Dante Studio 0.9.25. Esta revisão do manual não realizou um novo login nem um envio de vídeo.
As referências oficiais estão ao lado das etapas correspondentes. Principais páginas para consulta: