Freigeben über


event: tentativelyAccept

Namespace: microsoft.graph

Akzeptieren Sie das angegebene Ereignis in einem Benutzerkalender mit Vorbehalt.

Wenn das Ereignis Vorschläge für neue Zeiten zulässt, kann ein eingeladener Teilnehmer bei der Reaktion auf das Ereignis mit Vorbehalt einen alternativen Zeitpunkt vorschlagen, indem er den parameter proposedNewTime einschließt . Weitere Informationen zum Vorschlagen einer Uhrzeit und zum Empfangen und Annehmen eines neuen Zeitvorschlags finden Sie unter Vorschlagen neuer Besprechungszeiten.

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) Calendars.ReadWrite Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Calendars.ReadWrite Nicht verfügbar.
Anwendung Calendars.ReadWrite Nicht verfügbar.

HTTP-Anforderung

POST /me/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/events/{id}/tentativelyAccept

POST /me/calendar/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/calendar/events/{id}/tentativelyAccept

POST /me/calendars/{id}/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/calendars/{id}/events/{id}/tentativelyAccept

POST /me/calendarGroups/{id}/calendars/{id}/events/{id}/tentativelyAccept
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/tentativelyAccept

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type string Die Art der Daten im Textkörper einer Entität. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter Typ Beschreibung
comment String In der Antwort enthaltener Text. Optional.
proposedNewTime timeSlot Eine alternative Datums-/Uhrzeitangabe, die von einem eingeladenen Teilnehmer für den Start und das Ende einer Besprechungsanfrage vorgeschlagen wird. Gilt nur für Ereignisse, die neue Zeitvorschläge zulassen. Zum Festlegen dieses Parameters muss sendResponse auf festgelegt werden true. Optional.
sendResponse Boolean true,wenn eine Antwort an den Organisator gesendet werden soll; andernfalls false. Optional. Der Standardwert lautet true.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 202 Accepted zurückgegeben. Es gibt nichts im Antworttext zurück.

Diese Aktion gibt HTTP 400 zurück, wenn eine oder beide der folgenden Vorkommen auftreten:

  • Der proposedNewTime-Parameter ist enthalten, aber die allowNewTimeProposals-Eigenschaft des Ereignisses ist false.
  • Der parameter proposedNewTime ist enthalten, aber der parameter sendResponse ist auf falsefestgelegt.

Beispiel

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.

Anforderung

Im folgenden Beispiel antwortet der angemeldete Benutzer mit Vorbehalt auf das angegebene Ereignis, legt den sendResponse-Parameter auf true fest und schließt eine alternative Zeit in den proposedNewTime-Parameter ein.

POST https://graph.microsoft.com/v1.0/me/events/{id}/tentativelyAccept
Content-type: application/json

{
  "comment": "I may not be able to make this week. How about next week?",
  "sendResponse": true,
  "proposedNewTime": {
      "start": { 
          "dateTime": "2019-12-02T18:00:00", 
          "timeZone": "Pacific Standard Time" 
      }, 
      "end": { 
          "dateTime": "2019-12-02T19:00:00", 
          "timeZone": "Pacific Standard Time" 
      }     
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 202 Accepted