> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.
> Stockage et partage de fichiers
# Dropbox
## Authentification et configuration
L'intégration Dropbox utilise l'authentification OAuth 2.0 avec une approche d'accès limité. Les organisations doivent créer une application Dropbox dans la console d'applications Dropbox et configurer les autorisations appropriées. L'intégration prend en charge les comptes Dropbox personnels et les comptes d'équipe Dropbox Business. Les agents peuvent accéder aux fichiers du Dropbox de l'utilisateur ou aux dossiers d'équipe partagés avec l'autorisation appropriée.
## Autorisations et étendues requises
* **files.content.write** : Charger et modifier le contenu des fichiers.
* **files.content.read** : Télécharger et lire le contenu des fichiers.
* **files.metadata.write** : Créer des dossiers, déplacer, renommer et supprimer des fichiers.
* **files.metadata.read** : Afficher les métadonnées des fichiers et des dossiers.
* **sharing.write** : Créer et modifier les liens de partage.
* **sharing.read** : Afficher les paramètres de partage existants.
* **team\_data.member** : Accéder au contenu des dossiers d'équipe (Dropbox Business).
## Opérations disponibles
Avec toutes les autorisations requises configurées, la boîte à outils active les opérations suivantes :
### Opérations sur les fichiers
* **Upload File** : Charger les fichiers depuis l'espace de travail de l'agent vers Dropbox avec versioning automatique.
* **Download File** : Récupérer les fichiers pour un traitement local avec prise en charge des téléchargements partiels.
* **Move File** : Déplacer les fichiers entre les dossiers avec résolution automatique des conflits.
* **Copy File** : Dupliquer les fichiers au même emplacement ou à un emplacement différent.
* **Delete File** : Supprimer les fichiers (peut être récupéré à partir des fichiers supprimés pendant 30 jours).
* **Restore File** : Récupérer les fichiers supprimés ou restaurer les versions précédentes.
* **Get File Metadata** : Récupérer les détails du fichier, y compris la taille, la date de modification, le hash du contenu.
* **Search Files** : Recherche en texte intégral dans les noms de fichiers et le contenu (si pris en charge).
* **Get Thumbnail** : Générer des vignettes d'aperçu pour les images et les documents.
### Gestion des dossiers
* **Create Folder** : Créer de nouveaux dossiers avec des hiérarchies imbriquées.
* **List Folder** : Parcourir le contenu des dossiers avec prise en charge de la pagination.
* **Move Folder** : Déplacer des structures de dossiers entières.
* **Copy Folder** : Dupliquer les dossiers avec tout leur contenu.
* **Delete Folder** : Supprimer les dossiers et tout leur contenu.
* **Get Folder Metadata** : Récupérer les propriétés et les statistiques des dossiers.
### Opérations de partage
* **Create Shared Link** : Générer des liens de partage publics ou protégés par mot de passe.
* **List Shared Links** : Afficher tous les liens de partage actifs pour les fichiers et les dossiers.
* **Revoke Shared Link** : Désactiver les liens de partage pour empêcher tout accès supplémentaire.
* **Update Link Settings** : Modifier les autorisations de lien et les dates d'expiration.
* **Create Shared Folder** : Partager les dossiers avec des utilisateurs ou des équipes spécifiques.
* **Add Folder Member** : Inviter les utilisateurs à collaborer sur les dossiers partagés.
* **Remove Folder Member** : Révoquer l'accès pour les collaborateurs de dossiers partagés.
* **Set Link Expiration** : Configurer les dates d'expiration automatique des liens.
* **Set Link Password** : Protéger les liens avec l'authentification par mot de passe.
### Opérations avancées
* **Get File Revisions** : Accéder à l'historique des versions pour les fichiers (jusqu'à 30 jours ou plus avec l'historique étendu).
* **Batch Operations** : Effectuer plusieurs opérations sur les fichiers en un seul appel API.
* **Upload Session** : Charger les fichiers volumineux (>150 Mo) à l'aide de sessions de chargement en chunks.
* **Download Zip** : Télécharger plusieurs fichiers en tant qu'archive compressée.
* **Get Space Usage** : Vérifier l'utilisation du stockage et l'espace disponible du compte.
* **Paper Doc Operations** : Créer et modifier les documents Dropbox Paper.
### Fonctionnalités Dropbox Business
* **Team Folder Access** : Accéder et gérer les dossiers d'équipe.
* **Member Management** : Lister les membres de l'équipe et leurs autorisations.
* **Admin Operations** : Effectuer les tâches administratives (nécessite des autorisations d'administrateur).
## Options de configuration
* **Default Folder** : Définir l'emplacement de chargement par défaut dans Dropbox.
* **Conflict Resolution** : Choisir le comportement pour les conflits de noms de fichiers (autorename, overwrite, fail).
* **Chunk Size** : Configurer la taille des chunks de chargement pour les fichiers volumineux (4 Mo par défaut).
* **Link Permissions** : Autorisations par défaut pour les liens de partage (affichage uniquement, édition).
* **Auto Delete** : Supprimer automatiquement les fichiers locaux après un chargement réussi.
## Cas d'utilisation
* **Stockage de fichiers** : Sauvegarder les documents et les données importants de l'espace de travail de l'agent vers le cloud.
* **Automatisation des sauvegardes** : Planifier les sauvegardes automatiques des fichiers critiques vers Dropbox.
* **Partage de fichiers** : Générer des liens de partage pour les rapports, les documents ou les ensembles de données pour l'accès des parties prenantes.
* **Flux de travail collaboratifs** : Charger les fichiers vers les dossiers d'équipe partagés pour la collaboration.
* **Distribution de documents** : Distribuer les rapports générés à plusieurs destinataires via les liens partagés.
* **Migration de données** : Transférer les fichiers entre les systèmes de stockage en utilisant Dropbox comme intermédiaire.
* **Contrôle de version** : Tirer parti de la gestion des versions automatique de Dropbox pour la gestion des documents.
* **Bibliothèque multimédia** : Stocker et organiser les images, les vidéos et les ressources multimédias.
## Meilleures pratiques
* **Utiliser les identificateurs de chemin** : Référencer les fichiers par chemin (insensible à la casse) pour la stabilité.
* **Chargements en chunks** : Toujours utiliser les sessions de chargement pour les fichiers de plus de 150 Mo.
* **Demandes par lot** : Regrouper plusieurs opérations pour réduire les appels API (jusqu'à 1 000 opérations par lot).
* **Surveiller les limites de débit** : Dropbox applique des limites de débit ; implémenter le backoff exponentiel pour les nouvelles tentatives.
* **Expiration des liens** : Définir les dates d'expiration sur les liens de partage pour le contenu sensible.
* **Organiser les dossiers** : Utiliser des hiérarchies de dossiers claires pour garder les fichiers organisés.
* **Vérifier l'espace** : Vérifier l'espace de stockage disponible avant les chargements importants pour éviter les défaillances.
## Limites de débit et quotas
L'API Dropbox applique une limitation du débit en fonction du type d'application et du niveau de compte. Limites standard : 40 requêtes/seconde pour les utilisateurs individuels. Les opérations par lot comptent comme une seule requête. Surveiller les réponses HTTP 429 et implémenter la logique de nouvelle tentative avec backoff exponentiel (suggéré : 1s, 2s, 4s, 8s).
## Problèmes courants et solutions
* **Path Not Found** : Vérifier l'orthographe du chemin et la casse (les chemins Dropbox sont insensibles à la casse mais sensibles à la casse).
* **Insufficient Space** : Vérifier le stockage du compte avant les chargements. Mettre à jour le plan si nécessaire.
* **Rate Limit Exceeded** : Implémenter le backoff exponentiel et envisager d'utiliser les opérations par lot.
* **Upload Timeout** : Utiliser les sessions de chargement en chunks pour les fichiers volumineux pour gérer les interruptions réseau.
* **Permission Denied** : Vérifier que les étendues OAuth incluent les autorisations nécessaires pour l'opération.