Google Drive API

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

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

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

מסמך Discovery

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

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

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

  • https://www.googleapis.com

משאב REST: ‏ v3.about

Methods
get GET /drive/v3/about
מקבל מידע על המשתמש, על Drive של המשתמש ועל היכולות של המערכת.

משאב REST: ‏ v3.accessproposals

Methods
get GET /drive/v3/files/{fileId}/accessproposals/{proposalId}
מאחזר הצעה לגישה לפי מזהה.
list GET /drive/v3/files/{fileId}/accessproposals
הצגת ההצעות לגישה לקובץ.
resolve POST /drive/v3/files/{fileId}/accessproposals/{proposalId}:resolve
אישור או דחייה של הצעה לגישה.

משאב REST: ‏ v3.apps

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

משאב REST: ‏ v3.changes

Methods
getStartPageToken GET /drive/v3/changes/startPageToken
מקבל את pageToken של הדף הראשון כדי להציג שינויים עתידיים.
list GET /drive/v3/changes
מציג את השינויים שבוצעו על ידי משתמש או בתיקיית אחסון שיתופי.
watch POST /drive/v3/changes/watch
הרשמה לקבלת עדכונים על שינויים שמתבצעים אצל משתמש.

משאב REST: ‏ v3.channels

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

משאב REST: ‏ v3.comments

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

משאב REST: ‏ v3.drives

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

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

משאב REST: ‏ v3.files

Methods
copy POST /drive/v3/files/{fileId}/copy
יוצר עותק של קובץ ומחיל עליו עדכונים לפי בקשה, עם סמנטיקה של תיקון.
create POST /drive/v3/files
POST /upload/drive/v3/files

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

אחזור מטא-נתונים או תוכן של קובץ לפי מזהה.
list GET /drive/v3/files

רשימה של הקבצים של המשתמש.
listLabels GET /drive/v3/files/{fileId}/listLabels
רשימת התוויות בקובץ.
modifyLabels POST /drive/v3/files/{fileId}/modifyLabels
משנה את קבוצת התוויות שמוחלות על קובץ.
update PATCH /drive/v3/files/{fileId}
PATCH /upload/drive/v3/files/{fileId}

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

משאב REST: ‏ v3.operations

Methods
get GET /drive/v3/operations/{name}
אחזור המצב העדכני של פעולה ממושכת.

משאב REST: ‏ v3.permissions

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

משאב REST: ‏ v3.replies

Methods
create POST /drive/v3/files/{fileId}/comments/{commentId}/replies
יוצר תשובה לתגובה.
delete DELETE /drive/v3/files/{fileId}/comments/{commentId}/replies/{replyId}
מחיקת תשובה.
get GET /drive/v3/files/{fileId}/comments/{commentId}/replies/{replyId}
אחזור תשובה לפי מזהה.
list GET /drive/v3/files/{fileId}/comments/{commentId}/replies
מציג את התשובות לתגובה.
update PATCH /drive/v3/files/{fileId}/comments/{commentId}/replies/{replyId}
מעדכן תשובה באמצעות סמנטיקה של תיקון.

משאב REST: ‏ v3.revisions

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