Partager via

Obtenir cloudClipboardItem

  • Article

Espace de noms: microsoft.graph

Lire les propriétés et les relations d’un objet cloudClipboardItem . Cette API vous permet uniquement d’obtenir un objet cloudClipboardItem pour :

  • Le propre cloudClipboardItem de l’utilisateur connecté.
  • Une application au nom de l’utilisateur si l’utilisateur lui accorde un accès délégué.

Cette API ne prend pas en charge l’utilisation des informations d’identification d’un autre utilisateur pour obtenir un cloudClipboardItem pour un utilisateur.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ❌ ❌ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) UserCloudClipboard.Read Non disponible.
Déléguée (compte Microsoft personnel) UserCloudClipboard.Read Non disponible.
Application Non prise en charge. Non prise en charge.

Requête HTTP

GET /me/cloudClipboard/items/{cloudClipboardItemId}

Paramètres facultatifs de la requête

Cette méthode ne prend pas en charge les paramètres de requête OData pour personnaliser la responsabilité. Pour des informations générales, consultez paramètres de la requête OData.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet cloudClipboardItem dans le corps de la réponse.

Erreurs

En plus des erreurs générales qui s’appliquent à Microsoft Graph, les conditions d’erreur suivantes sont spécifiques à l’API Du Presse-papiers cloud.

Code d'état Message d’état Description
400 Demande incorrecte La requête est incorrecte ou incorrecte, par exemple un non valide cloudClipboardItemId.
403 Interdit (Forbidden) L’appelant ne peut pas effectuer l’action. Elle indique que l’utilisateur ne consent pas au partage de cloudClipboardItem.
409 Conflit L’état actuel n’est pas compatible avec les attentes de la demande. Cela indique généralement que l’utilisateur n’est pas éligible à la fonctionnalité du Presse-papiers cloud, car il n’a pas au moins deux appareils authentifiés via l’authentification multifacteur pendant le processus de connexion.
429 Trop de demandes La limite de débit de requêtes a été dépassée. Attendez l’heure spécifiée dans l’en-tête Retry-After , puis réessayez.

Exemples

Demande

L’exemple suivant illustre une demande.

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

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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