Tout ce que font les écrans de Drive avec vos fichiers peut se faire depuis du code. Chaque action a une méthode dont le nom se termine par _user, ce qui désigne toujours le Drive de votre propre compte. Les mêmes actions existent avec les terminaisons _workspace et _studio, pour le Drive d'un espace de travail et pour les fichiers de construction de Studio : ce sont d'autres surfaces, et la liste complète se trouve à la fin.
Chaque appel est un POST vers /cpi/<method> avec un corps JSON qui contient votre clé d'API :
curl -X POST https://xuda.ai/cpi/get_drive_files_user \
-H "Content-Type: application/json" \
-d '{"api_key":"YOUR_API_KEY","path":"/","sort_by":"date","sort_dir":"desc"}'
La réponse contient les dossiers et les fichiers du chemin demandé. Un fichier ou un dossier est désigné par son file_path et son type, qui vaut file ou directory.
Ce que fait chaque écran, sous forme d'appel
| Dans Drive | Méthode |
|---|---|
| Ouvrir un dossier, rechercher, Favoris, Récent | get_drive_files_user : path est obligatoire. search_string, tags, sort_by, sort_dir, starred et recent affinent et ordonnent. |
| Partagé avec moi | get_shared_with_me_files_user |
| Téléverser un fichier | upload_drive_file_user |
| Vérification d'un nom en double avant un téléversement | check_drive_file_user et check_drive_files_user |
| Nouveau dossier | create_drive_folder_user : path et folder_name. |
| Renommer | rename_drive_file_user avec file_path et file_name_to, et rename_drive_folder_user avec curr_path et new_path. |
| Déplacer vers… et Coller après Couper | move_drive_files_user : files_arr et dest_path. |
| Copier et Coller | copy_drive_files_user : files_arr et dest_path. |
| Ajouter aux favoris | star_drive_file_user : type, file_path et starred. |
| Étiquettes | update_drive_file_tags_user : type, file_path et tags. |
| Fichier public | update_drive_file_sharing_mode_user : is_public. |
| Infos | get_drive_file_info_user |
| Extraire | extract_drive_file_user |
| Mettre à la corbeille | trash_drive_files_user : files_arr de { "type", "file_path" }. |
| Corbeille, Restaurer, Supprimer définitivement | get_trashed_files_user, restore_trashed_files_user et purge_trashed_files_user. Les deux derniers prennent trash_roots, les identifiants que donne la liste de la corbeille. |
| Fenêtre Stockage | get_drive_size_user pour les octets utilisés, et get_drive_breakdown_user pour la répartition par type et les doublons. |
| Versions d'un fichier | get_drive_file_versions_user les liste, de la plus récente à la plus ancienne, et keep_drive_file_version_user conserve ce que le fichier contient maintenant comme version avant que vous en écriviez une autre dedans. |
Mettre à la corbeille est une suppression douce. Un fichier revient avec restore_trashed_files_user jusqu'à ce qu'il soit purgé. delete_drive_files_user supprime définitivement sans passer par la Corbeille.
Travailler dans ce qui est partagé avec vous
La plupart des méthodes _user prennent un share_id facultatif. Donnez le share_id d'une ligne de Partagé avec moi et l'appel travaille dans le Drive de la personne qui partage, au niveau que le partage vous donne, sur l'élément partagé ou à l'intérieur d'un dossier partagé uniquement : Lecture liste et ouvre, Lecture et écriture renomme, téléverse et déplace aussi à l'intérieur, Admin met aussi à la corbeille, supprime et rend public.
Partage
La liste des personnes avec qui un fichier est partagé n'est pas une méthode Drive. La fenêtre de partage d'un fichier appelle create_share et get_shares avec access_type à user_drive et le chemin du fichier comme share_item_id. share_level vaut read, readwrite ou admin.
Toutes les méthodes Drive
check_drive_file_studioCheck Drive File StudioCheck Drive File StudioChecks whether a file or folder already exists in the studio drive.4 fieldsadmincheck_drive_file_userCheck Drive File UserCheck Drive File UserChecks whether a file or folder already exists in the user drive.4 fieldsusercheck_drive_file_workspaceCheck Drive File WorkspaceCheck Drive File WorkspaceChecks whether a file or folder already exists in the workspace drive.4 fieldsadmincheck_drive_files_studioCheck Drive Files StudioCheck Drive Files StudioChecks whether multiple files or folders already exist in the studio drive.5 fieldsadmincheck_drive_files_userCheck Drive Files UserCheck Drive Files UserChecks whether multiple files or folders already exist in the user drive.5 fieldsusercheck_drive_files_workspaceCheck Drive Files WorkspaceCheck Drive Files WorkspaceChecks whether multiple files or folders already exist in the workspace drive.5 fieldsadmincopy_drive_files_userCopy Drive Files UserCopy Drive Files UserCopies drive files/folders (with their full subtree, duplicating the stored bytes) into another folder in the user drive.3 fieldsusercopy_drive_files_workspaceCopy Drive Files WorkspaceCopy Drive Files WorkspaceCopies drive files/folders (with their full subtree, duplicating the stored bytes) into another folder in the workspace drive.3 fieldsadmincreate_drive_folder_studioCreate Drive Folder StudioCreate Drive Folder StudioCreates drive folder for studio drive.5 fieldsadmincreate_drive_folder_userCreate Drive Folder UserCreate Drive Folder UserCreates drive folder for user drive.5 fieldsusercreate_drive_folder_workspaceCreate Drive Folder WorkspaceCreate Drive Folder WorkspaceCreates drive folder for workspace drive.5 fieldsadmindelete_drive_files_studioDelete Drive Files StudioDelete Drive Files StudioDeletes drive files from studio drive.2 fieldsadmindelete_drive_files_userDelete Drive Files UserDelete Drive Files UserDeletes drive files from user drive.3 fieldsuserdelete_drive_files_workspaceDelete Drive Files WorkspaceDelete Drive Files WorkspaceDeletes drive files from workspace drive.2 fieldsadmindelete_file_bulk_studioDelete File Bulk StudioDelete File Bulk StudioDeletes multiple files from the studio drive.2 fieldsadmindelete_file_bulk_userDelete File Bulk UserDelete File Bulk UserDeletes multiple files from the user drive.1 fielduserdelete_file_bulk_workspaceDelete File Bulk WorkspaceDelete File Bulk WorkspaceDeletes multiple files from the workspace drive.2 fieldsadminextract_drive_file_studioExtract Drive File StudioExtract Drive File StudioUnzips an archive file in place: each entry in the archive becomes a new file or folder at the same drive location as the archive.2 fieldsadminextract_drive_file_userExtract Drive File UserExtract Drive File UserUnzips an archive file in place: each entry in the archive becomes a new file or folder at the same drive location as the archive.3 fieldsuserextract_drive_file_workspaceExtract Drive File WorkspaceExtract Drive File WorkspaceUnzips an archive file in place: each entry in the archive becomes a new file or folder at the same drive location as the archive.2 fieldsadminget_drive_breakdown_userGet Drive Breakdown UserGet Drive Breakdown UserStorage breakdown by file type + duplicate groups for the drive. (user drive)No fieldsuserget_drive_breakdown_workspaceGet Drive Breakdown WorkspaceGet Drive Breakdown WorkspaceStorage breakdown by file type + duplicate groups for the drive. (workspace drive)1 fieldadminget_drive_file_info_studioGet Drive File Info StudioGet Drive File Info StudioRetrieves drive file information for studio drive.3 fieldsadminget_drive_file_info_userGet Drive File Info UserGet Drive File Info UserRetrieves drive file information for user drive.4 fieldsuserget_drive_file_info_workspaceGet Drive File Info WorkspaceGet Drive File Info WorkspaceRetrieves drive file information for workspace drive.3 fieldsadminget_drive_file_versions_userGet Drive File Versions UserGet Drive File Versions UserLists a user drive file's versions, newest first: its AI edits and what it held before each Replace, each with its link, out of every listing.2 fieldsuserget_drive_files_studioGet Drive Files StudioGet Drive Files StudioRetrieves drive files for studio drive.12 fieldsadminget_drive_files_userGet Drive Files UserGet Drive Files UserRetrieves drive files for user drive.12 fieldsuserget_drive_files_workspaceGet Drive Files WorkspaceGet Drive Files WorkspaceRetrieves drive files for workspace drive.12 fieldsadminget_drive_size_studioGet Drive Size StudioGet Drive Size StudioReturns the total storage used (bytes) by the studio drive.1 fieldadminget_drive_size_userGet Drive Size UserGet Drive Size UserReturns the total storage used (bytes) by the user drive.No fieldsuserget_drive_size_workspaceGet Drive Size WorkspaceGet Drive Size WorkspaceReturns the total storage used (bytes) by the workspace drive.1 fieldadminget_shared_with_me_files_userGet Shared With Me FilesGet Shared With Me FilesLists drive files and folders shared with the current user.1 fielduserget_trashed_files_userGet Trashed Files UserGet Trashed Files UserLists trashed items (trash roots) for the drive. (user drive)No fieldsuserget_trashed_files_workspaceGet Trashed Files WorkspaceGet Trashed Files WorkspaceLists trashed items (trash roots) for the drive. (workspace drive)1 fieldadminkeep_drive_file_version_userKeep Drive File Version UserKeep Drive File Version UserKeeps what a user drive file holds now as one of its versions (out of every listing), before another version is written into it.2 fieldsusermove_drive_files_userMove Drive Files UserMove Drive Files UserMoves drive files/folders (with their full subtree) into another folder in the user drive.3 fieldsusermove_drive_files_workspaceMove Drive Files WorkspaceMove Drive Files WorkspaceMoves drive files/folders (with their full subtree) into another folder in the workspace drive.3 fieldsadminpurge_trashed_files_userPurge Trashed Files UserPurge Trashed Files UserPermanently deletes trashed batches (docs tombstoned, bytes cleaned). (user drive)1 fielduserpurge_trashed_files_workspacePurge Trashed Files WorkspacePurge Trashed Files WorkspacePermanently deletes trashed batches (docs tombstoned, bytes cleaned). (workspace drive)2 fieldsadminrename_drive_file_studioRename Drive File StudioRename Drive File StudioRenames drive file in studio drive.3 fieldsadminrename_drive_file_userRename Drive File UserRename Drive File UserRenames drive file in user drive.3 fieldsuserrename_drive_file_workspaceRename Drive File WorkspaceRename Drive File WorkspaceRenames drive file in workspace drive.3 fieldsadminrename_drive_folder_studioRename Drive Folder StudioRename Drive Folder StudioRenames drive folder in studio drive.3 fieldsadminrename_drive_folder_userRename Drive Folder UserRename Drive Folder UserRenames drive folder in user drive.3 fieldsuserrename_drive_folder_workspaceRename Drive Folder WorkspaceRename Drive Folder WorkspaceRenames drive folder in workspace drive.3 fieldsadminrestore_trashed_files_userRestore Trashed Files UserRestore Trashed Files UserRestores trashed batches back into the drive. (user drive)1 fielduserrestore_trashed_files_workspaceRestore Trashed Files WorkspaceRestore Trashed Files WorkspaceRestores trashed batches back into the drive. (workspace drive)2 fieldsadminstar_drive_file_studioStar Drive File StudioStar Drive File StudioToggles the starred bookmark on a studio drive item.4 fieldsadminstar_drive_file_userStar Drive File UserStar Drive File UserToggles the starred bookmark on a user drive item.3 fieldsuserstar_drive_file_workspaceStar Drive File WorkspaceStar Drive File WorkspaceToggles the starred bookmark on a workspace drive item.4 fieldsadmintrash_drive_files_userTrash Drive Files UserTrash Drive Files UserMoves drive items (with their subtree) to the trash: soft delete, restorable. (user drive)2 fieldsusertrash_drive_files_workspaceTrash Drive Files WorkspaceTrash Drive Files WorkspaceMoves drive items (with their subtree) to the trash: soft delete, restorable. (workspace drive)2 fieldsadminupdate_drive_addons_studioUpdate Drive Addons StudioUpdate Drive Addons StudioUpdates drive addons for studio drive.5 fieldsadminupdate_drive_addons_userUpdate Drive Addons UserUpdate Drive Addons UserUpdates the drive addon toggles (OCR, image convertor, video AI, AI component generator, edit image) on the user's account drive.4 fieldsuserupdate_drive_addons_workspaceUpdate Drive Addons WorkspaceUpdate Drive Addons WorkspaceUpdates drive addons for workspace drive.5 fieldsadminupdate_drive_file_sharing_mode_studioUpdate Drive File Sharing Mode StudioUpdate Drive File Sharing Mode StudioUpdates drive file sharing mode for studio drive.4 fieldsadminupdate_drive_file_sharing_mode_userUpdate Drive File Sharing Mode UserUpdate Drive File Sharing Mode UserUpdates drive file sharing mode for user drive.4 fieldsuserupdate_drive_file_sharing_mode_workspaceUpdate Drive File Sharing Mode WorkspaceUpdate Drive File Sharing Mode WorkspaceUpdates drive file sharing mode for workspace drive.4 fieldsadminupdate_drive_file_studioUpdate Drive File StudioUpdate Drive File StudioUpdates drive file for studio drive.2 fieldsadminupdate_drive_file_tags_studioUpdate Drive File Tags StudioUpdate Drive File Tags StudioUpdates drive file tags for studio drive.4 fieldsadminupdate_drive_file_tags_userUpdate Drive File Tags UserUpdate Drive File Tags UserUpdates drive file tags for user drive.4 fieldsuserupdate_drive_file_tags_workspaceUpdate Drive File Tags WorkspaceUpdate Drive File Tags WorkspaceUpdates drive file tags for workspace drive.4 fieldsadminupdate_drive_file_userUpdate Drive File UserUpdate Drive File UserUpdates drive file for user drive.2 fieldsuserupdate_drive_file_workspaceUpdate Drive File WorkspaceUpdate Drive File WorkspaceUpdates drive file for workspace drive.2 fieldsadminupload_drive_file_studioUpload Drive File StudioUpload Drive File StudioUploads drive file to studio drive.1 fieldadminupload_drive_file_userUpload Drive File UserUpload Drive File UserUploads drive file to user drive.1 fielduserupload_drive_file_workspaceUpload Drive File WorkspaceUpload Drive File WorkspaceUploads drive file to workspace drive.3 fieldsadmin
Forfaits
Un téléversement n'est pas refusé faute d'espace. Consultez Forfaits et facturation pour ce qui compte dans votre espace et ce qui se passe au-delà.