L'outil de téléchargement groupé vous permet d'importer plusieurs sorties à la fois sur la plateforme à l'aide d'un modèle CSV. Cet article explique comment formater vos métadonnées, joindre des ressources et gérer les erreurs courantes. 

Vous pouvez télécharger le dernier modèle CSV au bas de cet article. Afin de vérifier l'éligibilité, vous devrez soumettre un exemple de fichier CSV groupé au service d'assistance via notre formulaire de contact. 

Général 

• Métadonnées du catalogue : nous décrivons ci-dessous le format du modèle CSV pour l'importation groupée. Avant d'utiliser l'outil, il est recommandé de consulter ce guide et de le lire attentivement. 
• Ressources du catalogue : les ressources ne seront pas téléchargées directement sur la plateforme. Le fichier de métadonnées doit plutôt inclure une URL à partir de laquelle les systèmes peuvent récupérer la ressource en un seul appel. Notre outil récupérera automatiquement les ressources en temps réel, à partir des URL indiquées dans le fichier CSV. 

Le téléchargement en masse au format CSV présente certaines limitations : 

• Ce modèle spécifique prend uniquement en charge les ajouts de titres (à l'exclusion des sonneries et des clips vidéo). 
• Champs non pris en charge : description et notes de la sortie et du titre ; paroles du titre, heure de début du titre. 
  • Ces champs ne peuvent pas être ajoutés dans le cadre du téléchargement en masse. Vous pouvez les mettre à jour depuis l'interface standard une fois le processus de téléchargement terminé. 

Définition des champs de sortie et de piste 

À partir de la ligne 8 du modèle de téléchargement en masse CSV, vous devez renseigner les métadonnées de votre catalogue. Chaque ligne correspond à un titre et contient également les données de l'album. Ainsi, si vous téléchargez par exemple un album de 10 titres, la première partie (champs de l'album) de la ligne sera remplie avec les mêmes données pour tous les titres (sur les 10 lignes), et la deuxième partie (champs du titre) sera différente pour chacun des titres. 

Dans cet exemple, une fois le fichier importé, s'il n'y a pas d'erreurs dans le processus, le système importera 1 album comprenant 10 titres. 

Correction des erreurs 

Si une sortie contient des erreurs, elle ne sera pas téléchargée, mais les sorties sans erreur seront téléchargées dans tous les cas. Une fois le téléchargement terminé, vous recevrez un fichier CSV des sorties ayant échoué, et les détails des erreurs s'afficheront lorsque vous cliquerez sur « Détails ». Cela vous permettra de corriger les sorties ayant échoué et d'en télécharger une autre version. 

Vous pouvez effectuer les opérations suivantes concernant les relations entre les titres : 

• Associer un titre existant à une nouvelle sortie : vous pouvez utiliser cet outil pour associer un titre déjà téléchargé par le passé à une toute nouvelle sortie. Pour ce faire, vous devez remplir les champs ISRC appropriés dans la section « Champs du titre » et laisser tous les autres champs vides. La section « Champs de la sortie » doit être remplie comme d'habitude. 
• Associer un nouveau morceau à plusieurs sorties : vous pouvez télécharger un nouveau morceau à inclure dans plusieurs nouvelles sorties au sein du même fichier CSV. Pour ce faire, vous devez remplir les mêmes champs de métadonnées du morceau dans la section « Champs du morceau » sur plusieurs lignes et vous assurer de remplir des « Champs de la sortie » différents sur chacune de ces lignes afin d'associer ce morceau à chacune de ces sorties. 
  • Si ce morceau existe déjà dans le catalogue, suivez les instructions du point 1. 

Format de fichier 

Le fichier doit être au format [CSV] avec des champs séparés par des virgules, éventuellement entre guillemets doubles, conformément à la norme RFC4180. L'encodage des caractères du fichier doit être UTF-8 afin de garantir un traitement correct des langues autres que l'anglais. 

Les champs facultatifs peuvent être laissés vides, mais leurs colonnes doivent être présentes dans le document afin de conserver la structure pour laquelle l'outil a été conçu. 

Type de version 

Le format de la version sera attribué automatiquement, selon les règles suivantes : 

Téléchargement de sorties 

Vous pourrez télécharger vos fichiers depuis le Gestionnaire de sorties. Par défaut, cette fonctionnalité n'est pas disponible sur votre compte et doit être activée par votre chargé de compte, ou en contactant support@toolost.com et en joignant un exemple de fichier CSV groupé. 

Instructions pour le fichier CSV 

Champs de métadonnées 

La première section du fichier est une section de métadonnées (lignes 1 à 5). Tous les champs sont obligatoires et permettent à notre outil de traiter le fichier correctement. 

Champs de sortie 

Champs relatifs aux pistes 

Les pistes de la sortie seront numérotées à partir de 1 dans l'ordre où elles apparaissent dans le fichier CSV de téléchargement groupé. À partir de la deuxième ligne de piste pour la même sortie, tous les champs de sortie doivent être présents et cohérents avec la première ligne de sortie. 

Participants 

Les rôles et noms de tous les artistes et autres participants doivent être répertoriés dans la colonne unique « participants ». Chaque participant doit être précédé de son rôle et d'un deux-points. Les paires rôle-nom doivent être séparées par des points-virgules. 

Par exemple : 

• Artistes principaux : Natos, Waor. 
• En featuring : Ambkor. 
• Remixeur : Natos. 
• Producteur : Waor. 
• Compositeur : Waor. 

La colonne « Participants » doit afficher : 

• primary:Natos;primary:Waor;featuring:Ambkor;remixer:Natos;producer:Waor;composer:Waor 

Règles pour les participants 

• Chaque sortie et chaque morceau doivent avoir au moins un artiste principal. 
• Dans un album ou un morceau, un artiste ne peut occuper qu'un seul rôle parmi les suivants : principal, interprète, en featuring ou en collaboration. 
• Pour toute sortie à laquelle est attribué un genre autre que « non-parlé », il doit y avoir au moins un compositeur sur chaque piste. 
• L'artiste principal doit être le premier participant répertorié dans la séquence. 

Noms de rôles de participants actuellement acceptés (en minuscules) 

• principal 
• interprète 
• producteur 
• remixeur 
• compositeur 
• auteur 
• éditeur 
• en featuring 
• avec 
• chef d'orchestre 
• arrangeur 
• orchestre 
• acteur 

Piste en double dans le même fichier CSV 

Si vous devez créer une nouvelle piste, avec un ISRC spécifique, qui sera partagée dans deux ou plusieurs sorties, vous pouvez le faire en répétant la piste dans toutes ces sorties, mais veillez particulièrement à ce que les informations de chaque piste soient identiques pour toutes les duplications. 

Si certaines informations de piste diffèrent des autres, toutes les pistes seront marquées comme ayant échoué. 

Cette piste partagée doit avoir un ISRC attribué ; il ne peut s'agir d'un ISRC AUTO. 

Piste répétée dans le catalogue de l'utilisateur 

Vous pouvez attribuer un morceau existant dans le catalogue de l'utilisateur à une nouvelle sortie. 

Pour ce faire, dans le fichier CSV, nous devons laisser vides toutes les informations relatives au morceau à l'exception de l'ISRC, qui est la donnée que nous utilisons pour trouver le morceau existant dans le catalogue de l'utilisateur. 

Comment joindre des fichiers de ressources 

Dans les champs de liens vers les ressources (cover_url au niveau de la sortie et audio_url au niveau de la piste), vous devez indiquer un lien vers un fichier disponible afin que nous puissions le récupérer et le télécharger avec votre contenu. 

Les ressources sont obligatoires et si l'un des liens échoue, la sortie ne peut pas être téléchargée. Vous devez donc vous assurer que les URL pointent vers les bonnes ressources. 
Si les URL (par exemple, WeTransfer) ou les identifiants d'authentification (par exemple, les URL signées S3) n'ont qu'une durée de validité limitée, assurez-vous que cette durée est suffisamment longue pour permettre au système d'ingérer les ressources. 

Veuillez consulter notre guide des exigences relatives aux fichiers audio. 

Veuillez consulter notre guide des exigences relatives aux pochettes d'album. 

Méthodes prises en charge pour l'ingestion des ressources 

Les ressources ne seront pas téléchargées directement sur la plateforme. À la place, le fichier de métadonnées doit inclure une URL à partir de laquelle les systèmes peuvent récupérer la ressource en un seul appel. Cela signifie que l'URL doit être unique pour chaque ressource. Par exemple, le lien vers la pochette peut être le même pour chaque titre de l'album, mais l'audio doit être différent pour chaque titre (car l'audio est différent). L'URL doit être un lien de téléchargement direct. 

Aucune information d'authentification ne doit être incluse dans l'URL. Le processus d'ingestion ne suit aucune procédure de connexion distincte. 

Les métadonnées ne doivent pas nécessairement être hébergées de manière permanente sur l'URL externe ; elles doivent simplement être accessibles pendant que nous les récupérons pour traiter l'album sur notre plateforme. En effet, à partir de là, le fichier audio et la pochette sont stockés dans notre système. 

Nous prenons actuellement en charge les options suivantes : 

• URL publiques : 
  • URL HTTP 
  • URL HTTPS 
  • URL FTP 
  • URL SFTP 
  • URL Amazon S3 (avec une URL signée si le fichier est protégé en lecture) (c'est la méthode recommandée) 
  • Services de stockage dans le cloud proposant des liens publics de téléchargement direct (tels que Dropbox, WeTransfer, Google Drive) 

• URL authentifiées : 
  Nous prenons en charge certaines méthodes d'URL authentifiées, uniquement avec un identifiant et un mot de passe. Pour inclure un lien authentifié, respectez les formats suivants : 
  • URL HTTP : http://{utilisateur}:{mot de passe}@{hôte}/{fichier} 
  • URL HTTPS : https://{user}:{pass}@{host}/{file} 
  • URL FTP : ftp://{user}:{pass}@{host}/{file} 
  • URL SFTP* : sftp://{user}:{pass}@{host}/{file} 
  • URL Amazon S3** : https://{bucket}.s3.amazonaws.com/{file}?AWSAccessKeyId={accesskey}&Signature={signature}&Expires={timestamp} 

* Nous ne prenons en charge que les clés publiques pour les URL SFTP. Pour nous fournir une clé publique, veuillez contacter notre centre d'assistance et coordonner votre téléchargement avec notre équipe. 
** URL Amazon S3 : avec une URL signée si le fichier est protégé en lecture. 

Licences Creative Commons 

Nous ne prenons actuellement en charge que la version 3.0 de Creative Commons. Utilisez le paramètre « license_info » pour afficher les clauses Creative Commons avec leurs acronymes officiels, séparés par des tirets. 

Exemple d'importation CSV en masse

Exemple d'importation CSV en masse