イベントを更新する

名前空間: microsoft.graph

イベント オブジェクトのプロパティを更新する。

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

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

特定のプロパティを更新するための注意事項

対応するプロパティを更新する場合は、次の動作または推奨事項に注意してください。

  • attendees プロパティと会議の更新

    • リクエスト本文に attendees プロパティのみを含むイベント更新は、変更された出席者のみに会議更新を送信します。
    • 配布リストのメンバーとして指定された出席者を削除するイベント更新は、すべての出席者に会議の更新を送信します。
  • body プロパティとオンライン会議

    オンライン会議として設定されたイベントの本文を更新する前に、必ず body プロパティを取得し、コンテンツに適切な変更を適用して、オンライン会議用に会議の BLOB を保持してください。 不注意で会議 BLOB を本文から削除すると、オンラインでの会議が無効になります。

  • プロパティとそのタイム ゾーンの終了開始

    イベントの開始時刻または終了時刻のタイムゾーンを更新する際に、まず、サポートされているタイム ゾーンを検索して、ユーザーのメールボックス サーバー用に構成されているタイム ゾーンのみ設定されることを確認します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Calendars.ReadWrite
委任 (個人用 Microsoft アカウント) Calendars.ReadWrite
アプリケーション Calendars.ReadWrite

HTTP 要求

PATCH /me/events/{id}
PATCH /users/{id | userPrincipalName}/events/{id}
PATCH /groups/{id}/events/{id}

PATCH /me/calendar/events/{id}
PATCH /users/{id | userPrincipalName}/calendar/events/{id}
PATCH /groups/{id}/calendar/events/{id}

PATCH /me/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendars/{id}/events/{id}

PATCH /me/calendarGroups/{id}/calendars/{id}/events/{id}
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}

要求ヘッダー

名前 説明
Authorization string ベアラー {token}。 必須です。

要求本文

要求本文で、更新すべきプロパティの値のみを指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。

次の表に、更新できるプロパティを示します。

プロパティ 説明
attendees Attendee イベントの参加者のコレクションです。
body ItemBody イベントに関連付けられたメッセージの本文。
categories String collection イベントに関連付けられたカテゴリ。
end DateTimeTimeZone イベントが終了する日付、時刻、タイムゾーン。
hideAttendees Boolean true に設定すると、各出席者は会議出席依頼と会議の管理リストにのみ表示されます。 既定値は false です。
importance String イベントの重要度。 使用可能な値: lownormalhigh
isAllDay Boolean イベントが一日中続く場合に、true に設定します。
isOnlineMeeting Boolean このイベントにオンライン会議情報がある場合は True、そうでない場合は false。 既定値は false です。 オプション。
isReminderOn Boolean ユーザーにイベントを通知するアラートを設定する場合は、true に設定します。
location Location イベントの場所。
locations location コレクション イベントを開催する場所、または参加者がいる場所。 location プロパティと locations プロパティは常に互いに一致します。 location プロパティを更新すると、locations コレクションに含まれる既存のすべての場所が削除されて、location の新しい値に置き換えられます。
onlineMeetingProvider onlineMeetingProviderType オンライン会議のサービス プロバイダーを表します。 使用可能な値は teamsForBusinessskypeForBusiness、および skypeForConsumer。 オプション。
recurrence PatternedRecurrence イベントの繰り返しパターン。
reminderMinutesBeforeStart Int32 アラーム通知を行う、イベント開始時間前の分数。
responseRequested Boolean イベントが承諾または辞退されたときに、送信者が応答を要求する場合に、true に設定します。
sensitivity String 使用可能な値: normalpersonalprivateconfidential
showAs String 表示するステータス。 使用可能な値: freetentativebusyoofworkingElsewhereunknown
開始 DateTimeTimeZone イベントの開始日、時間、タイム ゾーン。
subject String イベントの件名行のテキスト。

イベント リソースは拡張機能をサポートしているため、PATCH 操作を使用して、既存のイベント インスタンスで拡張機能のカスタム プロパティにあるアプリ固有のデータを追加、更新、または削除することができます。

アップデートするイベントが複数の出席者が含まれる定期的で主要なイベントである場合、インスタンス別にそれぞれに更新され、主要な系列と更新された各インスタンスごとに複数の通知メールが送信されます。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で、更新された event オブジェクトを返します。

注:この方法は、エラー コードErrorOccurrenceCrossingBoundary で HTTP 400 無効な要求の応答を返すことができます。そして、次のエラー メッセージが表示されます: 変更したアイテムが、隣接するアイテムと交差または重複しています。 定期的な予定の例外にある Outlook の制限に更新プログラムが違反していることを次のように示します: 定期的な予定を移動させる、または前回の定期的な予定をその日付より前日または後日に移動することはできません。

要求

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

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

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "recurrence": null,
  "reminderMinutesBeforeStart": 99,
  "isOnlineMeeting": true,
  "onlineMeetingProvider": "teamsForBusiness",
  "isReminderOn": true,
  "hideAttendees": false,
  "categories": ["Red category"]
}
応答

次の例は応答を示しています。 注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
  "originalStartTimeZone": "originalStartTimeZone-value",
  "originalEndTimeZone": "originalEndTimeZone-value",
  "responseStatus": {
    "response": "",
    "time": "datetime-value"
  },
  "recurrence": null,
  "reminderMinutesBeforeStart": 99,
  "isOnlineMeeting": true,
  "onlineMeetingProvider": "teamsForBusiness",
  "isReminderOn": true,
  "hideAttendees": false,
  "onlineMeeting": {
        "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_NzIyNzhlMGEtM2YyZC00ZmY0LTlhNzUtZmZjNWFmZGNlNzE2%40thread.v2/0?context=%7b%22Tid%22%3a%2272f988bf-86f1-41af-91ab-2d7cd011db47%22%2c%22Oid%22%3a%22bc55b173-cff6-457d-b7a1-64bda7d7581a%22%7d",
        "conferenceId": "177513992",
        "tollNumber": "+91 22 6241 6885"
  }
}