Reports API: Cihaz Denetleme Etkinlik Raporu

Cihaz denetleme etkinliği raporu, Google uç nokta yönetimi kapsamındaki tüm cihazların etkinlikleriyle ilgili bilgileri döndürür. Her raporda, kullanıcı e-postası gibi rapora özel parametrelerle birlikte temel rapor uç noktası isteği kullanılır. Her rapor için maksimum süre son 180 gündür.

Cihaz denetleme etkinliği raporu yalnızca Müşteri Sözleşmeniz uyarınca yasal amaçlarla kullanılabilir. Bu raporları hangi sürümlerin içerdiğini öğrenmek için Google Workspace sürümlerini karşılaştırma başlıklı makaleyi inceleyin.

Bir alan için cihaz denetleme etkinliklerini alma

Alanınızdaki tüm kullanıcıların tüm cihaz denetleme etkinliklerini almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu ekleyin. İstek sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için Cihaz Denetleme Etkinliği Etkinlikleri başlıklı makaleyi inceleyin. Okunabilirliği artırmak için aşağıdaki örnekte satır sonları kullanılmıştır:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

Aşağıdaki örnek, hesabınızın son 180 gündeki tüm cihaz denetleme etkinlikleriyle ilgili bir rapor alır. maxResults sorgu parametresi, sayfa başına 25 sonuç döndürür.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

Aşağıdaki örnek, son 180 güne ait tüm cihaz denetleme etkinlikleriyle ilgili bir rapor alır. customerId, hangi müşterinin raporunun alındığını belirtir.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

Cihaz denetleme etkinliklerini etkinlik adına göre alma

Bazı durumlarda, şüpheli etkinlik etkinlikleri gibi belirli etkinlikleri almak isteyebilirsiniz. Bunu yapmak için aşağıdaki biçimde bir GET HTTP isteği kullanın:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

Aşağıdaki örnekte, alan içindeki Android kullanıcılarıyla ilgili tüm şüpheli etkinliklerin nasıl alınacağı gösterilmektedir:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25