Freigeben über


event: decline

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Lehnen Sie die Einladung zum angegebenen Ereignis in einem Benutzerkalender ab.

Wenn das Ereignis Vorschläge für neue Zeiten zulässt, kann ein eingeladener Teilnehmer beim Ablehnen des Ereignisses 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}/decline
POST /users/{id | userPrincipalName}/events/{id}/decline

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

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

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

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.
sendResponse Boolean true,wenn eine Antwort an den Organisator gesendet werden soll; andernfalls false. Optional. Der Standardwert lautet true.
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.

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

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/me/events/{id}/decline
Content-type: application/json

{
  "comment": "I won't 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