ה-API של Google Drive תומך בכמה סוגים של פעולות הורדה וייצוא, כמו מפורטות בטבלה הבאה:
הורדות |
|
|||
ייצוא |
|
לפני שמורידים או מייצאים תוכן של קבצים, חשוב לוודא שהמשתמשים יכולים להוריד את
באמצעות השדה capabilities.canDownload
שבקובץ
משאב files
.
שאר המדריך מספק הוראות מפורטות לביצוע הסוגים האלה של פעולות הורדה וייצוא.
הורדת תוכן של קובץ blob
כדי להוריד קובץ blob שמאוחסן ב-Drive, צריך להשתמש בשיטה files.get
עם מזהה הקובץ להורדה
ואת הפרמטר alt=media
של כתובת האתר. הפרמטר alt=media
של כתובת האתר מציין את הערך של
השרת שמבקש הורדה של תוכן כתגובה חלופית.
הפורמט.
הפרמטר alt=media
של כתובת האתר הוא מערכת
פרמטר
זמינות בכל ממשקי ה-API של Google בארכיטקטורת REST. אם אתם משתמשים בספריית לקוח עבור
Drive API, אין צורך להגדיר את הפרמטר הזה באופן מפורש.
דוגמת הקוד הבאה מראה איך להשתמש ב-method files.get
כדי להוריד
באמצעות ספריות הלקוח של Drive API.
Java
Python
Node.js
PHP
.NET
בדוגמת הקוד הזו נעשה שימוש בשיטת ספרייה שמוסיפה את הפרמטר alt=media
של כתובת האתר
לבקשת ה-HTTP הבסיסית.
הורדות של קבצים שהתחילו באפליקציה צריכות לקבל הרשאה בהיקף שמאפשר
גישת קריאה לתוכן הקובץ. לדוגמה, אפליקציה שמשתמשת ב
להיקף של drive.readonly.metadata
אין הרשאה להוריד את תוכן הקובץ.
דוגמת הקוד הזו משתמשת בהיקף של קובץ ה-'drive' המוגבל, שמאפשר למשתמשים
הצגה וניהול של כל הקבצים שלך ב-Drive. מידע נוסף על
היקפי ההרשאות ב-Drive, במאמר בחירת Google Drive API
היקפים.
משתמשים עם הרשאות עריכה יכולים להגביל את ההורדה על ידי משתמשים בעלי הרשאת קריאה בלבד באמצעות
הגדרה של copyRequiresWriterPermission
לשדה false
.
קבצים שמזוהים בתור
פוגעני
(למשל, תוכנות מזיקות) רק הבעלים של הקובץ יכולים להוריד אותו.
בנוסף, צריך לכלול את פרמטר השאילתה get
acknowledgeAbuse=true
כדי לציין שהמשתמש מכיר ביכולת של הורדה
תוכנות לא רצויות או קבצים פוגעניים אחרים. האפליקציה צריכה לפעול באופן אינטראקטיבי
להזהיר את המשתמש לפני השימוש בפרמטר השאילתה.
הורדה חלקית
הורדה חלקית כרוכה בהורדה רק של חלק מסוים מקובץ. שלך
יכול לציין את החלק מתוך הקובץ שברצונכם להוריד באמצעות בייט
טווח
עם הכותרת Range
. לדוגמה:
Range: bytes=500-999
הורדת תוכן של קובץ blob בגרסה קודמת
כדי להוריד את התוכן של קובצי blob בגרסה קודמת, צריך להשתמש ב
revisions.get
עם המזהה של
הקובץ להורדה, מזהה הגרסה ופרמטר alt=media
של כתובת האתר.
הפרמטר 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, במאמר בחירת Google 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 הזו או להציע אותה בתור קישור שניתן ללחוץ עליו
קישור.