Method: files.get
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Lấy siêu dữ liệu hoặc nội dung của tệp theo mã nhận dạng.
Nếu bạn cung cấp tham số URL alt=media, thì nội dung phản hồi sẽ bao gồm nội dung tệp trong phần nội dung phản hồi. Tính năng tải nội dung xuống bằng alt=media chỉ hoạt động nếu tệp được lưu trữ trong Drive. Để tải Google Tài liệu, Trang tính và Trang trình bày xuống, hãy sử dụng files.export. Để biết thêm thông tin, hãy xem phần Tải xuống và xuất tệp.
Yêu cầu HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
fileId |
string
Mã nhận dạng của tệp có liên quan.
|
Tham số truy vấn
| Thông số |
acknowledgeAbuse |
boolean
Liệu người dùng có xác nhận rủi ro khi tải phần mềm độc hại đã biết hoặc các tệp sai trái khác xuống hay không. Điều này chỉ áp dụng khi tham số alt được đặt thành media và người dùng là chủ sở hữu của tệp hoặc là người sắp xếp của bộ nhớ dùng chung chứa tệp đó.
|
projection
(deprecated) |
enum (Projection)
Ngừng sử dụng: Tham số này không có chức năng.
|
revisionId |
string
Chỉ định mã bản sửa đổi cần tải xuống. Bỏ qua trừ phi bạn chỉ định alt=media.
|
supportsAllDrives |
boolean
Liệu ứng dụng yêu cầu có hỗ trợ cả Drive của tôi và bộ nhớ dùng chung hay không.
|
supportsTeamDrives
(deprecated) |
boolean
Không dùng nữa: Hãy sử dụng supportsAllDrives.
|
updateViewedDate
(deprecated) |
boolean
Không dùng nữa: Sử dụng files.update với modifiedDateBehavior=noChange,
updateViewedDate=true và nội dung yêu cầu trống.
|
includePermissionsForView |
string
Chỉ định quyền của thành phần hiển thị bổ sung cần đưa vào phản hồi. Chỉ hỗ trợ published.
|
includeLabels |
string
Danh sách mã nhận dạng của các nhãn được phân tách bằng dấu phẩy để đưa vào phần labelInfo của phản hồi.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của File.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
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
Một số phạm vi bị hạn chế và yêu cầu đánh giá bảo mật để ứng dụng của bạn có thể sử dụng. Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: files.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n\u003cbr /\u003e\n\nGets a file's metadata or content by ID.\n\nIf you provide the URL parameter `alt=media`, then the response includes the file contents in the response body. Downloading content with `alt=media` only works if the file is stored in Drive. To download Google Docs, Sheets, and Slides use [`files.export`](/workspace/drive/api/reference/rest/v2/files/export) instead. For more information, see [Download \\& export files](/workspace/drive/api/guides/manage-downloads).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v2/files/{fileId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------|\n| `fileId` | `string` The ID for the file in question. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `acknowledgeAbuse` | `boolean` Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides. |\n| `projection` **(deprecated)** | `enum (`[Projection](/workspace/drive/api/reference/rest/v2/Projection)`)` Deprecated: This parameter has no function. |\n| `revisionId` | `string` Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `updateViewedDate` **(deprecated)** | `boolean` Deprecated: Use `files.update` with `modifiedDateBehavior=noChange, updateViewedDate=true` and an empty request body. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only `published` is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [File](/workspace/drive/api/reference/rest/v2/files#File).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
