Saltar para o conteúdo
Verificado

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.

Carregar um ficheiro

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.