Reports API: Giriş Etkinliği Raporu

Giriş etkinliği raporu, hesabınızdaki tüm kullanıcıların giriş 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.

Giriş etkinliği raporu, yalnızca Müşteri Sözleşmeniz uyarınca yasal amaçlarla kullanılabilir.

Bir alanla ilgili Google Workspace giriş etkinliklerini alma

Alanınızdaki tüm hizmetlerin tüm girişlerini 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. 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/login?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 giriş etkinlikleriyle ilgili bir rapor alır. 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 örnek, son 180 gün içinde bir müşterinin tüm giriş etkinlikleriyle ilgili bir rapor alı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