BatchUsageLogEvents

デバイスからの events のイベントログのバッチ処理。

JSON 表現
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
フィールド
device

string

存在する場合、デバイスの名前。形式は「enterprises/{enterpriseId}/devices/{deviceId}」。

user

string

存在する場合は、このデバイスを所有しているユーザーのリソース名。形式は「enterprises/{enterpriseId}/users/{userId}」です。

retrievalTime

string (Timestamp format)

イベントのバッチがデバイスから収集されたときのデバイスのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

usageLogEvents[]

object (UsageLogEvent)

デバイスによって報告された UsageLogEvent のリスト。イベント時刻順に並べ替えられます。

UsageLogEvent

デバイスで記録されたイベント。

JSON 表現
{
  "eventId": string,
  "eventTime": string,
  "eventType": enum (EventType),

  // Union field event can be only one of the following:
  "adbShellCommandEvent": {
    object (AdbShellCommandEvent)
  },
  "adbShellInteractiveEvent": {
    object (AdbShellInteractiveEvent)
  },
  "appProcessStartEvent": {
    object (AppProcessStartEvent)
  },
  "keyguardDismissedEvent": {
    object (KeyguardDismissedEvent)
  },
  "keyguardDismissAuthAttemptEvent": {
    object (KeyguardDismissAuthAttemptEvent)
  },
  "keyguardSecuredEvent": {
    object (KeyguardSecuredEvent)
  },
  "filePulledEvent": {
    object (FilePulledEvent)
  },
  "filePushedEvent": {
    object (FilePushedEvent)
  },
  "certAuthorityInstalledEvent": {
    object (CertAuthorityInstalledEvent)
  },
  "certAuthorityRemovedEvent": {
    object (CertAuthorityRemovedEvent)
  },
  "certValidationFailureEvent": {
    object (CertValidationFailureEvent)
  },
  "cryptoSelfTestCompletedEvent": {
    object (CryptoSelfTestCompletedEvent)
  },
  "keyDestructionEvent": {
    object (KeyDestructionEvent)
  },
  "keyGeneratedEvent": {
    object (KeyGeneratedEvent)
  },
  "keyImportEvent": {
    object (KeyImportEvent)
  },
  "keyIntegrityViolationEvent": {
    object (KeyIntegrityViolationEvent)
  },
  "loggingStartedEvent": {
    object (LoggingStartedEvent)
  },
  "loggingStoppedEvent": {
    object (LoggingStoppedEvent)
  },
  "logBufferSizeCriticalEvent": {
    object (LogBufferSizeCriticalEvent)
  },
  "mediaMountEvent": {
    object (MediaMountEvent)
  },
  "mediaUnmountEvent": {
    object (MediaUnmountEvent)
  },
  "osShutdownEvent": {
    object (OsShutdownEvent)
  },
  "osStartupEvent": {
    object (OsStartupEvent)
  },
  "remoteLockEvent": {
    object (RemoteLockEvent)
  },
  "wipeFailureEvent": {
    object (WipeFailureEvent)
  },
  "connectEvent": {
    object (ConnectEvent)
  },
  "dnsEvent": {
    object (DnsEvent)
  },
  "stopLostModeUserAttemptEvent": {
    object (StopLostModeUserAttemptEvent)
  },
  "lostModeOutgoingPhoneCallEvent": {
    object (LostModeOutgoingPhoneCallEvent)
  },
  "lostModeLocationEvent": {
    object (LostModeLocationEvent)
  },
  "enrollmentCompleteEvent": {
    object (EnrollmentCompleteEvent)
  }
  // End of list of possible types for union field event.
}
フィールド
eventId

string (int64 format)

イベントの一意の ID。

eventTime

string (Timestamp format)

イベントがログに記録されたときのデバイスのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

eventType

enum (EventType)

デバイスで報告された特定の使用状況ログのイベントタイプ。これを使用して、アクセスする event フィールドを決定します。

共用体フィールド event。デバイスに記録されるイベントの種類。送信されるタイミング、イベントがログに記録されるタイミング、含まれるフィールドに関する制限の詳細については、各イベントタイプをご覧ください。event は次のいずれかになります。
adbShellCommandEvent

object (AdbShellCommandEvent)

「adb shell command」を介して ADB を介してシェルコマンドが発行されました。SECURITY_LOGS の一部です。

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

「adb shell」で ADB インタラクティブ シェルを開きました。SECURITY_LOGS の一部です。

appProcessStartEvent

object (AppProcessStartEvent)

アプリプロセスが開始された。SECURITY_LOGS の一部です。

keyguardDismissedEvent

object (KeyguardDismissedEvent)

キーガードが閉じられました。SECURITY_LOGS の一部です。

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

デバイスのロック解除が試みられました。SECURITY_LOGS の一部です。

keyguardSecuredEvent

object (KeyguardSecuredEvent)

ユーザーまたはタイムアウトにより、デバイスがロックされました。SECURITY_LOGS の一部です。

filePulledEvent

object (FilePulledEvent)

デバイスからファイルがダウンロードされました。SECURITY_LOGS の一部です。

filePushedEvent

object (FilePushedEvent)

デバイスにファイルがアップロードされました。SECURITY_LOGS の一部です。

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

システムの信頼できる認証情報ストレージに新しいルート証明書がインストールされました。SECURITY_LOGS の一部です。

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

システムの信頼できる認証情報ストレージからルート証明書が削除された。SECURITY_LOGS の一部です。

certValidationFailureEvent

object (CertValidationFailureEvent)

X.509v3 証明書を検証できませんでした。現在、この検証は Wi-Fi アクセス ポイント上で行われています。サーバー証明書の検証時に不一致が生じている可能性があります。ただし、将来的には、X.509v3 証明書の他の検証イベントが含まれる可能性があります。SECURITY_LOGS の一部です。

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Android の組み込み暗号ライブラリ(BoringSSL)が有効かどうかを検証します。デバイスの起動時に常に成功し、失敗した場合、デバイスは信頼できないとみなされます。SECURITY_LOGS の一部です。

keyDestructionEvent

object (KeyDestructionEvent)

ユーザーがインストールした暗号鍵、管理者がインストールした鍵、システムによって保持されている秘密鍵を含む暗号鍵が、ユーザーまたは管理者によってデバイスから削除された場合。SECURITY_LOGS の一部です。

keyGeneratedEvent

object (KeyGeneratedEvent)

暗号鍵(ユーザーがインストールした鍵、管理者がインストールした鍵、システムが保持する秘密鍵を含む)が、ユーザーまたは管理者によってデバイスにインストールされていること。SECURITY_LOGS の一部です。

keyImportEvent

object (KeyImportEvent)

ユーザーがインストールした暗号鍵、管理者がインストールした鍵、システムが管理する秘密鍵などの暗号鍵が、ユーザーまたは管理者によってデバイスにインポートされます。SECURITY_LOGS の一部です。

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

ストレージの破損、ハードウェア障害、または OS の問題が原因で、暗号鍵(ユーザーがインストールした鍵、管理者がインストールした鍵、システムが保持する秘密鍵など)が破損していると判断されました。SECURITY_LOGS の一部です。

loggingStartedEvent

object (LoggingStartedEvent)

usageLog ポリシーを有効にしました。SECURITY_LOGS の一部です。

loggingStoppedEvent

object (LoggingStoppedEvent)

usageLog ポリシーが無効になりました。SECURITY_LOGS の一部です。

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

監査ログのバッファが容量の 90% に達したため、古いイベントが破棄される可能性があります。SECURITY_LOGS の一部です。

mediaMountEvent

object (MediaMountEvent)

リムーバブル メディアがマウントされました。SECURITY_LOGS の一部です。

mediaUnmountEvent

object (MediaUnmountEvent)

リムーバブル メディアがマウント解除されました。SECURITY_LOGS の一部です。

osShutdownEvent

object (OsShutdownEvent)

デバイスがシャットダウンされました。SECURITY_LOGS の一部です。

osStartupEvent

object (OsStartupEvent)

デバイスが起動されました。SECURITY_LOGS の一部です。

remoteLockEvent

object (RemoteLockEvent)

デバイスまたはプロファイルは LOCK コマンドを介してリモートでロックされました。SECURITY_LOGS の一部です。

wipeFailureEvent

object (WipeFailureEvent)

リクエストに対して仕事用プロファイルまたは会社所有のデバイスをワイプできませんでした。たとえば、ユーザーによって開始されたものもあれば、管理者が開始したものもあります。delete が受信されました。SECURITY_LOGS の一部です。

connectEvent

object (ConnectEvent)

標準ネットワーク スタックを介して TCP 接続イベントが開始されました。NETWORK_ACTIVITY_LOGS の一部です。

dnsEvent

object (DnsEvent)

標準ネットワーク スタックを介して DNS ルックアップ イベントが開始されました。NETWORK_ACTIVITY_LOGS の一部です。

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

デバイスの紛失モードを解除しようとする試み。

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

通話の発信は、デバイスが紛失モードになっているときに行われます。

lostModeLocationEvent

object (LostModeLocationEvent)

デバイスが紛失モードになっている場合の、紛失モードでの位置情報の更新。

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

デバイスの登録が完了しました。AMAPI_LOGS の一部です。

KeyguardDismissedEvent

この型にはフィールドがありません。

キーガードが閉じられました。意図的に空にします。

KeyguardDismissAuthAttemptEvent

デバイスのロック解除が試みられました。

JSON 表現
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
フィールド
success

boolean

ロック解除に成功したかどうか。

strongAuthMethodUsed

boolean

デバイスのロック解除に強力な認証形式(パスワード、PIN、パターン)が使用されたかどうか。

KeyguardSecuredEvent

この型にはフィールドがありません。

ユーザーまたはタイムアウトにより、デバイスがロックされました。意図的に空にします。

FilePulledEvent

デバイスからファイルがダウンロードされました。

JSON 表現
{
  "filePath": string
}
フィールド
filePath

string

pull されるファイルのパス。

FilePushedEvent

デバイスにファイルがアップロードされました。

JSON 表現
{
  "filePath": string
}
フィールド
filePath

string

プッシュされるファイルのパス。

CertAuthorityInstalledEvent

システムの信頼できる認証情報ストレージに新しいルート証明書がインストールされました。この機能は、完全管理対象デバイスであればデバイス全体、組織所有の仕事用プロファイルを使って仕事用プロファイル内で利用できます。

JSON 表現
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
フィールド
certificate

string

証明書のサブジェクト。

userId

integer

証明書のインストール イベントが発生したユーザー。Android 11 以降を搭載したデバイスでのみご利用いただけます。

success

boolean

インストール イベントが成功したかどうか。

CertAuthorityRemovedEvent

システムの信頼できる認証情報ストレージからルート証明書が削除された。この機能は、完全管理対象デバイスであればデバイス全体、組織所有の仕事用プロファイルを使って仕事用プロファイル内で利用できます。

JSON 表現
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
フィールド
certificate

string

証明書のサブジェクト。

userId

integer

証明書削除イベントが発生したユーザー。Android 11 以降を搭載したデバイスでのみご利用いただけます。

success

boolean

削除が成功したかどうか。

CertValidationFailureEvent

X.509v3 証明書を検証できませんでした。現在、この検証は Wi-Fi アクセス ポイント上で行われています。サーバー証明書の検証時に不一致が生じている可能性があります。ただし、将来的には、X.509v3 証明書の他の検証イベントが含まれる可能性があります。

JSON 表現
{
  "failureReason": string
}
フィールド
failureReason

string

認証の検証で不合格となった理由。

CryptoSelfTestCompletedEvent

Android の組み込み暗号ライブラリ(BoringSSL)が有効かどうかを検証します。デバイスの起動時に常に成功し、失敗した場合、デバイスは信頼できないとみなされます。

JSON 表現
{
  "success": boolean
}
フィールド
success

boolean

テストが成功したかどうか。

KeyDestructionEvent

ユーザーがインストールした暗号鍵、管理者がインストールした鍵、システムによって保持されている秘密鍵を含む暗号鍵が、ユーザーまたは管理者によってデバイスから削除された場合。この機能は、完全管理対象デバイスであればデバイス全体、組織所有の仕事用プロファイルを使って仕事用プロファイル内で利用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
フィールド
keyAlias

string

キーのエイリアス。

applicationUid

integer

キーを所有するアプリの UID。

success

boolean

オペレーションが成功したかどうか。

KeyGeneratedEvent

暗号鍵(ユーザーがインストールした鍵、管理者がインストールした鍵、システムが管理する秘密鍵など)が、ユーザーまたは管理者によってデバイスにインストールされている。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
フィールド
keyAlias

string

キーのエイリアス。

applicationUid

integer

鍵を生成したアプリの UID。

success

boolean

オペレーションが成功したかどうか。

KeyImportEvent

ユーザーがインストールした暗号鍵、管理者がインストールした鍵、システムが管理する秘密鍵などの暗号鍵が、ユーザーまたは管理者によってデバイスにインポートされます。この機能は、完全管理対象デバイスであればデバイス全体、組織所有の仕事用プロファイルを使って仕事用プロファイル内で利用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
フィールド
keyAlias

string

キーのエイリアス。

applicationUid

integer

鍵をインポートしたアプリケーションの UID

success

boolean

オペレーションが成功したかどうか。

KeyIntegrityViolationEvent

ストレージの破損、ハードウェア障害、または OS の問題が原因で、暗号鍵(ユーザーがインストールした鍵、管理者がインストールした鍵、システムが保持する秘密鍵など)が破損していると判断されました。この機能は、完全管理対象デバイスであればデバイス全体、組織所有の仕事用プロファイルを使って仕事用プロファイル内で利用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer
}
フィールド
keyAlias

string

キーのエイリアス。

applicationUid

integer

キーを所有するアプリの UID

LoggingStartedEvent

この型にはフィールドがありません。

usageLog ポリシーを有効にしました。意図的に空にします。

LoggingStoppedEvent

この型にはフィールドがありません。

usageLog ポリシーが無効になりました。意図的に空にします。

LogBufferSizeCriticalEvent

この型にはフィールドがありません。

デバイスの usageLog バッファが容量の 90% に達したため、古いイベントが破棄される可能性があります。意図的に空にします。

MediaMountEvent

リムーバブル メディアがマウントされました。

JSON 表現
{
  "mountPoint": string,
  "volumeLabel": string
}
フィールド
mountPoint

string

マウント ポイント。

volumeLabel

string

ボリューム ラベル。組織所有の管理対象プロファイル デバイスで秘匿化されて空の文字列になりました。

MediaUnmountEvent

リムーバブル メディアがマウント解除されました。

JSON 表現
{
  "mountPoint": string,
  "volumeLabel": string
}
フィールド
mountPoint

string

マウント ポイント。

volumeLabel

string

ボリューム ラベル。組織所有の管理対象プロファイル デバイスで秘匿化されて空の文字列になりました。

OsShutdownEvent

この型にはフィールドがありません。

デバイスがシャットダウンされました。意図的に空にします。

OsStartupEvent

デバイスが起動されました。

JSON 表現
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
フィールド
verifiedBootState

enum (VerifiedBootState)

確認付きブートの状態。

verityMode

enum (DmVerityMode)

dm-verity モードに設定します。

RemoteLockEvent

デバイスまたはプロファイルは LOCK コマンドを介してリモートでロックされました。

JSON 表現
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
フィールド
adminPackageName

string

変更をリクエストする管理アプリのパッケージ名。

adminUserId

integer

変更をリクエストした管理アプリのユーザー ID。

targetUserId

integer

変更がリクエストされたユーザー ID。

WipeFailureEvent

この型にはフィールドがありません。

リクエストに対して仕事用プロファイルまたは会社所有のデバイスをワイプできませんでした。たとえば、ユーザーによって開始されたものもあれば、管理者が開始したものもあります。delete が受信されました。意図的に空にします。

ConnectEvent

標準ネットワーク スタックを介して TCP 接続イベントが開始されました。

JSON 表現
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
フィールド
destinationIpAddress

string

connect 呼び出しの宛先 IP アドレス。

destinationPort

integer

connect 呼び出しの宛先ポート。

packageName

string

接続呼び出しを行った UID のパッケージ名。

DnsEvent

標準ネットワーク スタックを介して DNS ルックアップ イベントが開始されました。

JSON 表現
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
フィールド
hostname

string

検索されたホスト名。

ipAddresses[]

string

DNS ルックアップで返される IP アドレスのリスト(切り捨てられる場合があります)(最大 10 個の IPv4 または IPv6 アドレス)。

totalIpAddressesReturned

string (int64 format)

DNS ルックアップ イベントから返された IP アドレスの数。ログに記録するアドレスが多すぎる場合は、ipAddress の数より大きくなることがあります。

packageName

string

DNS ルックアップを実施した UID のパッケージ名。

StopLostModeUserAttemptEvent

ユーザーが紛失モードの停止を試みたことを示す紛失モードイベント。

JSON 表現
{
  "status": enum (Status)
}
フィールド
status

enum (Status)

紛失モードの停止試行のステータス。

LostModeOutgoingPhoneCallEvent

この型にはフィールドがありません。

デバイスが紛失モードのときに通話の発信が行われたことを示すイベント。意図的に空にします。

LostModeLocationEvent

デバイスの位置情報とバッテリー残量(%)を含む、紛失モードイベント。

JSON 表現
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
フィールド
location

object (Location)

デバイスの位置情報

batteryLevel

integer

バッテリー残量(0 ~ 100 の数値)

場所

緯度と経度を含むデバイスの位置情報。

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

場所の緯度の位置

longitude

number

場所の経度の位置

EnrollmentCompleteEvent

この型にはフィールドがありません。

デバイスの登録が完了したことを示します。この時点でユーザーはランチャーに入っているはずです。この時点でデバイスはコンプライアンスに準拠し、すべてのセットアップ手順が完了しています。意図的に空にします。