Freigeben über

Auflisten von cloudClipboard-Elementen

  • Artikel

Namespace: microsoft.graph

Ruft eine Liste der cloudClipboardItem-Objekte und deren Eigenschaften für einen Benutzer ab. Mit dieser API können Sie nur cloudClipboardItem-Objekte für Folgendes abrufen:

  • Die eigenen cloudClipboardItem-Objekte des angemeldeten Benutzers.
  • Eine App im Namen des Benutzers, wenn der Benutzer delegierten Zugriff darauf gewährt.

Diese API unterstützt die Verwendung der Anmeldeinformationen eines anderen Benutzers zum Abrufen eines cloudClipboardItem für einen Benutzer nicht.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) UserCloudClipboard.Read Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) UserCloudClipboard.Read Nicht verfügbar.
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

GET /me/cloudClipboard/items

Optionale Abfrageparameter

Diese Methode unterstützt $skipTokenOData-Abfrageparameter , um die Antwort anzupassen.

$skipToken ist ein Token, das in der @odata.nextLink URL in der Antwort der vorherigen List-Anforderung zurückgegeben wird, was angibt, dass weitere cloudClipboardItem-Objekte für den Benutzer abgerufen werden müssen.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Prefer odata.maxpagesize={x}. Optional. Gibt eine bevorzugte ganzzahlige {x}-Seitengröße für paginierte Ergebnisse an. Zulässige Werte sind 1 bis einschließlich 200. Wenn in der Kopfzeile nicht angegeben, ist die Standardseitengröße 110.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und eine Auflistung von cloudClipboardItem-Objekten im Antworttext zurückgegeben.

Fehler

Zusätzlich zu den allgemeinen Fehlern , die für Microsoft Graph gelten, gelten einige Fehlerbedingungen spezifisch für die Cloud-Zwischenablage-API.

Statuscode Statusmeldung Beschreibung
400 Bad request (Ungültige Anforderung) Die Anforderung ist falsch formatiert oder falsch, z. B. eine ungültige Seitengröße oder ein ungültiger $skipToken Wert.
403 Verboten (Forbidden) Der Aufrufer kann die Aktion nicht ausführen. Es gibt an, dass der Benutzer nicht zugestimmt hat, cloudClipboardItem zu teilen.
409 Conflict Der aktuellen Status steht im Konflikt mit dem, was die Anforderung erwartet. Dies bedeutet in der Regel, dass der Benutzer nicht für die Cloud-Zwischenablage berechtigt ist, da er während des Anmeldevorgangs nicht mindestens zwei Geräte über die mehrstufige Authentifizierung authentifiziert hat.
429 Zu viele Anforderungen Das Anforderungsratenlimit wurde überschritten. Warten Sie die im Retry-After Header angegebene Zeit, und versuchen Sie es erneut.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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