Freigeben über

Erstellen von checkInClaim

Namespace: microsoft.graph

Erstellen Sie ein neues checkInClaim-Objekt, um die check-in-status für einen bestimmten Ort aufzuzeichnen, z. B. einen Schreibtisch oder einen Raum, der einer bestimmten Kalenderreservierung zugeordnet ist. Dieser Check-In bestätigt, dass der reservierte Speicherplatz verwendet wird, und verhindert die automatische Freigabe, wenn Richtlinien für die automatische Freigabe für diesen Ort konfiguriert sind.

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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) Calendars.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

POST /places/{placesId}/checkIns

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des checkInClaim-Objekts an.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine checkInClaim-Instanz erstellen.

Eigenschaft Typ Beschreibung
calendarEventId Zeichenfolge Der eindeutige Bezeichner für ein Outlook-Kalenderereignis, das dem checkInClaim-Objekt zugeordnet ist. Weitere Informationen finden Sie unter der iCalUId-Eigenschaft in event. Schreibgeschützt. Erforderlich.
checkInMethod checkInMethod Gibt die Methode des Eincheckens an. Mögliche Werte sind: unspecified, manual, inferred, verified, unknownFutureValue. Der Standardwert ist unspecified. Erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein checkInClaim-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/places/c8aaf4d8-6c73-46c4-bf28-b2adadafb5be/checkIns
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.checkInClaim",
  "calendarEventId": "040000008200E00074C5B7101A82E00800000000D02AC02D26EFDB010000000000000000100000005A18ADA04F0A24489AE13ED3CC367978",
  "checkInMethod": "verified"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

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

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.checkInClaim",
  "calendarEventId": "040000008200E00074C5B7101A82E00800000000D02AC02D26EFDB010000000000000000100000005A18ADA04F0A24489AE13ED3CC367978",
  "checkInMethod": "verified",
  "createdDateTime": "2025-06-28T12:34:56.789Z"
}
  • Last updated on