ממשק Google Drive API תומך במספר סוגים של פעולות הורדה וייצוא, כפי שמפורט בטבלה הבאה:
הורדות |
|
|||
ייצוא |
|
בהמשך המדריך תמצאו הוראות מפורטות לביצוע פעולות הורדה וייצוא מהסוגים האלה.
הורדת תוכן של קובץ blob
כדי להוריד קובץ blob ששמור ב-Drive, צריך להשתמש בשיטה files.get
עם מזהה הקובץ להורדה ואת הפרמטר alt=media
של כתובת ה-URL. הפרמטר alt=media
של כתובת ה-URL מציין לשרת שמבקשת להוריד תוכן כפורמט חלופי של תגובה.
הפרמטר של כתובת האתר alt=media
הוא פרמטר מערכת שזמין בכל ממשקי ה-API ל-REST של Google. אם אתם משתמשים בספריית לקוח עבור ה-API של Drive, לא תצטרכו להגדיר את הפרמטר הזה באופן מפורש.
דוגמת הקוד הבאה ממחישה איך משתמשים בשיטה files.get
כדי להוריד קובץ באמצעות ספריות הלקוח של Drive API.
Java
Python
Node.js
PHP
.NET
בדוגמת הקוד הזו נעשה שימוש בשיטת ספרייה שמוסיפה את הפרמטר alt=media
של כתובת האתר לבקשת ה-HTTP הבסיסית.
הורדות של קבצים שהופעלו מהאפליקציה חייבות להיות מאושרות בהיקף שמאפשר גישת קריאה לתוכן הקובץ. לדוגמה, אפליקציה שמשתמשת בהיקף drive.readonly.metadata
לא מורשית להוריד את התוכן של הקובץ.
דוגמת הקוד הזו משתמשת בהיקף הקובץ המוגבל 'drive', שמאפשר למשתמשים לראות ולנהל את כל הקבצים שלכם ב-Drive. למידע נוסף על היקפי הרשאות של Drive, ראו מידע על הרשאות ואימות ספציפיות ל-API.
משתמשים עם הרשאות עריכה יכולים להגביל את ההורדה של משתמשים עם הרשאת קריאה בלבד, על ידי הגדרת השדה 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. מידע נוסף על היקפי ההרשאות של 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 זו או להציע אותה כקישור שניתן ללחוץ עליו.