Principais pontos
- Defina se o trabalho é uma migração de conta, uma republicação controlada ou um experimento com derivados antes de copiar qualquer coisa.
- Importe uma página delimitada do Vimeo e selecione a versão de origem de forma deliberada.
- Crie um derivado MP4 conhecido em vez de presumir que a versão importada atende à nova política de entrega.
Um pipeline de Vimeo para Vimeo é útil durante a consolidação de contas, a republicação controlada ou a atualização de uma política de codecs, mas não é uma transcodificação mágica feita diretamente no vídeo original. A importação baixa uma versão selecionada e a exportação cria outro vídeo. Trate isso como uma migração com identidade, revisão e reversão explícitas, e não como uma atualização de formato inofensiva.
O que mais importa
- Exporte com acesso restrito no Vimeo até que os metadados e a reprodução sejam verificados.
- Registre os identificadores de vídeo de origem e de destino para que novas execuções não criem duplicatas invisíveis.
- Limite a taxa de requisições e repita tentativas respeitando os limites da API de destino, sem reiniciar exportações bem-sucedidas.
Decida o que o novo registro do Vimeo representa
Uma importação do Vimeo seguida de uma exportação para o Vimeo cria um novo vídeo de destino. Defina se esse registro substitui uma origem em outra conta, representa uma versão sob nova governança ou é apenas um experimento privado. Sem esse propósito, o fluxo de trabalho produz duplicatas cuja propriedade e cujo público não são claros.
Crie um registro de migração na aplicação antes de começar. Armazene a conta e a identidade do vídeo de origem, a versão de vídeo selecionada, a conta de destino, os metadados pretendidos, a versão do fluxo de trabalho, o Assembly ID e a identidade resultante no Vimeo. Esse mapeamento é a base para deduplicação, revisão e reversão.
Escolha a versão importada de forma deliberada
/vimeo/import seleciona a versão de origem ou uma versão numérica nomeada, de 240p a 1080p. Use source quando o fluxo de trabalho precisar da versão de origem e escolha uma versão numérica quando a resolução de saída e o custo da migração forem limitados deliberadamente. O exemplo escolhe 1080p como entrada limitada, não como cópia de preservação. O Step de codificação amplia uma versão importada menor, a menos que zoom seja definido como false; portanto, uma importação em 720p recodificada para 1080p acrescenta pixels, não detalhes.
Pagine pelo caminho da API do Vimeo e pelo número da página. Uma página é uma unidade de trabalho conveniente, não uma garantia de idempotência; as coleções do Vimeo podem mudar enquanto a migração está em andamento. Tire um snapshot ou registre as identidades de origem para que vídeos recém-adicionados ou reordenados não alterem o lote silenciosamente.
Monte o Template privado de republicação
O Step de codificação lê apenas a importação do Vimeo e produz um MP4 controlado. O Step de armazenamento lê o resultado codificado e cria um vídeo de destino com acesso restrito. O exemplo usa acl definido como nobody, o que permite que o proprietário inspecione o destino antes que qualquer público receba acesso.
Use credenciais de Template separadas para origem e destino ao migrar entre contas. O exemplo define fields.page_number como 1 por padrão; um agendador confiável fornece o próximo inteiro positivo nesse campo para as Assemblies subsequentes. Mantenha título, descrição, pasta, Showcases e política de acesso em uma configuração de migração confiável. Um título derivado do nome do arquivo pode ser aceitável para um dado de teste privado, mas os metadados de produção devem vir de um registro de origem aprovado.
{
"allow_steps_override": false,
"fields": { "page_number": 1 },
"steps": {
"vimeo_sources": {
"robot": "/vimeo/import",
"credentials": "vimeo-source-account",
"path": "me/videos",
"rendition": "1080p",
"page_number": "${fields.page_number}",
"files_per_page": 3
},
"normalized_mp4": {
"use": "vimeo_sources",
"robot": "/video/encode",
"preset": "web/mp4/1080p",
"width": 1920,
"height": 1080,
"resize_strategy": "fit",
"zoom": false
},
"vimeo_destination": {
"use": "normalized_mp4",
"robot": "/vimeo/store",
"credentials": "vimeo-destination-account",
"title": "${file.original_basename} — normalized",
"description": "Private migration candidate from ${file.original_name}",
"acl": "nobody",
"downloadable": false,
"result": true
}
}
}Reconcilie metadados e recursos da plataforma
Os bytes de mídia são apenas parte de um registro do Vimeo. Comentários, dados analíticos, histórico de revisão, miniaturas personalizadas, legendas, Showcases, pastas, privacidade, configurações de download e links da aplicação podem exigir tratamento separado. Faça um inventário de cada aspecto e decida se ele será migrado, reconstruído, omitido intencionalmente ou mantido apenas na origem.
Não exclua nem oculte a origem só porque o novo upload foi concluído com sucesso. Verifique duração, streams, áudio, qualidade visual, metadados, posicionamento em pastas, acesso e quaisquer incorporações em sistemas downstream. Altere as referências da aplicação e o tratamento dado à origem somente depois que o destino passar nessas verificações.
Resultado da mídia
O vídeo de destino tem a duração, os streams e a qualidade visível esperados.
Resultado da plataforma
Privacidade, metadados, pasta, Showcases e comportamento de download estão de acordo com a política.
Resultado da aplicação
O mapa das identidades antigas para as novas é durável e os consumidores apontam para o registro pretendido.
Controle a concorrência e as novas tentativas
Os limites de upload do Vimeo dependem do plano da conta conectada. files_per_page controla quantos arquivos /vimeo/import recupera por página; não é um controle documentado de concorrência de exportação. Uma página maior dá aos Steps downstream mais vídeos para tratar na execução. Mantenha as primeiras páginas pequenas, aumente o tamanho da página só depois de medir a tolerância da conta de destino e reduza o ritmo quando o provedor aplicar limitação de taxa. Enfileire os registros de origem explicitamente para que uma resposta temporária do provedor não reinicie uma codificação já bem-sucedida nem exporte duas vezes vídeos não relacionados.
Trate separadamente credenciais expiradas, versões de origem indisponíveis, falhas de codificação, rejeições do destino e callbacks de conclusão perdidos. Antes de tentar novamente uma exportação, verifique a Assembly existente e o registro de migração. Um timeout incerto deve entrar em reconciliação, e não criar automaticamente outro vídeo no Vimeo.
Conclua a transição sem perder a opção de reversão
Mova as incorporações da aplicação, a associação a coleções e as referências visíveis ao usuário somente depois que o registro de destino passar pela revisão. Mantenha o mapa de origem para destino e um prazo para reversão. Se um destino for rejeitado ou removido depois, os operadores devem conseguir localizar a origem exata e executar novamente o fluxo de trabalho pretendido sem pesquisar pelo título.
Aposente ou exclua os vídeos de origem por meio de uma operação separada e revisada. O Template de migração não deve fazer alterações destrutivas no Vimeo, porque o sucesso da exportação, por si só, não prova que todos os recursos da plataforma e todos os consumidores downstream foram migrados.
Detalhes técnicos que vale a pena conhecer
- /vimeo/import oferece suporte a caminhos da API do Vimeo, como me/videos, e pagina com page_number e files_per_page, com limite de 100 arquivos por página definido pelo seu schema.
- /vimeo/import aceita a versão de origem ou uma das cinco versões numéricas de 240p até 1080p. A versão selecionada é a entrada do Step de codificação. Este exemplo escolhe deliberadamente 1080p para limitar a resolução importada; não é um fluxo de trabalho de preservação.
- /vimeo/store aceita vídeos e cria um registro de destino com título, descrição, controle de acesso, Showcases opcionais e posicionamento opcional em pasta.
- Os valores de acesso da exportação para o Vimeo incluem anybody, contacts, disable, nobody, password, unlisted e users. O campo password só é relevante quando acl é password.
- A documentação do Robot de armazenamento do Vimeo alerta que os limites de uploads simultâneos dependem do plano da conta do Vimeo conectada.
- Importar e exportar pelo mesmo provedor não preserva comentários, dados analíticos, histórico de revisão nem a identidade original do vídeo, a menos que a aplicação migre ou mapeie esses aspectos separadamente.
Uma abordagem prática
- 1
Faça o inventário dos vídeos de origem, da propriedade do destino, dos metadados, dos Showcases, da privacidade e das regras de substituição.
- 2
Crie credenciais separadas do Vimeo para origem e destino e salve o Template bloqueado.
- 3
Migre uma página pequena de forma privada e verifique streams, duração, áudio, metadados e posicionamento em pastas.
- 4
Reconcilie as identidades, publique de forma deliberada e mantenha um registro de reversão antes de ampliar o lote.
Quando a Transloadit é útil
Use /vimeo/import para uma página ou coleção delimitada, /video/encode para uma saída MP4 conhecida e /vimeo/store para a conta de destino. Use credenciais de Template separadas para origem e destino em migrações entre contas, comece com acl definido como nobody e registre o mapeamento de identidade do Vimeo, do antigo para o novo.
Limite da arquitetura
Este fluxo de trabalho cria novos registros de vídeo no Vimeo a partir das versões importadas. Ele não edita diretamente um vídeo de origem, não preserva automaticamente todos os recursos do lado do Vimeo e não decide quando o novo registro deve substituir o antigo em uma aplicação ou coleção.
Perguntas frequentes
Isso atualiza um vídeo do Vimeo diretamente?
Não. O Step de armazenamento cria um vídeo de destino. Trate o fluxo de trabalho como migração ou republicação e mantenha um mapa explícito de identidade do antigo para o novo.
Qual versão do Vimeo deve ser importada?
Use source quando o fluxo de trabalho precisar importar a versão de origem. Escolha uma versão numérica, como 1080p no exemplo, quando quiser intencionalmente limitar a resolução ou o custo da migração. A versão importada é o material que o Step de codificação recebe, portanto ela limita a qualidade de tudo o que vem depois.
Uma credencial pode ser usada nos dois Steps?
Sim, para a mesma conta conectada, mas credenciais separadas de origem e de destino são mais claras e mais seguras em migrações entre contas.
Qual configuração de acesso o destino deve usar?
Comece com nobody ou outra política restritiva, verifique o resultado e depois conceda acesso ao público pretendido por meio de uma transição autorizada.
Comentários e dados analíticos são migrados?
Não por este fluxo de trabalho de mídia de três Steps. Registros e histórico do lado da plataforma exigem um plano de migração separado ou a retenção deliberada na origem.