リソース: monitor

このページでは、メールのモニタリング時に Email Audit API の monitor リソースで使用できるパラメータについて説明します。

フィールド 説明
destUserName

必須。

宛先ユーザー: メッセージのコピーを受信するユーザー名(メールアドレス全体ではありません)。これは、メッセージを監査するユーザーです。 たとえば、example.com ドメインで kai@example.com を宛先ユーザーにするには、name='destUserName' value='kai' を使用します。

一意の「宛先ユーザー - 送信元ユーザー」ペアに対して存在するモニターは 1 つだけです。同じ「宛先ユーザー - 送信元ユーザー」ペアに対して複数のモニターが作成された場合、最後のモニターの設定が保持されます。監査対象のメール設定を更新する方法は次のとおりです。更新については、メール モニターを更新するをご覧ください。

beginDate

省略可。

監査の開始日。この要素が空の文字列の場合、メール監査は現在の日付から開始されます。この日付は、当日以降の日付にする必要があります。日付形式は YYYY-MM-dd HH:mm です。HH は 0 ~ 23 の 1 日の時間を表し、mm は 0 ~ 59 の 1 時間の分を表します。

タイムゾーンは協定世界時(UTC)形式です。新しいモニターを作成する前に、時間を UTC 形式に変換します。

endDate

必須。

監査が停止する日付。この値は beginDate パラメータより大きくする必要があります。日付形式は YYYY-MM-dd HH:mm です。HH は 0 ~ 23 の 1 日の時間を表し、mm は 0 ~ 59 の 1 時間の分を表します。

タイムゾーンは協定世界時(UTC)形式です。新しいモニターを作成する前に、時間を UTC 形式に変換します。

incomingEmailMonitorLevel

省略可。

受信メールに対して検証された情報の量。値が入力されていない場合、デフォルトは FULL_MESSAGE です。指定できる値は次のとおりです。

  • FULL_MESSAGE: 受信したメールの本文全体が宛先ユーザーに送信されます。
  • HEADER_ONLY: 受信メールのヘッダー情報のみが宛先ユーザーに送信されます。
outgoingEmailMonitorLevel

省略可。

送信メールでキャプチャされたモニタリング対象情報の量。値が入力されていない場合、デフォルトは FULL_MESSAGE です。指定できる値は次のとおりです。

  • FULL_MESSAGE: 送信されるメールの本文全体が宛先ユーザーに送信されます。
  • HEADER_ONLY: 送信メールのヘッダー情報のみが宛先ユーザーに送信されます。
draftMonitorLevel

省略可。

下書きメールでキャプチャされる監査情報の量。この要素に値が指定されていないか、空の文字列が指定されている場合、メールの下書きは監査されません。デフォルトは NONE です。

  • FULL_MESSAGE: 下書きメールの本文全体が宛先ユーザーに送信されます。
  • HEADER_ONLY: 宛先ユーザーには、下書きメールのヘッダーのみが送信されます。
  • NONE: メールの下書きは宛先ユーザーに送信されません。
chatMonitorLevel

省略可。

アーカイブされた Hangouts Chat でキャプチャされた監査情報の量。この設定は、Google Chat ではなく、従来の Hangouts Chat にのみ適用されます。 Hangouts Chat のサポートは終了しました。Chat メッセージのアーカイブについては、Chat メッセージをアーカイブするをご覧ください。この要素に値が指定されていない場合、または空の文字列が指定されている場合、チャットは監査されません。これがデフォルトです。

  • FULL_MESSAGE: チャット テキスト全体が宛先ユーザーに送信されます。
  • HEADER_ONLY: チャットのヘッダーのみが宛先ユーザーに送信されます。