Method: files.get

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

אם תספקו את הפרמטר alt=media של כתובת האתר, התגובה תכלול את תוכן הקובץ בגוף התגובה. הורדת תוכן באמצעות 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.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

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