签入对 DriveItem 资源的更改

签入已签出的 DriveItem 资源,为其他人提供文档版本。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.All
委派(个人 Microsoft 帐户) Files.ReadWrite、Files.ReadWrite.All
应用程序 Files.ReadWrite.All、Sites.ReadWrite.All

HTTP 请求

POST /drives/{driveId}/items/{itemId}/checkin
POST /groups/{groupId}/drive/items/{itemId}/checkin
POST /me/drive/items/{item-id}/checkin
POST /sites/{siteId}/drive/items/{itemId}/checkin
POST /users/{userId}/drive/items/{itemId}/checkin

请求正文

在请求正文中,提供具有以下参数的 JSON 对象。

名称 说明
checkInAs string 选。签入操作完成后文档的所需状态。可以 published 或未指定。
comment string 与此版本相关联的签入注释。

示例

本示例签入由 {item-id} 标识的文件。

POST /drives/{drive-id}/items/{item-id}/checkin
Content-Type: application/json

{
  "comment": "Updating the latest guidelines"
}

响应

如果成功,该 API 调用会返回 204 No Content

HTTP/1.1 204 No Content

注解