Partager via

Lister les éléments cloudClipboard

  • Article

Espace de noms: microsoft.graph

Obtenez la liste des objets cloudClipboardItem et leurs propriétés pour un utilisateur. Cette API vous permet uniquement d’obtenir des objets cloudClipboardItem pour :

  • Objets 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

Paramètres facultatifs de la requête

Cette méthode prend en charge les $skipTokenparamètres de requête OData pour vous aider à personnaliser la réponse.

$skipToken est un jeton retourné dans l’URL @odata.nextLink dans la réponse de la demande list précédente, ce qui indique qu’il y a plus d’objets cloudClipboardItem à extraire pour l’utilisateur.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Préférence odata.maxpagesize={x}. Optional. Spécifie une taille de page {x} entière préférée pour les résultats paginés. Les valeurs acceptables sont comprises entre 1 et 200, inclus. S’il n’est pas spécifié dans l’en-tête, la taille de page par défaut est 110.

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 une collection d’objets cloudClipboardItem dans le corps de la réponse.

Erreurs

Outre les erreurs générales qui s’appliquent à Microsoft Graph, certaines conditions d’erreur 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, une taille de page ou une valeur non valide $skipToken .
403 Interdit (Forbidden) L’appelant ne peut pas effectuer l’action. Il indique que l’utilisateur n’a pas donné son consentement pour partager 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

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

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