予定の更新情報を取得する
固定リンクがコピーされました
予定の更新情報を返すAPIです。
APIを実行するユーザーが参加している、かつ指定した期間内に存在する予定のみ、予定のバージョンを返します。
ScheduleGetEventVersions
使用可能なGaroonのバージョン
固定リンクがコピーされました
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
パラメーター名 |
型 |
パラメーター数 |
説明 |
event_item |
base:ItemVersionType |
0~ 無制限 0:予定のバージョンを指定しない |
更新情報を取得する予定のIDとバージョン |
@start |
xsd:dateTime |
1 |
取得期間の開始日時 |
@end |
xsd:dateTime |
0~1 |
取得期間の終了日時 |
@start_for_daily |
xsd:date |
0~1 |
終日予定と期間予定の取得期間の開始日付 |
@end_for_daily |
xsd:date |
0~1 |
終日予定と期間予定の取得期間の終了日付 |
例
1
2
3
4
|
<parameters start="2010-07-01T00:00:00Z" end="2010-09-01T00:00:00Z" start_for_daily="2010-07-01" end_for_daily="2010-09-01">
<event_item id="1" version="1378260785"></event_item>
<event_item id="2" version="1378260884"></event_item>
</parameters>
|
パラメーター名 |
型 |
パラメーター数 |
説明 |
event_item |
base:ItemVersionResultType |
0~ 無制限 |
予定の更新情報 operationの値は、次のようになります。- add
- remove
- リクエストに指定したが、存在しない予定
- リクエストに指定したが、APIを実行するユーザーが参加していない予定
- リクエストに指定したが、取得期間外である予定
繰り返し予定をリクエストに指定した場合は、繰り返し予定のすべての予定が取得期間外のとき
- modify
- リクエストに指定したversionと異なる予定
繰り返し予定をリクエストに指定した場合は、繰り返し予定の少なくとも1つの予定が取得期間内のとき
|
例
1
2
3
4
5
|
<returns>
<event_item id="1" version="1378260789" operation="modify" />
<event_item id="2" version="0" operation="remove" />
<event_item id="3" version="1378260986" operation="add" />
</returns>
|
指定した期間の予定を取得する
固定リンクがコピーされました
リクエスト内のパラメーターに指定された日時の範囲内の予定を取得するAPIです。
APIを実行するユーザーが参加している予定のみ取得されます。
ScheduleGetEvents
使用可能なGaroonのバージョン
固定リンクがコピーされました
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
パラメーター名 |
型 |
パラメーター数 |
説明 |
@start |
xsd:dateTime |
1 |
検索期間の開始日時 |
@end |
xsd:dateTime |
1 |
検索期間の終了日時 |
@start_for_daily |
xsd:date |
0~1 |
終日予定と期間予定を検索する期間の開始日 |
@end_for_daily |
xsd:date |
0~1 |
終日予定と期間予定を検索する期間の終了日 @start_for_dailyと@end_for_dailyを指定すると、@startと@endの期間内の予定に加えて、指定した期間内の期間予定、および終日予定が取得されます。 |
例
1
|
<parameters start="2010-07-01T08:00:00" end="2010-07-03T20:00:00"> </parameters>
|
例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<returns>
<schedule_event id="46984"
event_type="normal"
public_type="public"
plan="メニュー1"
detail="予定タイトル"
description="予定メモ"
version="1277974578"
timezone="Asia/Tokyo"
end_timezone="Asia/Tokyo"
allday="true"
start_only="false" >
<members xmlns="http://schemas.cybozu.co.jp/schedule/2008">
<member>
<user id="1" name="佐藤 太郎" order="0"/>
</member>
</members>
<when xmlns="http://schemas.cybozu.co.jp/schedule/2008">
<date start="2010-07-01" end="2010-07-01" />
</when>
</schedule_event>
</returns>
|
クラウド版Garoon、パッケージ版Garoon 3.1以降
エラー番号 |
説明 |
GRN_SCHD_10401 |
endがstartよりも過去になっています。 |
GRN_SCHD_13227 |
ISO8601以外の形式の日付を指定した場合 |
GRN_SCHD_19015 |
startが指定されていません。 |
パッケージ版Garoon 3.0
エラー番号 |
説明 |
GRN_SCHD_10401 |
endがstartよりも過去になっています。 |
GRN_SCHD_19015 |
startが指定されていません。 |
指定したIDの予定を取得する
固定リンクがコピーされました
リクエスト内で指定された予定IDに対応する予定の詳細情報を取得するAPIです。
APIを実行するユーザーに取得対象の予定に対する閲覧権限があれば取得可能です。
指定した予定IDに対応する予定が存在しない場合、APIは空の情報を返します。
ScheduleGetEventsById
使用可能なGaroonのバージョン
固定リンクがコピーされました
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
パラメーター名 |
型 |
パラメーター数 |
説明 |
event_id/text() |
base:IDType |
1~ 無制限 |
取得する予定のID |
例
1
2
3
|
<parameters>
<event_id xmlns="">1</event_id>
</parameters>
|
例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<returns>
<schedule_event id="1"
event_type="normal"
public_type="public"
plan="メニュー1"
detail="予定タイトル"
description="予定メモ"
version="1277974578"
timezone="Asia/Tokyo"
end_timezone="Asia/Tokyo"
allday="true"
start_only="false" >
<members xmlns="http://schemas.cybozu.co.jp/schedule/2008">
<member>
<user id="1" name="佐藤 太郎" order="0"/>
</member>
</members>
<when xmlns="http://schemas.cybozu.co.jp/schedule/2008">
<date start="2010-07-01" end="2010-07-01" />
</when>
</schedule_event>
</returns>
|
エラー番号 |
説明 |
GRN_SCHD_13001 |
指定した予定へのアクセス権を持っていない場合 |
指定したユーザー、組織、または施設の予定を取得する
固定リンクがコピーされました
指定した期間内にあるユーザー、組織、施設のいずれかの予定を取得するAPIです。
ScheduleGetEventsByTarget
使用可能なGaroonのバージョン
固定リンクがコピーされました
- クラウド版Garoon
- パッケージ版Garoon 3.0以降
パラメーター名 |
型 |
パラメーター数 |
説明 |
@start |
xsd:dateTime |
1 |
検索期間の開始日時 |
@end |
xsd:dateTime |
1 |
検索期間の終了日時 |
@start_for_daily |
xsd:date |
0~1 |
終日予定と期間予定を検索する期間の開始日 |
@end_for_daily |
xsd:date |
0~1 |
終日予定と期間予定を検索する期間の終了日 |
user/@id |
base:IDType |
0~1 |
予定を検索するユーザーを指定する |
group/@id |
base:IDType |
0~1 |
予定を検索する組織を指定する |
facility/@id |
base:IDType |
0~1 |
予定を検索する施設を指定する |
- user、group、facilityパラメーターは同時に指定できません。
- 上記3つのパラメーターの内、ひとつは必ず指定する必要があります。
例
1
2
3
|
<parameters start="2010-07-01T07:00:00" end="2010-07-03T20:00:00">
<user id="5"></user>
</parameters>
|
例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
<returns>
<schedule_event id="1"
event_type="normal"
public_type="public"
plan="メニュー1"
detail="予定タイトル"
description="予定メモ"
version="1277974578"
timezone="Asia/Tokyo"
end_timezone="Asia/Tokyo"
allday="true"
start_only="false" >
<members xmlns="http://schemas.cybozu.co.jp/schedule/2008">
<member>
<user id="5" name="川崎 茂" order="0"/>
</member>
</members>
<when xmlns="http://schemas.cybozu.co.jp/schedule/2008">
<date start="2010-07-01" end="2010-07-01" />
</when>
</schedule_event>
</returns>
|