הפונקציה מקבלת מטא-נתונים או תוכן של קובץ לפי מזהה.
אם מספקים את הפרמטר alt=media
של כתובת URL, התגובה תכלול את תוכן הקובץ בגוף התגובה. הורדת תוכן באמצעות alt=media
פועלת רק אם הקובץ שמור ב-Drive. כדי להוריד קבצים של Google Docs, Sheets ו-Slides, צריך להשתמש במקום זאת ב-files.export
. למידע נוסף, ראה הורדה וייצוא של קבצים.
בקשת HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
fileId |
מזהה הקובץ. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
acknowledgeAbuse |
האם המשתמש מאשר את הסיכון בהורדת תוכנה זדונית ידועה או קבצים פוגעניים אחרים. הדבר רלוונטי רק כאשר alt=media. |
supportsAllDrives |
האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי. |
supportsTeamDrives |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
includePermissionsForView |
ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. רק הערך 'פורסם' נתמך. |
includeLabels |
רשימה של מזהי התוויות שצריך לכלול בחלק |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של File
.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.