イベントの検索
Google Calendarアカウントのイベントを検索します。
スコープ
このカードで必要なOAuthスコープのリストは「アクションカード」を参照してください。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
カレンダー（Calendar） |
検索するイベントが含まれているカレンダーを選択します。 |
ドロップダウン | 正 |
|
結果セット（Result Set） |
次のいずれかのオプションを選択します。
|
ドロップダウン | 正 |
入力
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
イベント（Event） |
|||
|
クエリ（Query） |
拡張プロパティを除く任意のフィールドで一致するイベントを特定するための自由テキストの検索用語。 |
テキスト | FALSE |
|
並べ替え順序（Order By） |
|
ドロップダウン | FALSE |
|
削除済みの表示（Show Deleted） |
結果に削除済みのイベント（ステータスが |
ドロップダウン | FALSE |
|
非表示の招待の表示（Show Hidden Invitations） |
結果に非表示の招待を含めるかどうかを示します。 |
ドロップダウン | FALSE |
|
単一のイベント（Single Events） |
繰り返しイベントをインスタンスに拡張し、単一の1回限りのイベントと繰り返しイベントのインスタンスのみを返し、基になっている繰り返しイベント自体は返さないかどうかを示します。 |
ドロップダウン | FALSE |
|
ICalUID |
RFC5545で定義されているイベントの一意の識別子。複数のカレンダーシステムをまたがってイベントを一意に識別するために使用され、importメソッドを介してイベントをインポートする際に指定する必要があります。 |
テキスト | FALSE |
|
最大参加者数（Max Attendees） |
検索に含める参加者の最大人数。 |
数値 | FALSE |
|
プライベート拡張プロパティ（Private Extended Property） |
|
テキスト | FALSE |
|
共有拡張プロパティ（Shared Extended Property） |
|
テキスト | FALSE |
|
最小日時（Time Min） |
カレンダーが使用可能かどうかを調べる開始日時。入力は |
日時 | FALSE |
|
最大日時（Time Max） |
カレンダーが使用可能かどうかを調べる終了日時。入力は |
日時 | FALSE |
|
最小更新日時（Updated Min） |
フィルタリングの条件とするイベントの最終変更日時の下限（RFC3339タイムスタンプ）。 |
日時 | FALSE |
|
タイムゾーン（Time Zone） |
次の形式のタイムゾーン。
|
日時 | FALSE |
入力フィールドを空白のままにした場合、検索結果はすべてのカレンダーイベントを返します。
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
フィールド（Fields） |
||
|
タイプ（Type） |
イベントのタイプ。 これはカレンダーイベントであるため、多くの場合はcalendar#eventとして返されます。 |
テキスト |
|
イベントID（Event ID） |
情報を取得するイベントの一意のID。 |
テキスト |
|
ステータス（Status） |
イベントのステータス。
|
テキスト |
|
HTMLリンク（Html Link） |
Google Calendar Web UI内のこのイベントへの絶対リンク。読み取り専用。 |
テキスト |
|
作成日時（Created Time） |
イベントが作成された日時。ISO形式（YYYY-MM-DDThh:mm:ss+00:00）です。 +00:00はタイムゾーンオフセットです。 |
テキスト |
|
更新日時（Updated Time） |
イベントが最後に更新された日時。ISO形式（YYYY-MM-DDThh:mm:ss+00:00）です。 +00:00はタイムゾーンオフセットです。 |
テキスト |
|
概要 |
カレンダーイベントの名前の見出し。 |
テキスト |
|
説明（Description） |
参加者向けの詳細を含むイベントの説明。 |
テキスト |
|
ICalUID |
RFC5545で定義されているイベントの一意の識別子。複数のカレンダーシステムをまたがってイベントを一意に識別するために使用され、importメソッドを介してイベントをインポートする際に指定する必要があります。 注:
ICalUIDとidは同一ではなく、イベントの作成時にはどちらか1つのみ指定する必要があります。 繰り返しイベントにおけるセマンティクス的違いの1つは、1つのイベントのすべての出現が異なるidを持つのに対し、すべてのICalUIDは同一であるということです。 |
テキスト |
|
開始日時（Start Time） |
イベントを開始する日時。ISO形式（YYYY-MM-DDThh:mm:ss+00:00）です。 +00:00はタイムゾーンオフセットです。 |
テキスト |
|
終了日時（End Time） |
イベントを終了する日時。ISO形式（YYYY-MM-DDThh:mm:ss+00:00）です。 +00:00はタイムゾーンオフセットです。 |
テキスト |
|
ロケーション（Location） |
イベントの地理的な場所（自由形式のテキスト）。 |
テキスト |
|
参加者メール（Attendee Emails） |
イベントに招待されるゲストのメールアドレス。このフィールドは空白のままにすることができます。 注:
イベントは、それが作成されたカレンダーに表示されます。 |
テキスト |
|
リマインダー（Reminders） |
||
|
方式（Method） |
リマインダーの送信方式。オプションにはpopupとemailがあります。 |
テキスト |
|
分（Minutes） |
リマインダー発行までに経過する必要がある時間（単位は分）。範囲は1～40320。 |
テキスト |