Method: files.get

אחזור מטא-נתונים או תוכן של קובץ לפי מזהה. מידע נוסף זמין במאמר חיפוש קבצים ותיקיות.

אם מספקים את פרמטר כתובת ה-URL‏ alt=media, התגובה כוללת את תוכן הקובץ בגוף התגובה. הורדת תוכן באמצעות alt=media פועלת רק אם הקובץ מאוחסן ב-Drive. כדי להוריד קבצים מ-Google Docs, ‏ Sheets ו-Slides, צריך להשתמש ב-files.export. למידע נוסף, ראו הורדה וייצוא של קבצים.

בקשת HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
fileId

string

המזהה של הקובץ.

פרמטרים של שאילתה

פרמטרים
acknowledgeAbuse

boolean

האם המשתמש מאשר את הסיכון בהורדה של תוכנות זדוניות מוכרות או קבצים פוגעניים אחרים. האפשרות הזו רלוונטית רק אם הפרמטר alt מוגדר לערך media והמשתמש הוא הבעלים של הקובץ או היוצר של האחסון השיתופי שבו הקובץ נמצא.
supportsAllDrives

boolean

האם האפליקציה ששולחת את הבקשה תומכת גם בתיקיית 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

יצא משימוש: במקומו צריך להשתמש ב-supportsAllDrives.
includePermissionsForView

string

מציין אילו הרשאות של תצוגות נוספות לכלול בתשובה. יש תמיכה רק ב-published.
includeLabels

string

רשימה מופרדת בפסיקים של מזהי התוויות שרוצים לכלול בחלק labelInfo של התשובה.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של 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.meet.readonly
  • 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

יש היקפי הרשאות מוגבלים שנדרשת הערכת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך ההרשאות.