Method: files.get

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

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

המזהה של הקובץ הרלוונטי.

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

פרמטרים
acknowledgeAbuse

boolean

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

enum (Projection)

הפרמטר הזה הוצא משימוש: אין לו פונקציה.
revisionId

string

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

boolean

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

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
updateViewedDate
(deprecated)

boolean

הוצא משימוש: משתמשים ב-files.update עם modifiedDateBehavior=noChange, updateViewedDate=true וגוף בקשה ריק.
includePermissionsForView

string

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

string

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

גוף הבקשה

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

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של File.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/docs
  • 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

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