> ## Documentation Index > Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # 概要 > 会議をワンクリック作成してチャット形式で送信してAlibaba メール連携でカレンダー予定を一元管理します 本記事では、予定プロダクトの概要、有効化方法、予定機能で公開されている API、および予定機能の導入方法について説明します。 ## 予定とは DingTalk の予定管理はインスタントメッセージと深く統合されており、同僚間で予定を共有し、予定会議を簡単に開始でき、重要な事項を一目で把握できます。チームコラボレーションをより効率化し、社員に快適な使用体験を提供します。詳細は [DingTalk 使い方ガイド - 予定](https://docs.dingtalk.io/i/p/Y7kmbokZp3pgGLq2/docs/Y7kmbOpyEdYLGLq2?dontjump=true%23%23) をご参照ください。 ### 予定会議の正確な通知 ワンクリックで会議の予定を簡単に作成し、招待をチャット形式で各参加者に直接通知することで、漏れなく確実に伝達できます。 ### 予定の一元管理 Alibaba メールと連携し、DingTalk カレンダー内で予定を一元的に閲覧・編集できます。1 箇所で更新すれば全てに同期され、会議や予定を見逃すことがありません。 ## 予定の有効化方法 モバイル版での操作：【コラボレーション】-【カレンダー】、またはツールバー内の【カレンダー】。 PC 版での操作：【カレンダー】。 ## オープン概要 ### 公開 API リスト 予定機能は豊富な API を公開しており、開発者は API を通じて予定機能と企業の業務システムを連携できます。 ### 説明 1. [予定を作成](/ja/open/development/create-schedule)、[予定を変更](/ja/open/development/modify-event)、[予定参加者を追加](/ja/open/development/add-schedule-participant)、[予定参加者を削除](/ja/open/development/delete-schedule-participant) の各 API では、1 回の操作で最大 500 名の予定参加者を処理でき、最大 5000 名の予定までサポートします。 2. 予定参加者の追加・削除には、[予定参加者を追加](/ja/open/development/add-schedule-participant) および [予定参加者を削除](/ja/open/development/delete-schedule-participant) API の使用を推奨します。 ### ユーザーアクセス制御 | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | ------------ | ----------------------- | ----------------------------------------------------------------------------------- | ------------------ | | アクセス制御の作成 | 指定したカレンダーにアクセス制御を追加します。 | [アクセス制御の作成](/ja/open/development/create-schedule-access-control) | - | | アクセス制御の削除 | アクセス制御を削除します。 | [アクセス制御の削除](/ja/open/development/delete-an-access-control-list) | - | | アクセス制御リストの取得 | カレンダーのアクセス制御リストを取得します。 | [アクセス制御リストの取得](/ja/open/development/obtain-the-access-control-list-of-the-calendar) | - | ### 予定 | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | ---------- | --------------------------------------------- | --------------------------------------------------------------- | ------------------ | | 予定を作成 | 予定を 1 件作成します。 | [予定を作成](/ja/open/development/create-schedule) | - | | 予定を削除 | 指定した予定を削除します。 | [予定を削除](/ja/open/development/delete-event) | - | | 予定を変更 | 単一の予定情報を変更します。 | [予定を変更](/ja/open/development/modify-event) | - | | 単一の予定詳細を照会 | 単一の予定の詳細を照会します。 | [単一の予定詳細を照会](/ja/open/development/query-details-about-an-event) | - | | 予定リストを照会 | ユーザーの指定期間内の予定を照会します。 | [予定リストを照会](/ja/open/development/query-an-event-list) | - | | 予定ビューを照会 | ユーザーの DingTalk メインカレンダーにおける指定期間内の予定ビューを照会します。 | [予定ビューを照会](/ja/open/development/query-schedule-view) | - | ### 予定参加者 | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | --------------- | ---------------------- | ------------------------------------------------------------------- | ------------------ | | 予定参加者を追加 | 予定参加者を追加します。 | [予定参加者を追加](/ja/open/development/add-schedule-participant) | | | 予定参加者を削除 | 予定参加者から指定したユーザーを削除します。 | [予定参加者を削除](/ja/open/development/delete-schedule-participant) | - | | 予定参加者を取得 | 予定参加者リストを取得します。 | [予定参加者を取得](/ja/open/development/get-the-participants-of-a-schedule) | - | | 予定の招待回答ステータスを設定 | 予定の招待回答ステータスを設定します。 | [予定の招待回答ステータスを設定](/ja/open/development/configure-response-status) | - | ### フリー / ビジー | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | ------------------- | ------------------------------------ | --------------------------------------------------------- | ------------------ | | ユーザーのフリー / ビジー情報を取得 | 指定したユーザーリストの指定期間内のフリー / ビジー情報を照会します。 | [ユーザーのフリー / ビジー情報を取得](/ja/open/development/free-schedule) | - | ### カレンダー | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | --------------- | ------------------------------- | ---------------------------------------------------------------------------- | ------------------ | | カレンダーを照会 | 本 API を呼び出してユーザーカレンダーを照会します。 | [カレンダーを照会](/ja/open/development/query-a-calendar) | - | | 公開カレンダーを購読 | 本 API を呼び出して公開カレンダーを購読します。 | [公開カレンダーを購読](/ja/open/development/subscribe-to-a-public-calendar) | - | | 公開カレンダーの購読を解除 | 本 API を呼び出して公開カレンダーの購読を解除します。 | [公開カレンダーの購読を解除](/ja/open/development/unsubscribe-from-a-public-calendar) | - | | 購読カレンダーを作成 | 本 API を呼び出して購読カレンダーを作成します。 | [購読カレンダーを作成](/ja/open/development/create-subscription-calendar) | - | | 単一の購読カレンダー詳細を照会 | 本 API を呼び出して購読カレンダーの詳細情報を照会します。 | [単一の購読カレンダー詳細を照会](/ja/open/development/query-a-single-subscription-calendar) | - | | 購読カレンダーを更新 | 本 API を呼び出して単一の購読カレンダー情報を更新します。 | [購読カレンダーを更新](/ja/open/development/update-subscription-calendar) | - | | 購読カレンダーを削除 | 本 API を呼び出して購読カレンダーを削除します。 | [購読カレンダーを削除](/ja/open/development/delete-subscription-calendar) | - | ### チェックイン | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | ---------------- | ------------------------------------------------------- | -------------------- | ------------------ | | 単一予定のチェックイン詳細を表示 | 本 API を呼び出して、単一予定のチェックイン詳細を表示します。 | 単一予定のチェックイン詳細を表示 | - | | 単一予定に対してチェックイン | 予定 ID をもとに指定予定にチェックインします。 | 単一予定に対してチェックイン | - | | 単一予定に対してチェックアウト | 予定 ID をもとに指定予定にチェックアウトします。 | 単一予定に対してチェックアウト | - | | 単一予定のチェックイン詳細を表示 | 予定 ID をもとに単一予定のチェックイン済み・未チェックイン者リストを照会します。 | 単一予定のチェックアウト詳細を表示 | - | | チェックインリンクを取得 | カレンダー ID、ユーザーの unionId、予定 eventId をもとにチェックインリンクを照会します。 | チェックインリンクを取得 | - | | チェックアウトリンクを取得 | カレンダー ID、ユーザーの unionId、予定 eventId をもとにチェックアウトリンクを照会します。 | チェックアウトリンクを取得 | - | ### 会議室 | **API** | **説明** | **新版仕様（新版サーバー API）** | **旧版仕様（サーバー API）** | | ------------------ | ---------------------- | ----------------------------------------------------------------------------------------- | ------------------ | | 会議室のフリー / ビジー情報を取得 | 会議室のフリー / ビジー情報を取得します。 | [会議室のフリー / ビジー情報を取得](/ja/open/development/queries-free-and-busy-meeting-room-information) | - | | 会議室を予約 | 会議室を予約します。 | [会議室を予約](/ja/open/development/add-a-meeting-room) | - | | 会議室の予約をキャンセル | 会議室の予約をキャンセルします。 | [会議室の予約をキャンセル](/ja/open/development/remove-a-meeting-room) | - | ### コールバックイベントリスト 予定機能では、ユーザーによる予定変更時のコールバックイベントをサポートしています。 ## チュートリアル DingTalk では、予定や予定参加者の作成・削除など、よく使われるシーンの利用フロー例を提供しています。 * [予定の作成・変更・照会・削除](/ja/open/development/create-and-delete-an-event) * [予定参加者の追加・取得・削除](/ja/open/development/calendar-participant-process) ## 用語解説 | 権限値 | 説明 | | ---------------------- | ------- | | **free\_busy\_reader** | 空き状況を確認 | | **title\_reader** | 見出しを表示 | | **reader** | 詳細を見る | | **writer** | 作成と編集 | ## リソース定義 | 属性 | タイプ | 説明 | | ------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | String | 予定のグローバル一意 ID。 | | summary | String | 予定の見出し。 | | description | String | 予定の説明。 | | start | Object | 予定の開始時間。 | | start.date | String | 予定の開始日付。形式：yyyy-MM-dd。終日予定の場合は必須、終日以外の予定の場合は空にしてください。 | | start.dateTime | String | 予定の開始時間。ISO-8601 の date-time 形式。終日以外の予定の場合は必須、終日予定の場合は空にしてください。 | | start.timeZone | String | 予定の開始時間が属するタイムゾーン。終日以外の予定の場合は必須、終日予定の場合は空にしてください。 | | end | Object | 予定の終了時間。 | | end.date | String | 予定の終了日付。形式：yyyy-MM-dd。終日予定の場合は必須、終日以外の予定の場合は空にしてください。 | | end.dateTime | String | 予定の終了時間。ISO-8601 の date-time 形式。終日以外の予定の場合は必須、終日予定の場合は空にしてください。 | | end.timeZone | String | 予定の終了時間が属するタイムゾーン。開始時間のタイムゾーンと同一である必要があり、TZ database name 形式を使用します。終日以外の予定の場合は必須、終日予定の場合は空にしてください。 | | isAllDay | Boolean | 終日予定かどうか。 | | recurrence | Object | 予定の繰り返しルール。 | | recurrence.pattern | Object | 繰り返しルール。 | | recurrence.pattern.type | String | 繰り返しルールのタイプ： - **daily**：`interval` 日ごとに繰り返し - **weekly**：`interval` 週の `daysOfWeek` 曜日ごとに繰り返し - **absoluteMonthly**：`interval` 月の `dayOfMonth` 日ごとに繰り返し - **relativeMonthly**：`interval` 月の第 `index` 週の `daysOfWeek` 曜日ごとに繰り返し - **absoluteYearly**：`interval` 年ごとに繰り返し | | recurrence.pattern.dayOfMonth | Integer | `type=absoluteMonthly` のとき、毎月の何日目かを指定します。 | | recurrence.pattern.daysOfWeek | String | 曜日を英語小文字で指定します。複数値の場合はカンマ区切りです。 | | recurrence.pattern.index | String | `type=relativeMonthly` のとき、毎月の第何週かを指定します： - **first** - **second** - **third** - **fourth** - **last** `last` は当月の最終週を表します。 | | recurrence.pattern.interval | Integer | 繰り返し間隔。type により単位が異なります。例：`type=daily` のときは N 日間隔、`type=absoluteYearly` のときは N 年間隔を表します。 | | recurrence.range | Object | 繰り返し範囲。 | | recurrence.range.type | String | 繰り返し範囲のタイプ： - **noEnd**：終了なし - **endDate**：指定日まで繰り返し - **numbered**：指定回数繰り返して終了 | | recurrence.range.endDate | String | 繰り返し終了時間。 | | recurrence.range.numberOfOccurrences | Integer | 繰り返し回数。 | | attendees | Array | 予定参加者リスト。 | | attendees.id | String | ユーザーの unionId。 | | attendees.displayName | String | ユーザー名。 | | attendees.responseStatus | String | 参加者ステータス： - **needsAction**：未操作（デフォルトステータス） - **accepted**：承認 - **declined**：辞退 - **tentative**：保留承認 | | attendees.self | Boolean | 現在の操作ユーザーかどうか。 | | organizer | Object | 予定の主催者。 | | organizer.id | String | 主催者の unionId。 | | organizer.displayName | String | 主催者のユーザー名。 | | organizer.responseStatus | String | 主催者の返信ステータス。 | | organizer.self | Boolean | 現在のユーザーかどうか。 | | location | Object | 予定の場所。 | | location.displayName | String | 場所名。 | | reminders | Array | 通知時間を選択。 | | reminders.method | String | 通知方法： - **dingtalk**：アプリ内通知 - **sms**：SMS 通知 - **phone**：電話通知 | | reminders.minutes | String | 何分前に通知するか。単位は分。 | | onlineMeetingInfo | Object | 予定の作成と同時にオンライン会議を作成します。 | | onlineMeetingInfo.type | String | オンライン会議のタイプ： - **dingtalk**：DingTalk ビデオ会議 | | onlineMeetingInfo.conferenceId | String | 会議 ID。 | | onlineMeetingInfo.url | String | 参加 URL。 | | onlineMeetingInfo.extraInfo | Map | その他の拡張情報。 | | seriesMasterId | String | 繰り返し予定のマスター予定 ID。繰り返し予定でない場合は空です。 | | createTime | String | 作成時間。 | | updateTime | String | 更新時間。 | | status | String | 予定ステータス： - **confirmed**：正常 - **cancelled**：キャンセル済み |