Drive
מאגר הקבצים שמאחורי כל פרויקט, החשבון שלכם ונכסי הבנייה של Studio, ואיך מגיעים לכל אחד מהם דרך ה-API.
Drive הוא לא מאגר קבצים אחד אלא שלושה, לכל אחד אותה צורה של פעולות אבל טווח משלו. כל שם שיטה אומר על איזה מהם הוא פועל בעזרת הסיומת שלו.
קריאה ל-_workspace או ל-_studio מקבלת את ה-app_id של הפרויקט. קריאה ל-_user לא, והיא תמיד מתייחסת לדרייב של החשבון של הקורא.
שיטות
פעולות הליבה, משפחה אחת בכל פעם
כל טווח נושא את אותן פעולות, ורק הסיומת משתנה:
רשימה ובדיקה
get_drive_files_<scope> מציגה את תוכן תיקייה. get_drive_file_info_<scope> קוראת את הפרטים של פריט אחד.
העלאה וארגון
upload_drive_file_<scope> מעלה קובץ. create_drive_folder_<scope> יוצרת תיקייה. rename_drive_file_<scope> / rename_drive_folder_<scope> משנה שם של כל אחד מהם. move_drive_files_<scope> ו-copy_drive_files_<scope> מעבירות או מעתיקות קבוצת פריטים (בטווחי המשתמש וסביבת העבודה) בין תיקיות.
פח, שחזור, מחיקה סופית
בטווחי המשתמש וסביבת העבודה, trash_drive_files_<scope> מוחקת רך, get_trashed_files_<scope> מציגה מה נמצא בפח, restore_trashed_files_<scope> מחזירה פריט, ו-purge_trashed_files_<scope> מסירה אותו לצמיתות. לטווח ה-studio אין שלב פח: delete_drive_files_studio ו-delete_file_bulk_studio מוחקות לגמרי, באותו אופן ש-delete_drive_files_<scope> ו-delete_file_bulk_<scope> עושות בכל טווח להסרה סופית.
שיתוף, כוכב, תגיות
update_drive_file_sharing_mode_<scope> משנה מי יכול לפתוח קובץ. star_drive_file_<scope> מחליפה סימניה. update_drive_file_tags_<scope> קובעת את התגיות של קובץ. get_shared_with_me_files_user מציגה מה אנשים אחרים שיתפו איתכם.
אחסון
get_drive_size_<scope> מחזירה את סך הבתים שבשימוש. get_drive_breakdown_<scope> (בטווחי המשתמש וסביבת העבודה) מפרקת את השימוש לפי סוג קובץ ולפי קבוצות של קבצים כפולים.
upload_drive_file_workspace ואחיותיה מקבלות את הקובץ עצמו כהעלאה, ולא כשדה JSON: הבקשה היא טופס multipart ולא גוף JSON פשוט כמו ברוב השיטות.