Method: files.get

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

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

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

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