Compartir a través de

Enumerar elementos cloudClipboard

  • Artículo

Espacio de nombres: microsoft.graph

Obtenga una lista de los objetos cloudClipboardItem y sus propiedades para un usuario. Esta API solo permite obtener objetos cloudClipboardItem para:

  • Los propios objetos cloudClipboardItem del usuario que ha iniciado sesión.
  • Una aplicación en nombre del usuario si el usuario concede acceso delegado a ella.

Esta API no admite el uso de las credenciales de otro usuario para obtener un cloudClipboardItem para un usuario.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) UserCloudClipboard.Read No disponible.
Delegado (cuenta personal de Microsoft) UserCloudClipboard.Read No disponible.
Aplicación No admitida. No admitida.

Solicitud HTTP

GET /me/cloudClipboard/items

Parámetros de consulta opcionales

Este método admite $skipTokenparámetros de consulta de OData para ayudar a personalizar la respuesta.

$skipToken es un token devuelto en la @odata.nextLink dirección URL en la respuesta de la solicitud list anterior, lo que indica que hay más objetos cloudClipboardItem que se van a capturar para el usuario.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Prefer odata.maxpagesize={x}. Opcional. Especifica un tamaño de página {x} entero preferido para los resultados paginados. Los valores aceptables son de 1 a 200, ambos inclusive. Si no se especifica en el encabezado, el tamaño de página predeterminado es 110.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos cloudClipboardItem en el cuerpo de la respuesta.

Errores

Además de los errores generales que se aplican a Microsoft Graph, algunas condiciones de error son específicas de cloud clipboard API.

Código de estado Mensaje de estado Descripción
400 Solicitud incorrecta La solicitud tiene un formato incorrecto o incorrecto, como un tamaño de página no válido o un valor no válido $skipToken .
403 Prohibido (Forbidden) El autor de la llamada no puede realizar la acción. Indica que el usuario no ha dado su consentimiento para compartir cloudClipboardItem.
409 Conflict El estado actual entra en conflicto con lo que la solicitud espera. Normalmente, indica que el usuario no es apto para la característica del Portapapeles en la nube porque no tiene al menos dos dispositivos autenticados mediante la autenticación multifactor durante el proceso de inicio de sesión.
429 Demasiadas solicitudes Se ha superado el límite de velocidad de solicitud. Espere el tiempo especificado en el Retry-After encabezado e inténtelo de nuevo.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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"
}