イベントを検索する

Google Calendarアカウントのイベントを検索します。

オプション

フィールド 定義 タイプ 必須
Calendar (カレンダー) カレンダーイベントを検索する使用可能なカレンダーのドロップダウンリスト。 ドロップダウン TRUE
結果セット 選択肢は次のとおりです。
  • First Event（最初のイベント）：検索結果の最初のイベントを返します。
  • All Events（すべてのイベント）：検索結果のすべてのイベントを返します。
 ドロップダウン TRUE

入力

フィールド 定義 タイプ 必須
Event（イベント）
Query（クエリ） 拡張プロパティーを除く任意のフィールドで一致するイベントを特定するための自由テキストの検索用語。 文字列 FALSE
Order By (並べ替え順序) [Start Time (開始日時)]：イベントの開始日時で並べ替えます（昇順）。単一のイベントをクエリーする場合のみ。

［Updated（更新日時）］：最終変更日時で並べ替えます（昇順）。

 ドロップダウン FALSE
Show Deleted（削除済みの表示） 結果に削除済みのイベント（ステータスがcanceledに等しいもの）を含めるかどうかを示します。 ドロップダウン FALSE
Show Hidden Invitations（非表示の招待の表示） 結果に非表示の招待を含めるかどうかを示します。 ドロップダウン FALSE
Single Events（単一のイベント） 繰り返しイベントをインスタンスに拡張し、単一の1回限りのイベントと繰り返しイベントのインスタンスのみを返し、基になっている繰り返しイベント自体は返さないかどうかを示します。 ドロップダウン FALSE
ICalUID (ICalUID) RFC5545で定義されているイベントの一意識別子。複数のカレンダーシステムをまたがってイベントを一意に識別するために使用され、importメソッドを介してイベントをインポートする際に指定する必要があります。 文字列 FALSE
Max Attendees（最大参加者数） 検索に含める参加者の最大人数。 数値 FALSE
Private Extended Property (プライベート拡張プロパティー) propertyName=valueで指定される拡張プロパティー制約。プライベートプロパティーのみを照合します。 文字列 FALSE
Shared Extended Property (共有拡張プロパティー) propertyName=valueで指定される拡張プロパティー制約。共有プロパティーのみを照合します。 文字列 FALSE
Time Min (最小日時) カレンダーが使用可能かどうかを調べる開始日時。入力はYYYY-MM-DDTHH:MM:SSZの形式にする必要があります。 日時 FALSE
Time Max (最大日時) カレンダーが使用可能かどうかを調べる終了日時。入力はYYYY-MM-DDTHH:MM:SSZの形式にする必要があります。 日時 FALSE
Updated Min (最小更新日時) フィルタリングの条件とするイベントの最終変更日時の下限（RFC3339タイムスタンプ）。 日時 FALSE
Time Zone (タイムゾーン) 次の形式のタイムゾーン。
  • UTC+-HH
  • GMT+-HH
  • CEST+-HH（中央ヨーロッパ夏時間）
  • EEST+-HH（東ヨーロッパ夏時間）
 日時 FALSE
注

入力フィールドを空白のままにした場合、検索結果はすべてのカレンダーイベントを返します。

Output（出力）

フィールド 定義 タイプ
Fields（フィールド）
タイプ イベントのタイプ。これはカレンダーイベントであることを考慮すると、ほとんどの場合はcalendar#eventとして返します。 文字列
Event ID (イベントID) 情報を取得するイベントの一意のID。 文字列
ステータス イベントのステータス。取り得る値は次のとおりです。

  • [confirmed (確定)]：イベントは確定されています。これはデフォルトのステータスです。

  • [tentative (暫定)]：イベントは暫定的に確認されています

  • [canceled (取り消し)]：イベントは取り消されています

 文字列
Html Link (HTMLリンク) 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はタイムゾーンオフセットです。 文字列
Summary（概要） カレンダーイベントの名前の見出し。 文字列
説明 参加者向けの詳細を含むイベントの説明。 文字列
ICalUID (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までです。 文字列

関連項目

Google Calendarコネクター

Workflows要素

Google Calendar APIのドキュメント