Google Drive API

ה-API של Google Drive מאפשר ללקוחות לגשת למשאבים מ-Google Drive.

שירות: googleapis.com/drive/v2

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.

מסמך Discovery

Discovery Document הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי API ל-REST. היא משמשת לבניית ספריות לקוח, תוספים ל-IDE וכלים אחרים שמתקשרים עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:

נקודת קצה של שירות

נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. יכול להיות שלשירות אחד יהיו כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה (endpoint) משלו, וכל כתובות ה-URI שבהמשך הן יחסיות לנקודת הקצה הזו:

  • https://www.googleapis.com

משאב REST: ‏ v2.about

Methods
get GET /drive/v2/about
קבלת מידע על המשתמש הנוכחי יחד עם הגדרות Drive API

משאב REST: v2.apps

Methods
get GET /drive/v2/apps/{appId}
מקבל אפליקציה ספציפית.
list GET /drive/v2/apps
מציג רשימה של האפליקציות המותקנות של משתמש.

משאב REST: ‏ v2.changes

Methods
get GET /drive/v2/changes/{changeId}
הוצא משימוש: אפשר להשתמש ב-changes.getStartPageToken וב-changes.list כדי לאחזר שינויים שבוצעו לאחרונה.
getStartPageToken GET /drive/v2/changes/startPageToken
מקבל את pageToken של הדף הראשון כדי להציג שינויים עתידיים.
list GET /drive/v2/changes
מציג את השינויים שבוצעו על ידי משתמש או בתיקיית אחסון שיתופי.
watch POST /drive/v2/changes/watch
הרשמה לקבלת עדכונים על שינויים שמתבצעים אצל משתמש.

משאב REST: ‏ v2.channels

Methods
stop POST /drive/v2/channels/stop
מפסיק לצפות במשאבים דרך הערוץ הזה.

משאב REST: v2.children

Methods
delete DELETE /drive/v2/files/{folderId}/children/{childId}
מסיר ילד מתיקייה.
get GET /drive/v2/files/{folderId}/children/{childId}
מקבל הפניה ספציפית לצאצא.
insert POST /drive/v2/files/{folderId}/children
הוספת קובץ לתיקייה.
list GET /drive/v2/files/{folderId}/children
מציג את התיקיות והקבצים בתיקייה.

משאב REST: v2.comments

Methods
delete DELETE /drive/v2/files/{fileId}/comments/{commentId}
מחיקת תגובה.
get GET /drive/v2/files/{fileId}/comments/{commentId}
אחזור תגובה לפי מזהה.
insert POST /drive/v2/files/{fileId}/comments
יצירת תגובה חדשה לקובץ הנתון.
list GET /drive/v2/files/{fileId}/comments
מציג רשימה של התגובות בקובץ.
patch PATCH /drive/v2/files/{fileId}/comments/{commentId}
מעדכן תגובה קיימת.
update PUT /drive/v2/files/{fileId}/comments/{commentId}
מעדכן תגובה קיימת.

משאב REST: ‏ v2.drives

Methods
delete DELETE /drive/v2/drives/{driveId}
מחיקה סופית של תיקייה באחסון השיתופי שהמשתמש הוא organizer שלה.
get GET /drive/v2/drives/{driveId}
אחזור מטא-נתונים של אחסון שיתופי לפי מזהה.
hide POST /drive/v2/drives/{driveId}/hide
הסתרת אחסון שיתופי מהתצוגה שמוגדרת כברירת מחדל.
insert POST /drive/v2/drives
יוצר אחסון שיתופי חדש.
list GET /drive/v2/drives

רשימת תיקיות האחסון השיתופי של המשתמש.
unhide POST /drive/v2/drives/{driveId}/unhide
משחזר אחסון שיתופי לתצוגת ברירת המחדל.
update PUT /drive/v2/drives/{driveId}
מעדכן את המטא-נתונים של האחסון השיתופי.

משאב REST: ‏ v2.files

Methods
copy POST /drive/v2/files/{fileId}/copy
יוצר עותק של הקובץ שצוין.
delete DELETE /drive/v2/files/{fileId}
מוחק באופן סופי קובץ שבבעלות המשתמש בלי להעביר אותו לאשפה.
emptyTrash DELETE /drive/v2/files/trash
מחיקה סופית של כל הקבצים של המשתמש שהועברו לאשפה.
export GET /drive/v2/files/{fileId}/export
מייצא מסמך Google Workspace לסוג ה-MIME המבוקש ומחזיר את תוכן הבייטים המיוצא.
generateIds GET /drive/v2/files/generateIds
יוצר קבוצה של מזהי קבצים שאפשר לספק בבקשות להוספה או להעתקה.
get GET /drive/v2/files/{fileId}

אחזור מטא-נתונים או תוכן של קובץ לפי מזהה.
insert POST /drive/v2/files
POST /upload/drive/v2/files

הוספה של קובץ חדש.
list GET /drive/v2/files

רשימת הקבצים של המשתמש.
listLabels GET /drive/v2/files/{fileId}/listLabels
רשימת התוויות בקובץ.
modifyLabels POST /drive/v2/files/{fileId}/modifyLabels
משנה את קבוצת התוויות שמוחלות על קובץ.
patch PATCH /drive/v2/files/{fileId}
מעדכן את המטא-נתונים או את התוכן של קובץ.
touch POST /drive/v2/files/{fileId}/touch
מגדירים את זמן העדכון של הקובץ לזמן הנוכחי בשרת.
trash POST /drive/v2/files/{fileId}/trash
מעביר קובץ לאשפה.
untrash POST /drive/v2/files/{fileId}/untrash
שחזור קובץ מהאשפה.
update PUT /drive/v2/files/{fileId}
PUT /upload/drive/v2/files/{fileId}

עדכון של המטא-נתונים, התוכן או שניהם של קובץ.
watch POST /drive/v2/files/{fileId}/watch
הרשמה לקבלת עדכונים על שינויים בקובץ.

משאב REST: ‏ v2.parents

Methods
delete DELETE /drive/v2/files/{fileId}/parents/{parentId}
מסיר הורה מקובץ.
get GET /drive/v2/files/{fileId}/parents/{parentId}
מקבל הפניה ספציפית להורה.
insert POST /drive/v2/files/{fileId}/parents
הוספת תיקיית אב לקובץ.
list GET /drive/v2/files/{fileId}/parents
מציג את התיקיות הראשיות של הקובץ.

משאב REST: ‏ v2.permissions

Methods
delete DELETE /drive/v2/files/{fileId}/permissions/{permissionId}
מחיקת הרשאה מקובץ או מאחסון שיתופי.
get GET /drive/v2/files/{fileId}/permissions/{permissionId}
מקבל הרשאה לפי מזהה.
getIdForEmail GET /drive/v2/permissionIds/{email}
מחזירה את מזהה ההרשאה של כתובת אימייל.
insert POST /drive/v2/files/{fileId}/permissions
הוספת הרשאה לקובץ או לאחסון שיתופי.
list GET /drive/v2/files/{fileId}/permissions
מציג את ההרשאות של קובץ או של אחסון שיתופי.
patch ‫PATCH /drive/v2/files/{fileId}/permissions/{permissionId}
עדכון הרשאה באמצעות סמנטיקה של תיקון.
update PUT /drive/v2/files/{fileId}/permissions/{permissionId}
עדכון הרשאה.

משאב REST: v2.properties

Methods
delete DELETE /drive/v2/files/{fileId}/properties/{propertyKey}
מחיקת נכס.
get ‫GET /drive/v2/files/{fileId}/properties/{propertyKey}
מקבל נכס לפי המפתח שלו.
insert POST /drive/v2/files/{fileId}/properties
מוסיף מאפיין לקובץ או מעדכן אותו אם הוא כבר קיים.
list GET /drive/v2/files/{fileId}/properties
מציג את המאפיינים של קובץ.
patch PATCH /drive/v2/files/{fileId}/properties/{propertyKey}
מעדכן נכס.
update PUT /drive/v2/files/{fileId}/properties/{propertyKey}
מעדכן נכס.

משאב REST: ‏ v2.replies

Methods
delete DELETE /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
מחיקת תשובה.
get GET /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
קבלת תשובה.
insert POST /drive/v2/files/{fileId}/comments/{commentId}/replies
יצירת תשובה חדשה לתגובה הנתונה.
list GET /drive/v2/files/{fileId}/comments/{commentId}/replies
מציג את כל התשובות לתגובה.
patch PATCH /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
מעדכן תשובה קיימת.
update PUT /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
מעדכן תשובה קיימת.

משאב REST: v2.revisions

Methods
delete DELETE /drive/v2/files/{fileId}/revisions/{revisionId}
מחיקה סופית של גרסת קובץ.
get GET /drive/v2/files/{fileId}/revisions/{revisionId}
מקבל גרסה ספציפית.
list GET /drive/v2/files/{fileId}/revisions
מציג את הגרסאות של הקובץ.
patch PATCH /drive/v2/files/{fileId}/revisions/{revisionId}
מעדכן גרסה.
update PUT /drive/v2/files/{fileId}/revisions/{revisionId}
מעדכן גרסה.