Method: changes.list
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.
Liệt kê các thay đổi đối với một người dùng hoặc bộ nhớ dùng chung. Để biết thêm thông tin, hãy xem phần Truy xuất các thay đổi.
Yêu cầu HTTP
GET https://www.googleapis.com/drive/v3/changes
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Thông số |
driveId |
string
Bộ nhớ dùng chung mà từ đó các thay đổi sẽ được trả về. Nếu được chỉ định, mã nhận dạng thay đổi sẽ phản ánh bộ nhớ dùng chung; hãy sử dụng mã nhận dạng kết hợp của ổ đĩa và mã nhận dạng thay đổi.
|
includeCorpusRemovals |
boolean
Liệu các thay đổi có nên bao gồm tài nguyên tệp hay không nếu người dùng vẫn có thể truy cập vào tệp tại thời điểm yêu cầu, ngay cả khi tệp đã bị xoá khỏi danh sách thay đổi và sẽ không có thêm mục thay đổi nào cho tệp này.
|
includeItemsFromAllDrives |
boolean
Có nên đưa cả các mục trong Drive của tôi và bộ nhớ dùng chung vào kết quả hay không.
|
includeRemoved |
boolean
Có bao gồm những thay đổi cho biết các mục đã bị xoá khỏi danh sách thay đổi hay không, chẳng hạn như do bị xoá hoặc mất quyền truy cập.
|
includeTeamDriveItems
(deprecated) |
boolean
Không dùng nữa: Thay vào đó, hãy sử dụng includeItemsFromAllDrives.
|
pageSize |
integer
Số lượng thay đổi tối đa cần trả về cho mỗi trang.
|
pageToken |
string
Mã thông báo để tiếp tục yêu cầu danh sách trước đó trên trang tiếp theo. Bạn nên đặt giá trị này thành giá trị của "nextPageToken" trong phản hồi trước đó hoặc thành phản hồi từ phương thức getStartPageToken.
|
restrictToMyDrive |
boolean
Có hạn chế kết quả đối với những thay đổi trong hệ thống phân cấp của phần Drive của tôi hay không. Thao tác này bỏ qua các thay đổi đối với tệp, chẳng hạn như các tệp trong thư mục Dữ liệu ứng dụng hoặc các tệp dùng chung chưa được thêm vào mục Drive của tôi.
|
spaces |
string
Danh sách các không gian được phân tách bằng dấu phẩy để truy vấn trong các ngữ liệu. Các giá trị được hỗ trợ là "drive" và "appDataFolder".
|
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: Thay vào đó, hãy sử dụng supportsAllDrives.
|
teamDriveId
(deprecated) |
string
Không dùng nữa: Thay vào đó, hãy sử dụng driveId.
|
includePermissionsForView |
string
Chỉ định những quyền xem bổ sung cần đưa vào phản hồi. Chỉ hỗ trợ trạng thái "đã xuất bản".
|
includeLabels |
string
Danh sách mã nhận dạng được phân tách bằng dấu phẩy của các nhãn cần đư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
Danh sách các thay đổi đối với một người dùng.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"changes": [
{
object (Change)
}
],
"kind": string,
"nextPageToken": string,
"newStartPageToken": string
} |
| Trường |
changes[] |
object (Change)
Danh sách các thay đổi. Nếu nextPageToken được điền sẵn, thì danh sách này có thể chưa đầy đủ và bạn nên tìm nạp thêm một trang kết quả.
|
kind |
string
Xác định loại tài nguyên này. Giá trị: chuỗi cố định "drive#changeList".
|
nextPageToken |
string
Mã thông báo trang cho trang thay đổi tiếp theo. Tham số này sẽ không xuất hiện nếu bạn đã đến cuối danh sách thay đổi. Mã thông báo trang không hết hạn.
|
newStartPageToken |
string
Mã thông báo trang bắt đầu cho các thay đổi trong tương lai. Mục này sẽ chỉ xuất hiện nếu bạn đã xem hết danh sách thay đổi hiện tại. Mã thông báo trang không hết hạn.
|
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/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 bạn phải đánh giá bảo mật để ứng dụng của bạn có thể sử dụng các phạm vi đó. Để 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: changes.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ChangeList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the changes for a user or shared drive. For more information, see [Retrieve changes](https://developers.google.com/workspace/drive/api/guides/manage-changes).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/changes`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `driveId` | `string` The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier. |\n| `includeCorpusRemovals` | `boolean` Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file. |\n| `includeItemsFromAllDrives` | `boolean` Whether both My Drive and shared drive items should be included in results. |\n| `includeRemoved` | `boolean` Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access. |\n| `includeTeamDriveItems` **(deprecated)** | `boolean` Deprecated: Use `includeItemsFromAllDrives` instead. |\n| `pageSize` | `integer` The maximum number of changes to return per page. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method. |\n| `restrictToMyDrive` | `boolean` Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive. |\n| `spaces` | `string` A comma-separated list of spaces to query within the corpora. Supported values are 'drive' and 'appDataFolder'. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `teamDriveId` **(deprecated)** | `string` Deprecated: Use `driveId` instead. |\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\nA list of changes for a user.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"changes\": [ { object (/workspace/drive/api/reference/rest/v3/changes#Change) } ], \"kind\": string, \"nextPageToken\": string, \"newStartPageToken\": string } ``` |\n\n| Fields ||\n|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `changes[]` | `object (`[Change](/workspace/drive/api/reference/rest/v3/changes#Change)`)` The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#changeList\"`. |\n| `nextPageToken` | `string` The page token for the next page of changes. This will be absent if the end of the changes list has been reached. The page token doesn't expire. |\n| `newStartPageToken` | `string` The starting page token for future changes. This will be present only if the end of the current changes list has been reached. The page token doesn't expire. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\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)."]]
