列出 cloudClipboard 项

命名空间：microsoft.graph

获取用户的 cloudClipboardItem 对象及其属性的列表。 此 API 仅允许获取以下对象的 cloudClipboardItem 对象：

• 已登录用户自己的 cloudClipboardItem 对象。
• 如果用户授予对应用的委派访问权限，则代表用户的应用。

此 API 不支持使用其他用户的凭据获取用户的 cloudClipboardItem 。

此 API 可用于以下国家级云部署。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	❌	❌	❌

权限

为此 API 选择标记为最低特权的权限。 只有在应用需要它时，才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	UserCloudClipboard.Read	不可用。
委派（个人 Microsoft 帐户）	UserCloudClipboard.Read	不可用。
应用程序	不支持。	不支持。

HTTP 请求

GET /me/cloudClipboard/items

可选的查询参数

此方法支持 $skipTokenOData 查询参数 ，以帮助自定义响应。

$skipToken 是在上一个 List 请求的响应中在 URL 中 @odata.nextLink 返回的令牌，指示要为用户提取更多 cloudClipboardItem 对象。

请求标头

名称	说明
Authorization	持有者 {token}。 必填。
Prefer	odata.maxpagesize={x}。 可选。 指定分页结果的首选整数 {x} 页大小。 可接受的值为 1 到 200（含）。 如果未在页眉中指定，则默认页面大小为 110。

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法在 200 OK 响应正文中返回响应代码和 cloudClipboardItem 对象的集合。

错误

除了适用于 Microsoft Graph 的 常规错误 外，某些错误条件特定于云剪贴板 API。

状态代码	状态消息	说明
400	错误请求	请求格式不正确或不正确，例如页面大小无效或值无效 $skipToken 。
403	禁止访问 (Forbidden)	调用方无法执行该操作。 它表示用户未同意共享 cloudClipboardItem。
409	Conflict	当前状态与请求预期的状态的冲突。 它通常表示用户没有资格使用云剪贴板功能，因为他们在登录过程中没有至少两台设备通过多重身份验证进行身份验证。
429	请求过多	已超出请求速率限制。 等待标头中指定的时间， Retry-After 然后重试。

示例

请求

以下示例显示了一个请求。

GET https://graph.microsoft.com/v1.0/user/cloudClipboard/items

响应

以下示例显示了相应的响应。

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.cloudClipboardItem",
      "id": "292bcf2f-b37e-49d0-8882-1e33dd5c2273",
      "payloads": [
        {
          "@odata.type": "microsoft.graph.cloudClipboardItemPayload",
          "content": "aGVsbG8sIHdvcmxkIQ==",
          "formatName": "TextBase64"
        }
      ],
      "createdDateTime": "2023-08-10T16:56:25.413Z",
      "lastModifiedDateTime": "2022-06-06T17:04:58.000Z",
      "expirationDateTime": "2023-08-11T04:56:25.387Z"
    }
  ],
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/cloudClipboard/items?$skiptoken=lastModifiedDateTime%20le%202024-01-31T01:14:29.675Z"
}