予定を検索する

予定を検索する

検索文字列と検索期間を指定して、API実行ユーザーが参加している予定を探す API です。 次の項目について、それぞれ検索対象にするかどうかを指定できます。

• タイトル（title_search）
• 顧客先（customer_search）
• メモ（memo_search）
• コメント（follow_search）

検索期間は日時や日付で指定します。両方を指定すると、日付の指定が優先されます。 検索期間条件に一つの繰り返し予定が一致する場合、all_repeat_events のオプションで返す結果に最初の日程を入れるか、あるいは全ての日程を入れるかを選択できます。

API名

ScheduleSearchEvents

使用可能なガルーンのバージョン

• クラウド版 Garoon
• パッケージ版 Garoon バージョン 3.0.0以降

リクエスト

例

<parameters text="Test"  
 start="2010-07-06T02:00:00Z" end="2010-07-07T02:00:00Z"  
 title_search="true" customer_search="false"  
 memo_search="false" follow_search="false"  
 all_repeat_events="false"> 
</parameters>

レスポンス

例

<returns> 
  <schedule_event id="66" 
   event_type="normal"  
   public_type="public"  
   detail="Test schedule"  
   version="1278497751" 
   timezone="Asia/Tokyo" 
   end_timezone=”Asia/Tokyo” 
   allday="false"  
   start_only="false"> 
    <members xmlns="http://schemas.cybozu.co.jp/schedule/2008"> 
      <member> 
        <user id="7" name="鈴木 拓也" order="0"/> 
      </member> 
      <member> 
        <facility id="4" name="第一会議室" order="1"/> 
      </member> 
    </members> 
    <when xmlns="http://schemas.cybozu.co.jp/schedule/2008"> 
      <datetime start="2010-07-07T01:00:00Z" end="2010-07-07T02:00:00Z"/> 
    </when> 
  </schedule_event> 
</returns>

予定の空き時間を検索する

検索条件を基に空き時間を検索する API です。

API名

ScheduleSearchFreeTimes

使用可能なガルーンのバージョン

• クラウド版 Garoon
• パッケージ版 Garoon バージョン 3.0.0以降

リクエスト

例

<parameters search_time="00:30:00" search_condition="and"> 
  <candidate start="2010-07-01T00:00:00Z" end="2010-09-01T00:00:00Z"> 
  </candidate> 
  <member> 
    <user id="1"></user> 
  </member> 
  <member> 
    <user id="2"></user> 
  </member> 
  <member> 
    <user id="3"></user> 
  </member> 
</parameters>

レスポンス

例

<returns> 
  <candidate start="2010-06-30T16:00:00Z" end="2010-06-30T16:30:00Z" /> 
  <candidate start="2010-06-30T16:30:00Z" end="2010-06-30T17:00:00Z" /> 
  <candidate start="2010-06-30T17:00:00Z" end="2010-06-30T17:30:00Z" /> 
  <candidate start="2010-06-30T17:30:00Z" end="2010-06-30T18:00:00Z" /> 
  <candidate start="2010-06-30T18:00:00Z" end="2010-06-30T18:30:00Z" /> 
  <candidate start="2010-06-30T18:30:00Z" end="2010-06-30T19:00:00Z" /> 
  <candidate start="2010-06-30T19:00:00Z" end="2010-06-30T19:30:00Z" /> 
  <candidate start="2010-06-30T19:30:00Z" end="2010-06-30T20:00:00Z" /> 
  <candidate start="2010-06-30T20:00:00Z" end="2010-06-30T20:30:00Z" /> 
  <candidate start="2010-06-30T20:30:00Z" end="2010-06-30T21:00:00Z" /> 
</returns>