« Pour Fonctionnalités de Riverside pour les entreprises : Vue d'ensemble
L'API Riverside Business permet d'économiser des efforts manuels en permettant à votre équipe d'extraire des fichiers médias de votre compte Riverside et de supprimer ce qui n'est plus nécessaire.
Cela peut optimiser vos workflows de post-production, vous permettre de gérer le contenu à grande échelle et améliorer la sécurité du stockage de vos données à long terme.
Qui : Propriétaires de compte
Plan : Certains plans Business, contactez votre CSM
Appareil : Navigateur d'ordinateur
À propos de l'API
L'API Riverside Business soutient :
Enregistrements
- Récupération d'une liste de productions avec des studios, des projets et des enregistrements associés.
- Récupération d'une liste d'enregistrements avec un filtrage facultatif par
ID de studioouID de projet. Chaque enregistrement comprend des informations sur les tracks. - Récupération d'un enregistrement unique par son ID. Chaque enregistrement comprend des informations sur les tracks.
- Téléchargement du fichier média d'un track.
- Téléchargement du fichier de transcription d'un track.
- Suppression d'un enregistrement par son ID.
Montages
- Récupération d'une liste d'éditions exportées avec un filtrage facultatif par
ID de studio,ID de projetouID d'enregistrement. Récupérer une seule modification exportée par son ID.
Télécharger le fichier média d'une modification exportée.
Supprimer une modification exportée par son ID.
Récupération d'une liste d'éditions dans votre espace de travail avec un filtrage optionnel par studio, projet ou plage de dates en utilisant l'
List Editspoint de terminaison.
Exports de timeline
Déclenchement d'un export de chronologie pour un edit spécifique en utilisant l'
Create Timeline Exportendpoint.Vérification de l'état d'un travail d'exportation de chronologie et récupération de l'URL de téléchargement en utilisant le
Get Timelinepoint de terminaison.Téléchargement d'un fichier ZIP contenant le fichier de chronologie (XML ou AAF) et tous les médias alignés en utilisant le
Download Timeline Filepoint de terminaison.
Webinaires
-
Récupération d'une liste de chaque webinaire dans votre compte en utilisant le
Get Eventspoint de terminaison, y compris le statut d'inscription, le nombre d'inscrits, et le lien public d'inscription.Les webinaires à la demande ne sont pas inclus dans les résultats de Get Events. Utilisez Webinaire : Trouver l'ID de l'événement pour obtenir leurs ID à la place.
- Récupération d'une liste des inscrits au webinaire en utilisant le
Get Registrantspoint de terminaison, y compris les données de participation, l'attribution UTM, et les champs d'inscription personnalisés.- Ajoutez
include=poll_answersà votre demandeGet Registrantspour retourner les réponses de chaque inscrit aux sondages lancés pendant le webinaire. - Les points de terminaison
Create RegistrantetGet Registrantsfonctionnent également avec les webinaires à la demande.
- Ajoutez
Pour le moment, l'API Riverside Business ne prend pas en charge :
- Développement de nouvelles fonctionnalités ou applications construites sur la plateforme Riverside (c'est-à-dire intégrations et applications).
Configuration de l'API
Une fois que votre CSM active la fonctionnalité, suivez les étapes ci-dessous pour la configurer.
Étape par étape
Connectez-vous à votre compte Riverside.
- Dans le coin inférieur gauche, cliquez sur le bouton du menu du compte.
- Cliquez sur Réglages.
- Sous Équipe, cliquez sur API.
- Sous Générer une clé API, cliquez sur Générer.
- Dans le pop-up, sous Votre clé API, cliquez sur Copier.
Votre clé API a été copiée dans votre presse-papiers.
Une fois le pop-up fermé, la clé expire. Générer une nouvelle clé à tout moment. - Suivez la documentation de l'API ici.
Bon à savoir
- Vous ne pouvez générer qu'une seule clé API et une seule clé API peut être active à la fois.
- La limite de taux de l'API ne peut pas être modifiée.
- L'API Business récupère les données lorsque vous le demandez. Pour que Riverside envoie des événements de webinaire à vos outils automatiquement au fur et à mesure qu'ils se produisent, utilisez les webhooks.
- Pour enregistrer vos fichiers sur Google Drive, utilisez le point de téléchargement de fichier de l'API, puis configurez l'API de Google pour télécharger les fichiers.