Drive
Le stockage de fichiers derrière chaque projet, votre compte et les ressources de build propres à Studio, et comment accéder à chacun via l'API.
Drive n'est pas un seul stockage de fichiers, mais trois, chacun avec la même forme d'opérations mais sa propre portée. Chaque nom de méthode indique sur lequel elle agit par son suffixe.
Un appel _workspace ou _studio prend l'app_id du projet ; un appel _user n'en prend pas, il désigne toujours le
Drive du compte de l'appelant.
Méthodes
Opérations de base, une famille à la fois
Chaque portée dispose des mêmes opérations, seul le suffixe change :
Lister et inspecter
get_drive_files_<scope> liste le contenu d'un dossier ; get_drive_file_info_<scope> lit les détails d'un élément.
Téléverser et organiser
upload_drive_file_<scope> téléverse un fichier ; create_drive_folder_<scope> crée un dossier ;
rename_drive_file_<scope> / rename_drive_folder_<scope> renomme l'un ou l'autre ;
move_drive_files_<scope> et copy_drive_files_<scope> déplacent ou copient un lot d'éléments (portées user et
workspace) entre des dossiers.
Corbeille, restauration, purge
Sur les portées user et workspace, trash_drive_files_<scope> supprime en douceur, get_trashed_files_<scope> liste
ce qui se trouve dans la corbeille, restore_trashed_files_<scope> remet un élément en place et
purge_trashed_files_<scope> le supprime définitivement. La portée studio n'a pas d'étape de corbeille :
delete_drive_files_studio et delete_file_bulk_studio suppriment directement, comme le font delete_drive_files_<scope>
et delete_file_bulk_<scope> sur chaque portée pour une suppression définitive.
Partager, mettre en favori, étiqueter
update_drive_file_sharing_mode_<scope> change qui peut ouvrir un fichier ; star_drive_file_<scope> active ou
désactive un favori ; update_drive_file_tags_<scope> définit les étiquettes d'un fichier ;
get_shared_with_me_files_user liste ce que d'autres personnes ont partagé avec vous.
Stockage
get_drive_size_<scope> renvoie le total d'octets utilisés ; get_drive_breakdown_<scope> (portées user et
workspace) répartit l'usage par type de fichier, plus les groupes de fichiers en double.
upload_drive_file_workspace et ses équivalents prennent le fichier lui-même comme téléversement, et non comme champ
JSON : la requête est un formulaire multipart plutôt qu'un corps JSON simple comme pour la plupart des méthodes.