Reports API: Giriş Etkinliği Raporu

Giriş etkinliği raporu, hesabınızın tüm kullanıcılarının giriş etkinliklerine ilişkin bilgileri döndürür. Her rapor, bir kullanıcının e-postası gibi rapora özel parametrelerle temel rapor uç noktası isteğini kullanır. Her rapor için maksimum süre son 180 gündür.

Giriş etkinliği raporu, Müşteri Sözleşmenize uygun şekilde yalnızca yasal amaçlarla kullanılabilir.

Alan için Google Workspace giriş etkinliklerini alma

Alan adınızın tüm hizmetlerine ait tüm girişleri 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 API Referansı'na bakın. Okunabilirlik açısından aşağıdaki örnek satır sonları ile biçimlendirilmiştir:

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

Aşağıdaki örnekte son 180 gündeki tüm hesap giriş etkinlikleriyle ilgili rapor gösterilmektedir. maxResults sorgu parametresi bu raporun sayfa başına 25 sonuç döndürmesini sağlar.

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

Aşağıdaki örnekte, bir müşterinin son 180 gündeki tüm giriş etkinlikleri hakkında bir rapor alınmıştır. customerId, raporun hangi müşteri için alınacağını belirtir.

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

Google Workspace giriş etkinliklerini etkinlik adına göre alma

Bazı durumlarda, şüpheli başarılı girişler 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/login?maxResults=maximum number of events returned on a response page
&eventName=name of the login event
&filters=event parameter relational operator parameter value

Aşağıdaki örnekte, bir alan için tüm şüpheli başarılı girişlerin nasıl alınacağı gösterilmektedir:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25