ב-Google Drive API יש תמיכה בכמה סוגים של פעולות הורדה וייצוא, כפי שמפורט בטבלה הבאה:
הורדת פעולות |
|
||||
ייצוא פעולות |
|
לפני שמורידים או מייצאים את תוכן הקובץ, צריך לוודא שהמשתמשים יכולים להוריד את הקובץ באמצעות השדה capabilities.canDownload
במשאב files
.
בסוגי הקבצים מוסבר על סוגי הקבצים שצוינו כאן, כולל קבצים מסוג blob וקבצים של Google Workspace.
בהמשך המדריך מפורטות הוראות לביצוע הפעולות האלה של הורדה וייצוא.
הורדת תוכן של קובץ blob
כדי להוריד קובץ blob ששמור ב-Drive, משתמשים בשיטה files.get
עם מזהה הקובץ שרוצים להוריד והפרמטר של כתובת ה-URL alt=media
. הפרמטר alt=media
של כתובת ה-URL מאפשר לשרת לדעת שהבקשה היא להורדת תוכן כפורמט תגובה חלופי.
פרמטר כתובת ה-URL alt=media
הוא פרמטר מערכת שזמין בכל ממשקי ה-API ל-REST של Google. אם אתם משתמשים בספריית לקוח של Drive API, אתם לא צריכים להגדיר את הפרמטר הזה באופן מפורש.
בדוגמת הקוד הבאה מוסבר איך להשתמש ב-method files.get
כדי להוריד קובץ באמצעות ספריות הלקוח של Drive API.
Java
Python
Node.js
PHP
.NET
בדוגמת הקוד הזו נעשה שימוש בשיטת ספרייה שמוסיפה את הפרמטר alt=media
של כתובת ה-URL לבקשת ה-HTTP הבסיסית.
הורדות של קבצים שהתחילו מהאפליקציה שלכם צריכות להיות מורשות בהיקף שמאפשר גישה לקריאה לתוכן הקובץ. לדוגמה, אפליקציה שמשתמשת בהיקף drive.readonly.metadata
לא מורשית להוריד את תוכן הקובץ.
בדוגמת הקוד הזו נעשה שימוש בהיקף הקובץ המוגבל 'drive', שמאפשר למשתמשים להציג ולנהל את כל הקבצים ב-Drive. מידע נוסף על היקפי הרשאות ב-Drive זמין במאמר בחירת היקפי הרשאות ב-Google Drive API.
משתמשים עם הרשאות עריכה יכולים להגביל את ההורדה על ידי משתמשים עם הרשאת קריאה בלבד על ידי הגדרת השדה copyRequiresWriterPermission
לערך false
.
רק הבעלים של קבצים שזוהו כפוגעניים (כמו תוכנות מזיקות) יכולים להוריד אותם.
בנוסף, צריך לכלול את הפרמטר של השאילתה get
acknowledgeAbuse=true
כדי לציין שהמשתמש הכיר בסיכון של הורדת תוכנות לא רצויות או קבצים פוגעניים אחרים. האפליקציה צריכה להזהיר את המשתמש באופן אינטראקטיבי לפני השימוש בפרמטר השאילתה הזה.
הורדה חלקית
הורדה חלקית כוללת הורדה של חלק מסוים בלבד בקובץ. כדי לציין את החלק של הקובץ שרוצים להוריד, משתמשים בטווח בייט עם הכותרת Range
. לדוגמה:
Range: bytes=500-999
הורדת תוכן של קובץ blob בגרסה קודמת
כדי להוריד את התוכן של קובצי blob בגרסה קודמת, משתמשים ב-method revisions.get
עם המזהה של הקובץ להורדה, המזהה של הגרסה והפרמטר של כתובת ה-URL alt=media
.
פרמטר ה-URL alt=media
מעדכן את השרת שהתבקשה הורדה של תוכן כפורמט תגובה חלופי. בדומה ל-files.get
, גם השיטה revisions.get
מקבלת את פרמטר השאילתה האופציונלי acknowledgeAbuse
ואת הכותרת Range
. מידע נוסף על הורדת גרסאות זמין במאמר ניהול גרסאות של קבצים.
כאן מוצג פרוטוקול הבקשה.
GET https://www.googleapis.com/drive/v3/files/{FILE_ID
}/revisions/{REVISION_ID
}?alt=media
הורדת תוכן של קובץ blob בדפדפן
כדי להוריד את התוכן של קובצי blob שמאוחסנים ב-Drive בדפדפן, במקום דרך ה-API, משתמשים בשדה webContentLink
של המשאב files
. אם למשתמש יש הרשאת הורדה לקובץ, המערכת תחזיר קישור להורדת הקובץ והתוכן שלו. אפשר להפנות משתמש לכתובת ה-URL הזו או להציע אותה כקישור שניתן ללחוץ עליו.
הורדת תוכן של קובץ blob במהלך פעולות ממושכות
כדי להוריד את התוכן של קובצי blob במהלך פעולות ממושכות, משתמשים ב-method files.download
עם המזהה של הקובץ שרוצים להוריד. אפשר גם להגדיר את המזהה של הגרסה. זוהי הדרך היחידה להוריד קבצים של Google Vids. מידע נוסף זמין במאמר ניהול פעולות ממושכות.
ייצוא תוכן של מסמכים ב-Google Workspace
כדי לייצא תוכן בייט של מסמך ב-Google Workspace, משתמשים בשיטה files.export
עם מזהה הקובץ שרוצים לייצא וסוג ה-MIME הנכון. תוכן הייצוא מוגבל ל-10MB.
בדוגמת הקוד הבאה מוסבר איך משתמשים ב-method files.export
כדי לייצא מסמך של Google Workspace בפורמט PDF באמצעות ספריות הלקוח של Drive API:
Java
Python
Node.js
PHP
.NET
בדוגמת הקוד הזו נעשה שימוש בהיקף המוגבל drive
שמאפשר למשתמשים להציג ולנהל את כל הקבצים ב-Drive. מידע נוסף על היקפי הרשאות ב-Drive זמין במאמר בחירת היקפי הרשאות ב-Google Drive API.
בקוד לדוגמה מוגדר גם סוג ה-MIME של הייצוא כ-application/pdf
. בקישור הבא תוכלו למצוא רשימה מלאה של כל סוגי ה-MIME הנתמכים לייצוא של כל מסמך ב-Google Workspace: סוגי MIME לייצוא של מסמכים ב-Google Workspace.
ייצוא תוכן של מסמך ב-Google Workspace בדפדפן
כדי לייצא תוכן של מסמך ב-Google Workspace בדפדפן, משתמשים בשדה exportLinks
של המשאב files
. בהתאם לסוג המסמך, המערכת מחזירה קישור להורדת הקובץ והתוכן שלו לכל סוג MIME זמין. אתם יכולים להפנות משתמש לכתובת URL או להציע אותה כקישור שניתן ללחוץ עליו.
ייצוא תוכן של מסמך ב-Google Workspace לגרסה קודמת בדפדפן
כדי לייצא תוכן של מסמך ב-Google Workspace בגרסה קודמת בדפדפן, משתמשים ב-method revisions.get
עם מזהה הקובץ להורדה ומזהה הגרסה כדי ליצור קישור לייצוא שממנו אפשר לבצע את ההורדה. אם למשתמש יש הרשאת הורדה לקובץ, יוחזר קישור להורדת הקובץ והתוכן שלו. אפשר להפנות משתמש לכתובת ה-URL הזו או להציע אותה כקישור שניתן ללחוץ עליו.
ייצוא תוכן של מסמכים ב-Google Workspace במהלך פעולות ממושכות
כדי לייצא תוכן של מסמך ב-Google Workspace במהלך פעולות ממושכות, משתמשים בשיטה files.download
עם מזהה הקובץ להורדה ומזהה הגרסה. מידע נוסף זמין במאמר ניהול פעולות ממושכות.