イベント: 辞退

名前空間: microsoft.graph

ユーザー予定表で指定したイベントへの招待を拒否します。

イベントが新しい時間の提案を許可する場合、イベントを辞退すると、招待者は 、提案されたNewTime パラメーターを含めることによって別の時間を提案することを選択できます。 時間を提案する方法と、新しい時間の提案を受け入れる方法の詳細については、「 新しい会議時間を提案する」を参照してください。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Calendars.ReadWrite 注意事項なし。
委任 (個人用 Microsoft アカウント) Calendars.ReadWrite 注意事項なし。
アプリケーション Calendars.ReadWrite 注意事項なし。

HTTP 要求

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

要求ヘッダー

名前 説明
Authorization string ベアラー {token}。 必須です。
Content-Type string エンティティ本文内のデータの性質です。 必須です。

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 説明
comment String 応答に含まれるテキスト。 省略可能です。
proposedNewTime timeSlot 会議出席依頼の開始と終了のために招待者によって提案された別の日付/時刻。 新しい時間提案を許可するイベントに対してのみ有効です。 このパラメーターを設定するには、 sendResponse を に設定する true必要があります。 省略可能です。
sendResponse ブール値 true応答が開催者に送信される場合。それ以外の場合は 。 false 省略可能です。 既定値は true です。

応答

成功した場合、このメソッドは 202 Accepted 応答コードを返します。 応答本文では何も返されません。

このアクションは、次のいずれかまたは両方が発生した場合に HTTP 400 を返します。

  • proposedNewTime パラメーターが含まれていますが、イベントallowNewTimeProposals プロパティは ですfalse
  • proposedNewTime パラメーターが含まれていますが、sendResponse パラメーターは にfalse設定されています。

以下は、この API を呼び出す方法の例です。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/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" 
      }     
  }
}

応答

次の例は応答を示しています。

HTTP/1.1 202 Accepted