イベントの検索

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

オプション

フィールド定義タイプ必須
Calendar (カレンダー)カレンダーイベントを検索する使用可能なカレンダーのドロップダウンリスト。ドロップダウンTRUE
Result Set (結果セット) 選択肢は次のとおりです。
  • [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
注

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

出力

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

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

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

文字列
Html Link (HTMLリンク)Googleカレンダー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(概要)カレンダーイベントの名前の見出し。文字列
Description(説明)参加者向けの詳細を含むイベントの説明。文字列
ICalUID (ICalUID)RFC5545で定義されているイベントの一意識別子。複数のカレンダーシステムをまたがってイベントを一意に識別するために使用され、importメソッドを介してイベントをインポートする際に指定する必要があります。文字列
注

ICalUIDidは同一ではなく、イベントの作成時にはどちらか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カレンダーコネクタ

Okta Workflowsの要素について

GoogleカレンダーAPIドキュメンテーション