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