Freigeben über

Abrufen von cloudClipboardItem

  • Artikel

Namespace: microsoft.graph

Liest die Eigenschaften und Beziehungen eines cloudClipboardItem-Objekts . Mit dieser API können Sie nur ein cloudClipboardItem-Objekt für Folgendes abrufen:

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

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter nicht, um den Wert anzupassen. Allgemeine Informationen finden Sie unter OData-Abfrageparameter.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein cloudClipboardItem-Objekt im Antworttext zurückgegeben.

Fehler

Zusätzlich zu den allgemeinen Fehlern , die für Microsoft Graph gelten, gelten die folgenden 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 cloudClipboardItemId.
403 Verboten (Forbidden) Der Aufrufer kann die Aktion nicht ausführen. Es gibt an, dass der Benutzer der Freigabe von cloudClipboardItem nicht zustimmt.
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/{cloudClipboardItemId}

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

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