Drive
O armazenamento de ficheiros por trás de cada projeto, da sua conta e dos recursos de compilação do próprio Studio, e como aceder a cada um pela API.
O Drive não é um armazenamento de ficheiros, são três, cada um com a mesma forma de operações mas o seu próprio âmbito. Cada nome de método diz sobre qual atua, com o seu próprio sufixo.
Uma chamada _workspace ou _studio recebe o app_id do projeto; uma chamada _user não, significa sempre
o drive da própria conta de quem chama.
Métodos
Operações principais, uma família de cada vez
Cada âmbito tem as mesmas operações, só muda o sufixo:
Listar e inspecionar
get_drive_files_<scope> lista o conteúdo de uma pasta; get_drive_file_info_<scope> lê os detalhes
de um item.
Carregar e organizar
upload_drive_file_<scope> carrega um ficheiro; create_drive_folder_<scope> cria uma pasta;
rename_drive_file_<scope> / rename_drive_folder_<scope> muda o nome de qualquer um;
move_drive_files_<scope> e copy_drive_files_<scope> movem ou copiam um lote de itens
(âmbitos user e workspace) entre pastas.
Reciclagem, restauro, eliminação definitiva
Nos âmbitos user e workspace, trash_drive_files_<scope> elimina de forma recuperável,
get_trashed_files_<scope> lista o que está na reciclagem, restore_trashed_files_<scope> repõe um
item e purge_trashed_files_<scope> remove-o de vez. O âmbito studio não tem passo de reciclagem,
delete_drive_files_studio e delete_file_bulk_studio eliminam de imediato, da mesma forma que
delete_drive_files_<scope> e delete_file_bulk_<scope> o fazem em todos os âmbitos para uma
remoção permanente.
Partilhar, marcar com estrela, etiquetar
update_drive_file_sharing_mode_<scope> altera quem pode abrir um ficheiro;
star_drive_file_<scope> alterna um marcador; update_drive_file_tags_<scope> define as etiquetas de um ficheiro;
get_shared_with_me_files_user lista o que outras pessoas partilharam consigo.
Armazenamento
get_drive_size_<scope> devolve o total de bytes usados; get_drive_breakdown_<scope> (âmbitos user e
workspace) divide a utilização por tipo de ficheiro e por grupos de ficheiros duplicados.
upload_drive_file_workspace e os seus semelhantes recebem o próprio ficheiro como carregamento, não como campo
JSON, o pedido é um formulário multipart e não um corpo JSON simples como na maioria dos métodos.