API Reference

הפניית API זו מאורגנת לפי סוג המשאב. לכל סוג משאב יש ייצוג נתונים אחד או יותר ושיטה אחת או יותר.

סוגי המשאבים

1. מידע על
2. שינויים
3. ערוצים
4. תגובות
5. קבצים
6. הרשאות
7. תשובות
8. תיקונים
9. נסיעות

מידע כללי

למידע על פרטי המשאבים, אפשר לעיין בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
הורדה	GET  /about	מקבל מידע על המשתמש, על ה-Drive של המשתמש ועל יכולות המערכת. פרמטרים נדרשים של שאילתה: fields

השינויים

לפרטים על 'משאב שינויים', אפשר לעיין בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
getStartPageToken	GET  /changes/startPageToken	מקבל את ה-Token של דף הפתיחה לרישום שינויים עתידיים.
list	GET  /changes	רשימת השינויים שמשויכים למשתמש או לאחסון השיתופי. פרמטרים נדרשים של שאילתה: pageToken
שעון	POST  /changes/watch	נרשם כמנוי לשינויים של משתמש. כדי להשתמש בשיטה הזו, צריך לכלול את פרמטר השאילתה pageToken.

ערוצים

תוכלו למצוא פרטים על המשאב 'ערוצים' בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
עצירה	POST  /channels/stop	הפסקת הצפייה במשאבים דרך הערוץ הזה

תגובות

תוכלו למצוא פרטים על המשאב 'תגובות' בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
יצירה	POST  /files/fileId/comments	יצירת תגובה בקובץ. פרמטרים נדרשים של שאילתה: fields
מחיקה	DELETE  /files/fileId/comments/commentId	מחיקת תגובה.
הורדה	GET  /files/fileId/comments/commentId	מתקבלת תגובה באמצעות מזהה. פרמטרים נדרשים של שאילתה: fields
list	GET  /files/fileId/comments	מפרט את התגובות בקובץ. פרמטרים נדרשים של שאילתה: fields
עדכון	PATCH  /files/fileId/comments/commentId	עדכון תגובה עם סמנטיקה של תיקון. פרמטרים נדרשים של שאילתה: fields

קבצים

כדי לקבל פרטים על מקור המשאבים, אפשר להיכנס לדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
העתקה	POST  /files/fileId/copy	יוצר עותק של קובץ ומחיל את כל העדכונים המבוקשים עם סמנטיקה של תיקון. לא ניתן להעתיק את התיקיות.
יצירה	POST https://www.googleapis.com/upload/drive/v3/files וגם POST  /files	יצירת קובץ.
מחיקה	DELETE  /files/fileId	מחיקה לצמיתות של קובץ שבבעלות המשתמש בלי להעביר אותו לאשפה. אם הקובץ שייך לאחסון שיתופי, המשתמש חייב להיות מארגן בהורה. אם היעד הוא תיקייה, כל הצאצאים שבבעלותו יימחקו גם כן.
EmptyTrash	DELETE  /files/trash	כל הקבצים באשפה של המשתמש יימחקו באופן סופי.
ייצוא	GET  /files/fileId/export	מייצא מסמך Google Workspace לסוג MIME המבוקש ומחזיר תוכן של בייטים שיוצאו. חשוב לזכור שהתוכן המיוצא מוגבל ל-10MB. פרמטרים נדרשים של שאילתה: mimeType
createIds	GET  /files/generateIds	הסקריפט יוצר קבוצה של מזהי קבצים שניתן לשלוח בבקשות יצירה או העתקה.
הורדה	GET  /files/fileId	מקבל מטא נתונים או תוכן של קובץ לפי מזהה.
list	GET  /files	למצוא רשימות או לחפש קבצים.
עדכון	PATCH https://www.googleapis.com/upload/drive/v3/files/fileId וגם PATCH  /files/fileId	עדכון המטא-נתונים ו/או התוכן של הקובץ. כשמתקשרים לשיטה הזו, צריך למלא רק שדות בבקשה שרוצים לשנות. כשמעדכנים שדות, חלק מהשדות עשויים להשתנות באופן אוטומטי, כמו 'תאריך שינוי'. שיטה זו תומכת בסמנטיקה של תיקון.
שעון	POST  /files/fileId/watch	הרשמה לשינויים בקובץ. אפשר ליצור ערוץ שהשינויים בו יישמרו באחסון שיתופי, אבל שינוי הקובץ באחסון השיתופי לא ייצור התראה.
listlabels	GET  /files/fileId/listLabels	פירוט התוויות בקובץ.
שינוי תוויות	POST  /files/fileId/modifyLabels	שינוי קבוצת התוויות בקובץ.

הרשאות

לפרטים על משאב ההרשאות, עיינו בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
יצירה	POST  /files/fileId/permissions	יצירת הרשאה לקובץ או לאחסון שיתופי מידע נוסף על יצירת הרשאות זמין במאמר שיתוף קבצים, תיקיות ואחסון.
מחיקה	DELETE  /files/fileId/permissions/permissionId	מוחק הרשאה.
הורדה	GET  /files/fileId/permissions/permissionId	מקבלת הרשאה לפי מזהה.
list	GET  /files/fileId/permissions	מפרט את ההרשאות של קובץ או של אחסון שיתופי.
עדכון	PATCH  /files/fileId/permissions/permissionId	עדכון ההרשאה עם הסמנטיקה של התיקון.

תשובות

תוכלו למצוא פרטים על המשאב 'תשובות' בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
יצירה	POST  /files/fileId/comments/commentId/replies	יצירת תשובה לתגובה. פרמטרים נדרשים של שאילתה: fields
מחיקה	DELETE  /files/fileId/comments/commentId/replies/replyId	מחיקת תשובה.
הורדה	GET  /files/fileId/comments/commentId/replies/replyId	מקבלים תשובה לפי מזהה. פרמטרים נדרשים של שאילתה: fields
list	GET  /files/fileId/comments/commentId/replies	מפרט את התשובות לתגובה. פרמטרים נדרשים של שאילתה: fields
עדכון	PATCH  /files/fileId/comments/commentId/replies/replyId	עדכון תשובה עם סמנטיקה של תיקון. פרמטרים נדרשים של שאילתה: fields

גרסאות קודמות

תוכלו למצוא פרטים על המשאב 'תיקונים' בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
מחיקה	DELETE  /files/fileId/revisions/revisionId	מחיקה סופית של גרסת קובץ. אפשר למחוק גרסאות קודמות של קבצים עם תוכן בינארי ב-Google Drive, כמו תמונות או סרטונים. לא ניתן למחוק גרסאות קודמות של קבצים אחרים, כמו Google Docs או Sheets, וגם את גרסת הקובץ האחרונה שנותרה.
הורדה	GET  /files/fileId/revisions/revisionId	מקבל מטא-נתונים או תוכן של גרסה קודמת לפי מזהה.
list	GET  /files/fileId/revisions	רשימת גרסאות קודמות של קובץ.
עדכון	PATCH  /files/fileId/revisions/revisionId	עדכון גרסה קודמת עם סמנטי תיקון.

כוננים

תוכלו למצוא פרטים על המשאבים ב-Drive בדף ייצוג משאבים.

‏Method	בקשת HTTP	תיאור
כתובות URI ביחס ל-https://www.googleapis.com/drive/v3, אלא אם צוין אחרת
יצירה	POST  /drives	יצירה של אחסון שיתופי. פרמטרים נדרשים של שאילתה: requestId
מחיקה	DELETE  /drives/driveId	מחיקה לצמיתות של אחסון שיתופי שהמשתמש מוגדר כמארגן שלו. האחסון השיתופי לא יכול להכיל פריטים שלא הועברו לאשפה.
הורדה	GET  /drives/driveId	מתקבלים המטא-נתונים של האחסון השיתופי לפי מזהה.
הסתרה	POST  /drives/driveId/hide	הסתרת אחסון שיתופי מתצוגת ברירת המחדל.
list	GET  /drives	רשימה של תיקיות האחסון השיתופי של המשתמש.
ביטול הסתרה	POST  /drives/driveId/unhide	שחזור של אחסון שיתופי לתצוגת ברירת המחדל.
עדכון	PATCH  /drives/driveId	עדכון המטא-נתונים של האחסון השיתופי.