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"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "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)

شناسه منحصر به فرد رویداد

eventTime

string ( Timestamp format)

مهر زمانی دستگاه هنگام ثبت رویداد.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

eventType

enum ( EventType )

نوع رویداد گزارش استفاده خاص که در دستگاه گزارش شده است. از این برای تعیین فیلد event برای دسترسی استفاده کنید.

event میدانی اتحادیه انواع رویدادهای ثبت شده در دستگاه. هر نوع رویداد را برای جزئیات بیشتر در مورد زمان ارسال و محدودیت‌های مربوط به زمان ثبت رویداد و فیلدهایی که شامل می‌شوند، ببینید. event فقط می تواند یکی از موارد زیر باشد:
adbShellCommandEvent

object ( AdbShellCommandEvent )

یک فرمان پوسته بر روی ADB از طریق "adb shell command" صادر شد. بخشی از SECURITY_LOGS .

adbShellInteractiveEvent

object ( AdbShellInteractiveEvent )

یک پوسته تعاملی ADB از طریق "adb shell" باز شد. بخشی از 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 )

یک کلید رمزنگاری شامل نصب شده توسط کاربر، نصب شده توسط سرپرست و کلید خصوصی نگهداری شده توسط سیستم به دلیل خرابی فضای ذخیره سازی، خرابی سخت افزار یا برخی از مشکلات سیستم عامل مشخص می شود. بخشی از 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

اینکه آیا یک فرم قوی از احراز هویت (گذرواژه، پین یا الگو) برای باز کردن قفل دستگاه استفاده شده است.

KeyguardSecuredEvent

این نوع هیچ فیلدی ندارد.

دستگاه یا توسط کاربر قفل شده است و یا زمان آن به پایان رسیده است. عمدا خالی

FilePulledEvent

یک فایل از دستگاه دانلود شد.

نمایندگی JSON
{
  "filePath": string
}
فیلدها
filePath

string

مسیر فایل در حال کشیده شدن

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

یک کلید رمزنگاری شامل نصب شده توسط کاربر، نصب شده توسط سرپرست و کلید خصوصی نگهداری شده توسط سیستم به دلیل خرابی فضای ذخیره سازی، خرابی سخت افزار یا برخی از مشکلات سیستم عامل مشخص می شود. این در سراسر دستگاه در دستگاه‌های کاملاً مدیریت شده و در نمایه کاری در دستگاه‌های متعلق به سازمان با نمایه کاری در دسترس است.

نمایندگی 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

شناسه کاربری برنامه سرپرست که از آنجا تغییر درخواست شده است.

targetUserId

integer

شناسه کاربری که در آن تغییر درخواست شده است.

WipeFailureEvent

این نوع هیچ فیلدی ندارد.

نمایه کاری یا دستگاه متعلق به شرکت در صورت درخواست پاک نشد. این می تواند توسط کاربر یا توسط مدیر راه اندازی شود، به عنوان مثال delete دریافت شده است. عمدا خالی

ConnectEvent

یک رویداد اتصال TCP از طریق پشته شبکه استاندارد آغاز شد.

نمایندگی JSON
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
فیلدها
destinationIpAddress

string

آدرس IP مقصد تماس اتصال.

destinationPort

integer

پورت مقصد تماس اتصال.

packageName

string

نام بسته UID که تماس اتصال را انجام داد.

DnsEvent

یک رویداد جستجوی DNS از طریق پشته شبکه استاندارد آغاز شد.

نمایندگی JSON
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
فیلدها
hostname

string

نام میزبانی که جستجو شد.

ipAddresses[]

string

فهرست (احتمالاً کوتاه) آدرس‌های IP که برای جستجوی DNS بازگردانده شده‌اند (حداکثر 10 آدرس IPv4 یا IPv6).

totalIpAddressesReturned

string ( int64 format)

تعداد آدرس‌های IP بازگردانده شده از رویداد جستجوی DNS. اگر آدرس‌های زیادی برای ورود وجود داشته باشد، ممکن است بیشتر از مقدار آدرس‌های IP باشد.

packageName

string

نام بسته UID که جستجوی DNS را انجام داد.

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

این نوع هیچ فیلدی ندارد.

نشان می دهد که دستگاه ثبت نام را کامل کرده است. کاربر باید در این مرحله در راه‌انداز باشد، دستگاه در این مرحله سازگار خواهد بود و تمام مراحل راه‌اندازی کامل شده است. عمدا خالی