done ou failed.
Antes de começar
- Conecte e autorize seu canal do YouTube no Vozo. Se a conexão tiver expirado, reautorize-a antes de criar uma exportação.
- Você precisa ter acesso à API do Vozo, a exportação para o YouTube habilitada para sua conta e um plano Studio ou superior.
- A tarefa de origem do Vozo deve pertencer ao mesmo usuário e estar concluída. Seu arquivo de vídeo ainda deve estar disponível.
- A publicação no YouTube está sujeita tanto à cota de exportação de 24 horas da sua conta quanto a uma cota do sistema.
- Use uma chave de API no cabeçalho
Authorization: Bearer <api_key>.
Fluxo de trabalho
1
Obter categorias de vídeo
Chame Listar categorias para obter um
category_id válido para a região do seu canal conectado. Apenas categorias atribuíveis são retornadas.2
Criar uma exportação
Chame Criar tarefa de exportação com a tarefa de origem concluída, o título, a categoria e a configuração de privacidade. Guarde o
task_id retornado: ele identifica a exportação do YouTube, não a tarefa original do Vozo.3
Consultar a tarefa de exportação
Chame Obter tarefa de exportação com o ID da tarefa de exportação. Quando
status for done, use studio_url para abrir o vídeo no YouTube Studio. Se for failed, verifique error_code.Tarefas de origem e modos
Para Tradução e Dublagem e Tradução Visual,
source_mode é obrigatório quando a tarefa de origem tem um projeto editável. Para uma tarefa de origem não editável, omiti-lo seleciona initial_output. generate_new e use_existing exigem o projeto editável associado; use_existing também exige um vídeo exportado existente. initial_output exige uma saída de vídeo da tarefa de origem.
Status da exportação
Esses endpoints não criam nem autorizam uma conexão com o YouTube. Conclua essa configuração no Vozo antes de usar a API de exportação.
Erros comuns da API
Para outras falhas, inspecione os campos
code, message e errors opcionais da resposta. Uma tarefa de publicação também pode chegar a failed após ter sido criada; consulte seu error_code para esse resultado.