Method: files.get

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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

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