Compartir a través de

Obtención de cloudClipboardItem

  • Artículo

Espacio de nombres: microsoft.graph

Lea las propiedades y relaciones de un objeto cloudClipboardItem . Esta API solo permite obtener un objeto cloudClipboardItem para:

  • 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/{cloudClipboardItemId}

Parámetros de consulta opcionales

Este método no admite los parámetros de consulta de OData para personalizar el respone. Para obtener información general, vea Parámetros de consulta OData.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

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 un objeto cloudClipboardItem en el cuerpo de la respuesta.

Errores

Además de los errores generales que se aplican a Microsoft Graph, las siguientes 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 valor no válido cloudClipboardItemId.
403 Prohibido (Forbidden) El autor de la llamada no puede realizar la acción. Indica que el usuario no da 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/{cloudClipboardItemId}

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

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