Method: changes.watch
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.
Yêu cầu HTTP
POST https://www.googleapis.com/drive/v3/changes/watch
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ã thay đổi sẽ phản ánh bộ nhớ dùng chung; hãy sử dụng mã nhận dạng bộ nhớ kết hợp và mã thay đổi làm giá trị nhận dạng.
|
includeCorpusRemovals |
boolean
Liệu các thay đổi có bao gồm tài nguyên tệp 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 hay không, ngay cả khi tệp đã bị xoá khỏi danh sách thay đổi và sẽ không có mục thay đổi nào khác cho tệp này.
|
includeItemsFromAllDrives |
boolean
Liệu kết quả có bao gồm cả các mục trong Drive của tôi và bộ nhớ dùng chung hay không.
|
includeRemoved |
boolean
Liệu có đưa vào các thay đổi cho biết các mục đã bị xoá khỏi danh sách thay đổi hay không, ví dụ: do bị xoá hoặc mất quyền truy cập.
|
includeTeamDriveItems
(deprecated) |
boolean
Không dùng nữa: Hãy sử dụng includeItemsFromAllDrives.
|
pageSize |
integer
Số thay đổi tối đa được trả về trên 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 "nextPageToken" từ phản hồi trước đó hoặc thành phản hồi từ phương thức getStartPageToken.
|
restrictToMyDrive |
boolean
Liệu có giới hạn kết quả ở những thay đổi trong hệ thống phân cấp của Drive của tôi hay không. Thao tác này sẽ bỏ qua các thay đổi đối với các tệp như 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 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 tập hợp văn bản. 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: Hãy sử dụng supportsAllDrives.
|
teamDriveId
(deprecated) |
string
Không dùng nữa: Hãy sử dụng driveId.
|
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ợ trạng thái "đã xuất bản".
|
includeLabels |
string
Danh sách mã nhận dạng của 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 chứa một bản sao của Channel.
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 Channel.
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 đá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: changes.watch\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- [Authorization scopes](#body.aspect)\n\nSubscribes to changes for a user. For more information, see [Notifications for resource changes](https://developers.google.com/workspace/drive/api/guides/push).\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v3/changes/watch`\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 contains an instance of [Channel](/workspace/drive/api/reference/rest/v3/channels#Channel).\n\n### Response body\n\nIf successful, the response body contains an instance of [Channel](/workspace/drive/api/reference/rest/v3/channels#Channel).\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)."]]
