複数の予定を取得する
複数の予定を取得する
クエリで条件を指定して、複数の予定を取得します。
- 繰り返し予定を含む場合は、すべての日の予定が返ります。
- 仮予定を含む場合は、すべての候補の予定が返ります。
- クエリで
target
を指定しない場合は、API を実行したユーザーが参加する予定だけを取得します。 - 画面で「予定あり」と表示されていても、API を実行したユーザーが閲覧できない予定(非公開の予定)は取得できません。
非公開の予定を含む予定の有無を調べる場合は、 空き予定を検索する API を利用してください。
URL
クラウド版
https://sample.cybozu.com/g/api/v1/schedule/events
パッケージ版
- Windows 環境
- http://
サーバーのIPアドレスまたはホスト名
/scripts/インストール識別子
/grn.exe/api/v1/schedule/events - Linux 環境
- http://
サーバーのIPアドレスまたはホスト名
/cgi-bin/インストール識別子
/grn.cgi/api/v1/schedule/events
HTTP メソッド
GET
利用できるバージョン
- クラウド版 Garoon
- パッケージ版 Garoon 4.10 以降
必要なアクセス権
- 予定の閲覧権限
リクエスト
パラメーター
リクエストパラメーターは、URL クエリパラメーターとして送信してください。
ただし、
Garoon REST API リクエストを送信する API を使って実行する場合は、リクエストボディとして指定できます。
パラメーター名 | 型 | 必須 | 説明 |
---|---|---|---|
fields | 文字列 | 省略可 | 取得するプロパティ スケジュールオブジェクト のプロパティを指定できます。 複数のプロパティを指定するには、半角カンマで区切ります。 |
orderBy | 文字列 | 省略可 | ソート条件 プロパティ名と並び順の間に半角スペースを入れて指定します。 たとえば、 createdAt を降順で並べ替える場合には、「orderBy=createdAt desc」を指定します。指定できるプロパティ名および並び順は次のとおりです。
updatedAt の昇順で並べ替えられます。 |
rangeStart | 文字列 | 省略可 | 予定の開始日時の取得期間(開始日時)rangeStart で指定した日時より後に開始する予定に絞り込みます。RFC 3339 形式で指定します。 たとえば、日本時間の2022年10月19日9時10分30秒を指定したい場合には、次のように指定します。
rangeEnd を指定する場合には、rangeEnd より前の値を指定してください。 |
rangeEnd | 文字列 | 省略可 | 予定の終了日時の取得期間(終了日時)rangeEnd で指定した日時より前に終了した予定に絞り込みます。RFC 3339 形式で指定します。 rangeStart を指定する場合には、rangeStart より後の値を指定してください。 |
target | 文字列 | 条件必須 | 絞り込みに使用する ID 次のいずれかの値を指定します。
targetType を指定した場合は必須です。target と targetType のどちらも省略した場合、次のいずれかの値を指定します。
|
targetType | 文字列 | 条件必須 | 絞り込みに使用する ID のタイプ 次のいずれかの値を指定します。
target を指定した場合は必須です。 |
keyword | 文字列 | 条件必須 | 予定検索のキーワード 次のいずれかの項目にキーワードを含む予定に絞り込みます。
excludeFromSearch を指定した場合は必須です。 |
excludeFromSearch | 文字列 | 省略可 | キーワード検索から除外する項目 次のいずれかの値を指定します。
|
showPrivate | 真偽値 | 省略可 | 次にいずれかに該当する、閲覧権限のない予定も含めて取得するかどうかを指定します。 取得できるスケジュールオブジェクトのプロパティには制限があります。詳細は、 閲覧権限がない予定で取得できるプロパティ を参照してください。
次のいずれかの値を指定します。
非公開の予定を完全に隠す設定 targetType に「user」または「organization」を指定していると、非公開の予定を取得できません。 |
limit | 数値 | 省略可 | 取得する予定の件数 1 から 1,000 まで指定できます。省略すると 100 が設定されます。 指定された条件に一致する予定がさらにある場合でも、指定した値より取得できる予定の数は少なくなる可能性があります。 リクエストパラメーターで指定された条件に一致するレコードの中で、閲覧権限がないレコードは除外されます。 |
offset | 数値 | 省略可 | 取得する予定の先頭からスキップする数 省略すると、 0 が設定されます。 |
リクエストの例
URL
https://sample.cybozu.com/g/api/v1/schedule/events?limit=100&orderBy=updatedAt%20asc
ヘッダー
|
|
リクエストヘッダーの詳細は Garoon REST API の共通仕様 を参照してください。
ボディ
|
|
レスポンス
処理が成功すると、予定の内容が JSON 形式で返ります。
形式の詳細は
スケジュールオブジェクト を確認してください。
レスポンスの例
|
|
クラウド版では、 additionalItems
を取得できません。
サンプルコード
curlを使ったリクエスト
|
|
Garoon REST API リクエストを送信する API を使ったリクエスト
|
|