Lister les vidéos avec l'API Vimeo
Liste les vidéos téléversées par l'utilisateur connecté, avec uri, name, description, link, duration, privacy, parent_folder, tags, code d'embed et stats.plays, le nombre de lectures.
- Identifiant
- vimeo_list_videos
L'appel
POST https://connect.reportei.com/api/tools/vimeo_list_videos/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| query | string | Non | Text searched in the title, description, chapters and tags of the videos. |
| sort | string | Non | Order of the videos. likes and plays only work with direction desc.Valeurs : alphabetical, date, default, duration, last_user_action_event_date, likes, modified_time, plays |
| direction | string | Non | Direction of the order.Valeurs : asc, desc |
| page | integer | Non | Page to return, starting at 1. |
| per_page | integer | Non | Videos per page, up to 100. The default is 25. |
| fields | string | Non | Comma-separated fields to return, with dots for nested ones, like uri,name,link,duration,stats.plays,parent_folder.name. Vimeo doubles the rate limit of calls that send it. |
Connexions possibles
Votre client connecte son compte Vimeo une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/vimeo, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/vimeo_list_videos. Il devient la définition de tool de votre agent sans conversion.
Autres tools Vimeo
- Obtenir une vidéoGETRenvoie une vidéo : name, description, link, duration, dimensions, privacy, status, parent_folder, tags, code d'embed, miniatures et stats.plays, le nombre de lectures.
- Mettre à jour une vidéoPATCHMet à jour le titre, la description, la confidentialité ou la licence d'une vidéo de l'utilisateur connecté et la renvoie. Les champs omis gardent leur valeur.
- Lister les dossiersGETListe les dossiers de l'utilisateur connecté, avec uri, name, link, dates et le nombre de vidéos dans metadata.connections.videos.total.
- Créer un dossierPOSTCrée un dossier pour l'utilisateur connecté et le renvoie avec son uri. Sans parent_folder_uri c'est un dossier de premier niveau ; les dossiers s'imbriquent jusqu'à 10 niveaux.
- Mettre à jour un dossierPATCHRenomme un dossier de l'utilisateur connecté et le renvoie.
- Lister les vidéos d'un dossierGETListe les vidéos d'un dossier, avec uri, name, description, link, duration, privacy, tags et stats.plays, le nombre de lectures. Pagination par page.
- Déplacer une vidéo dans un dossierPUTPlace une vidéo dans un dossier de l'utilisateur connecté, qui doit en être le propriétaire. Répond 204 sans corps quand cela fonctionne.
- Lister les commentaires d'une vidéoGETListe les commentaires d'une vidéo, avec uri, text, author, date et le nombre de réponses dans metadata.connections.replies.total.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
