Google Drive API תומך במספר סוגים של פעולות הורדה וייצוא, כפי שמפורט בטבלה הבאה:
הורדות |
|
|||
ייצוא |
|
לפני שמורידים או מייצאים תוכן של קבצים, חשוב לוודא שהמשתמשים יכולים להוריד את הקובץ באמצעות השדה capabilities.canDownload
במשאב files
.
בהמשך המדריך הזה תמצאו הוראות מפורטות לביצוע פעולות הורדה וייצוא כאלה.
הורדת תוכן של קובץ blob
כדי להוריד קובץ blob ששמור ב-Drive, משתמשים ב-method files.get
עם מזהה הקובץ להורדה ובפרמטר alt=media
של כתובת ה-URL. הפרמטר alt=media
של כתובת ה-URL מורה לשרת
שנשלחה בקשה להורדת תוכן כפורמט תגובה חלופי.
הפרמטר של כתובת האתר 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. במאמר בחירת היקפי API של Google Drive תוכלו לקרוא מידע נוסף על היקפים ב-Drive.
משתמשים עם הרשאות עריכה יכולים להגביל את ההורדה על ידי משתמשים עם הרשאת קריאה בלבד, על ידי הגדרת השדה copyRequiresWriterPermission
לערך false
.
קבצים שמזוהים כפוגעניים (למשל תוכנות מזיקות) ניתנים להורדה רק על ידי הבעלים שלהם.
בנוסף, צריך לכלול את פרמטר השאילתה acknowledgeAbuse=true
של get
כדי לציין שהמשתמש הכיר בסיכון של הורדת תוכנות שעלולות להיות לא רצויות או קבצים אחרים שיש בהם התנהלות פוגעת. האפליקציה צריכה להציג אזהרה למשתמש באופן אינטראקטיבי לפני השימוש בפרמטר השאילתה הזה.
הורדה חלקית
בהורדה חלקית מתבצעת הורדה רק של חלק מסוים מקובץ. אפשר לציין את החלק של הקובץ שרוצים להוריד באמצעות טווח בייטים עם הכותרת Range
. לדוגמה:
Range: bytes=500-999
הורדת תוכן של קובץ blob בגרסה קודמת
כדי להוריד את התוכן של קובצי blob בגרסה קודמת, משתמשים בשיטה revisions.get
עם מזהה הקובץ להורדה, מזהה הגרסה והפרמטר של כתובת ה-URL alt=media
.
הפרמטר alt=media
של כתובת ה-URL מורה לשרת שמתבצעת בקשה להורדת תוכן כפורמט תגובה חלופי. בדומה ל-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. במאמר בחירת היקפי API של Google Drive תוכלו לקרוא מידע נוסף על היקפים ב-Drive.
דוגמת הקוד גם מצהירה על סוג ה-MIME לייצוא כ-application/pdf
. במאמר ייצוא סוגי MIME למסמכי Google Workspace תוכלו למצוא רשימה מלאה של כל סוגי ה-MIME לייצוא שנתמכים לכל מסמך ב-Google Workspace.
ייצוא תוכן של מסמכים מ-Google Workspace בדפדפן
כדי לייצא תוכן של מסמכי Google Workspace מתוך דפדפן, משתמשים בשדה exportLinks
של המשאב files
. בהתאם לסוג המסמך, לכל סוג MIME הזמין מוחזר קישור להורדת הקובץ והתוכן שלו. ניתן להפנות את המשתמש לכתובת URL או להציע אותה כקישור שניתן ללחוץ עליו.
ייצוא תוכן של מסמכים ב-Google Workspace מגרסה קודמת בדפדפן
כדי לייצא בדפדפן תוכן של מסמכי Google Workspace מגרסה קודמת, צריך להשתמש בשיטה revisions.get
שכוללת את מזהה הקובץ להורדה ואת מזהה הגרסה. אם למשתמש יש גישת הורדה לקובץ, מוחזר קישור להורדת הקובץ והתוכן שלו. ניתן להפנות את המשתמש לכתובת ה-URL הזו או להציע אותה כקישור
קליקבילי.