Method: files.get

הפונקציה מקבלת מטא-נתונים או תוכן של קובץ לפי מזהה.

אם מספקים את הפרמטר 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

string

מזהה הקובץ.

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

פרמטרים
acknowledgeAbuse

boolean

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

boolean

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

boolean

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

string

ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. רק הערך 'פורסם' נתמך.
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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