Tudo o que os ecrãs do Drive fazem com os seus ficheiros pode ser feito a partir de código. Cada ação tem um método cujo nome termina em _user, o que significa sempre o Drive da sua própria conta. As mesmas ações existem com terminações _workspace e _studio para o Drive de uma área de trabalho e para os ficheiros de construção do Studio: são outras superfícies, e a lista completa está no fim.
Cada chamada é um POST para /cpi/<method> com um corpo JSON que leva a sua chave de 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"}'
A resposta são as pastas e os ficheiros do caminho que pediu. Um ficheiro ou pasta é identificado pelo seu file_path e pelo seu type, que é file ou directory.
O que cada ecrã faz, como uma chamada
| No Drive | Método |
|---|---|
| Abrir uma pasta, pesquisar, Com estrela, Recentes | get_drive_files_user: path é obrigatório. search_string, tags, sort_by, sort_dir, starred e recent restringem-no e ordenam-no. |
| Partilhado comigo | get_shared_with_me_files_user |
| Carregar um ficheiro | upload_drive_file_user |
| Verificação de nome duplicado antes de um carregamento | check_drive_file_user e check_drive_files_user |
| Nova pasta | create_drive_folder_user: path e folder_name. |
| Mudar o nome | rename_drive_file_user com file_path e file_name_to, e rename_drive_folder_user com curr_path e new_path. |
| Mover para… e Colar de um corte | move_drive_files_user: files_arr e dest_path. |
| Copiar e Colar | copy_drive_files_user: files_arr e dest_path. |
| Adicionar aos Favoritos | star_drive_file_user: type, file_path e starred. |
| Etiquetas | update_drive_file_tags_user: type, file_path e tags. |
| Ficheiro público | update_drive_file_sharing_mode_user: is_public. |
| Informação | get_drive_file_info_user |
| Extrair | extract_drive_file_user |
| Mover para o lixo | trash_drive_files_user: files_arr de { "type", "file_path" }. |
| Lixo, Restaurar, Eliminar definitivamente | get_trashed_files_user, restore_trashed_files_user e purge_trashed_files_user. Os dois últimos recebem trash_roots, os ids que a lista do lixo dá. |
| Janela Armazenamento | get_drive_size_user para os bytes usados, e get_drive_breakdown_user para a divisão por tipo e os duplicados. |
| Versões de um ficheiro | get_drive_file_versions_user lista-as, da mais recente para a mais antiga, e keep_drive_file_version_user guarda o que o ficheiro contém agora como uma versão antes de escrever outra nele. |
Mover para o Lixo é uma eliminação suave. Um ficheiro volta com restore_trashed_files_user até ser purgado. delete_drive_files_user elimina definitivamente sem passar pelo Lixo.
Trabalhar dentro de algo partilhado consigo
A maioria dos métodos _user recebe um share_id opcional. Dê o share_id de uma linha de Partilhado comigo e a chamada funciona no Drive de quem partilhou, ao nível que a partilha lhe dá, apenas no item partilhado ou dentro de uma pasta partilhada: Leitura lista e abre, Leitura e escrita também muda nomes, carrega e move lá dentro, Administrador também envia para o lixo, elimina e torna público.
Partilha
Com quem um ficheiro é partilhado não é um método do Drive. A janela de partilha de um ficheiro chama create_share e get_shares com access_type definido como user_drive e o caminho do ficheiro como share_item_id. share_level é read, readwrite ou admin.
Todos os métodos do 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
Planos
Um carregamento não é recusado por falta de espaço. Veja Planos e faturação para saber o que conta para o seu espaço e o que acontece além dele.