Points clés à retenir
- Définissez si la tâche est une migration entre comptes, une republication contrôlée ou une expérimentation sur un dérivé avant de copier quoi que ce soit.
- Importez une page Vimeo délimitée et sélectionnez délibérément la variante source.
- Créez un dérivé MP4 connu au lieu de supposer que la variante importée respecte la nouvelle politique de diffusion.
Un pipeline de Vimeo vers Vimeo est utile pour consolider des comptes, effectuer une republication contrôlée ou réviser une politique de codecs, mais il ne réalise pas un transcodage magique sur place. L’import télécharge une variante sélectionnée et l’export crée une autre vidéo. Traitez cette opération comme une migration avec une gestion explicite des identités, de la révision et du retour arrière, plutôt que comme une simple mise à jour de format sans risque.
L’essentiel
- Exportez avec un accès Vimeo restrictif jusqu’à ce que les métadonnées et la lecture soient vérifiées.
- Enregistrez les identifiants des vidéos sources et de destination afin que les nouvelles exécutions ne créent pas de doublons invisibles.
- Limitez le débit et adaptez les nouvelles tentatives aux limites de l’API de destination sans relancer les exports réussis.
Décider de ce que représente le nouvel enregistrement Vimeo
Un import Vimeo suivi d’un export Vimeo crée une nouvelle vidéo à destination. Définissez si cet enregistrement remplace une source dans un autre compte, représente une variante soumise à de nouvelles règles de gouvernance ou constitue seulement une expérimentation privée. Sans cet objectif, le flux de travail produit des doublons dont la propriété et le public sont mal définis.
Créez un enregistrement de migration dans l’application avant de commencer. Enregistrez le compte source et l’identité de la vidéo, la variante sélectionnée, le compte de destination, les métadonnées prévues, la version du flux de travail, l’identifiant d’Assembly et l’identité Vimeo obtenue. Cette correspondance constitue la base de la déduplication, de la révision et du retour arrière.
Choisir délibérément la variante importée
/vimeo/import sélectionne la variante source ou une variante désignée par un nombre allant de 240p à 1080p. Utilisez source lorsque le flux de travail nécessite la variante source, et choisissez une variante désignée par un nombre lorsque la résolution de sortie et le coût de migration sont délibérément limités. L’exemple choisit 1080p comme entrée de résolution limitée, et non comme copie de conservation. Le Step d’encodage agrandit une variante importée plus petite, sauf si zoom est défini sur false ; un import 720p réencodé en 1080p ajoute donc des pixels plutôt que des détails.
Effectuez la pagination par chemin d’API Vimeo et numéro de page. Une page est une unité de travail pratique, pas une garantie d’idempotence ; les collections Vimeo peuvent changer pendant la migration. Prenez un instantané des identités sources ou enregistrez-les afin que les vidéos nouvellement ajoutées ou réordonnées ne modifient pas silencieusement le lot.
Créer le Template de republication privée
Le Step d’encodage lit uniquement l’import Vimeo et produit un MP4 maîtrisé. Le Step de stockage lit le résultat encodé et crée une vidéo à destination avec un accès restrictif. L’exemple utilise acl défini sur nobody, ce qui permet au propriétaire d’inspecter la destination avant d’accorder l’accès à un public.
Utilisez des informations d’identification de Template distinctes pour la source et la destination lors des transferts entre comptes. L’exemple définit fields.page_number sur 1 par défaut ; un ordonnanceur de confiance fournit l’entier positif suivant dans ce champ pour les Assemblies ultérieures. Conservez le titre, la description, le dossier, les Showcases et la politique d’accès dans une configuration de migration de confiance. Un titre dérivé du nom de fichier peut être acceptable pour une donnée de test privée, mais les métadonnées de production devraient provenir d’un enregistrement source approuvé.
{
"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
}
}
}Rapprocher les métadonnées et les fonctionnalités de la plateforme
Les octets du média ne constituent qu’une partie d’un enregistrement Vimeo. Les commentaires, les données analytiques, l’historique de révision, les miniatures personnalisées, les sous-titres, les Showcases, les dossiers, la confidentialité, les paramètres de téléchargement et les liens de l’application peuvent nécessiter un traitement distinct. Inventoriez chaque élément et décidez s’il est migré, recréé, intentionnellement omis ou conservé uniquement sur la source.
Ne supprimez pas et ne masquez pas la source simplement parce que le nouveau téléversement a réussi. Vérifiez la durée, les flux, l’audio, la qualité visuelle, les métadonnées, le classement dans les dossiers, l’accès et toutes les intégrations en aval. Ne modifiez les références de l’application et le devenir de la source qu’après validation de la destination par ces vérifications.
Résultat multimédia
La vidéo de destination présente la durée, les flux et la qualité visuelle attendus.
Résultat côté plateforme
La confidentialité, les métadonnées, le dossier, les Showcases et le comportement du téléchargement respectent la politique.
Résultat côté application
La correspondance entre les anciennes et les nouvelles identités est enregistrée durablement et les consommateurs pointent vers l’enregistrement prévu.
Contrôler les traitements simultanés et les nouvelles tentatives
Les limites de téléversement Vimeo dépendent de l’offre du compte connecté. files_per_page contrôle le nombre de fichiers que /vimeo/import récupère par page ; ce n’est pas un contrôle documenté du nombre d’exports simultanés. Une page plus grande donne aux Steps en aval davantage de vidéos à traiter pendant l’exécution. Gardez les premières pages petites, n’augmentez leur taille qu’après avoir mesuré la tolérance du compte de destination et espacez les tentatives lorsque le fournisseur limite le débit. Placez explicitement les enregistrements sources dans une file d’attente afin qu’une réponse temporaire du fournisseur ne relance pas un encodage déjà réussi et n’exporte pas deux fois des vidéos sans rapport.
Traitez séparément les informations d’identification expirées, les variantes sources indisponibles, les échecs d’encodage, les rejets à destination et les callbacks de fin perdus. Avant de réessayer un export, vérifiez l’Assembly existante et l’enregistrement de migration. Une expiration du délai dont l’issue est incertaine devrait déclencher une réconciliation, et non créer automatiquement une autre vidéo Vimeo.
Terminer la bascule en conservant la possibilité de retour arrière
Ne faites basculer les intégrations de l’application, l’appartenance aux collections et les références visibles par les utilisateurs qu’après la validation de l’enregistrement de destination lors de la révision. Conservez la correspondance entre source et destination ainsi qu’une date limite de retour arrière. Si une destination est ensuite rejetée ou supprimée, les opérateurs devraient pouvoir retrouver la source exacte et relancer le flux de travail prévu sans rechercher par titre.
Retirez du service ou supprimez les vidéos sources au moyen d’une opération distincte ayant fait l’objet d’une révision. Le Template de migration ne devrait pas effectuer de modifications destructrices sur Vimeo, car la seule réussite de l’export ne prouve pas que chaque fonctionnalité de la plateforme et chaque consommateur en aval ont été migrés.
Détails techniques à connaître
- /vimeo/import prend en charge des chemins d’API Vimeo tels que me/videos et utilise page_number et files_per_page pour la pagination, avec une limite fixée par son schéma à 100 fichiers par page.
- /vimeo/import accepte la variante source ou l’une des cinq variantes désignées par un nombre allant de 240p à 1080p. La variante sélectionnée constitue l’entrée du Step d’encodage. Cet exemple choisit délibérément 1080p pour limiter la résolution importée ; ce n’est pas un flux de travail de conservation.
- /vimeo/store accepte des vidéos et crée un enregistrement de destination avec un titre, une description, un contrôle d’accès et, en option, des Showcases et un classement dans un dossier.
- Les valeurs d’accès pour l’export Vimeo comprennent anybody, contacts, disable, nobody, password, unlisted et users. Le champ password n’est pertinent que lorsque acl vaut password.
- La documentation du Robot de stockage Vimeo avertit que les limites de téléversements simultanés dépendent de l’offre du compte Vimeo connecté.
- L’importation et l’exportation via le même fournisseur ne préservent ni les commentaires, ni les données analytiques, ni l’historique des examens, ni l’identité de la vidéo d’origine, sauf si l’application assure séparément leur migration ou leur mise en correspondance.
Une approche pratique
- 1
Inventoriez les vidéos sources, la propriété de la destination, les métadonnées, les Showcases, la confidentialité et les règles de remplacement.
- 2
Créez des ensembles d’informations d’identification Vimeo distincts pour la source et la destination, puis enregistrez le Template verrouillé.
- 3
Migrez une petite page en privé et vérifiez les flux, la durée, l’audio, les métadonnées et le classement dans les dossiers.
- 4
Rapprochez les identités, publiez délibérément et conservez un enregistrement de retour arrière avant d’augmenter la taille du lot.
Quand Transloadit est utile
Utilisez /vimeo/import pour une page ou une collection délimitée, /video/encode pour une sortie MP4 connue et /vimeo/store pour le compte de destination. Utilisez des informations d’identification de Template distinctes pour la source et la destination lors des migrations entre comptes, commencez avec acl défini sur nobody et enregistrez la correspondance entre les anciennes et les nouvelles identités Vimeo.
Périmètre architectural
Ce flux de travail crée de nouveaux enregistrements vidéo Vimeo à partir de variantes importées. Il ne modifie pas une vidéo source sur place, ne préserve pas automatiquement toutes les fonctionnalités côté Vimeo et ne décide pas quand le nouvel enregistrement doit remplacer l’ancien dans une application ou une collection.
Questions fréquentes
Cette opération met-elle à jour une vidéo Vimeo sur place ?
Non. Le Step de stockage crée une vidéo à destination. Traitez ce flux de travail comme une migration ou une republication et conservez une correspondance explicite entre les anciennes et les nouvelles identités.
Quelle variante Vimeo faut-il importer ?
Utilisez source lorsque le flux de travail doit importer la variante source. Choisissez une variante désignée par un nombre, comme 1080p dans l’exemple, lorsque vous souhaitez délibérément limiter la résolution ou le coût de migration. La variante importée est le contenu reçu par le Step d’encodage ; elle limite donc la qualité de tout ce qui suit.
Peut-on utiliser un seul ensemble d’informations d’identification pour les deux Steps ?
Oui, pour le même compte connecté, mais des informations d’identification distinctes pour la source et la destination sont plus claires et plus sûres pour les migrations entre comptes.
Quel paramètre d’accès la destination doit-elle utiliser ?
Commencez avec nobody ou une autre politique restrictive, vérifiez le résultat, puis accordez l’accès au public prévu par une transition autorisée.
Les commentaires et les données analytiques sont-ils migrés ?
Pas par ce flux de travail multimédia en trois Steps. Les enregistrements et l’historique côté plateforme nécessitent un plan de migration distinct ou une conservation délibérée sur la source.