Reports API: Giriş Etkinliği Raporu

Giriş etkinliği raporu, hesabınızın tüm kullanıcılarının giriş etkinlikleriyle ilgili bilgileri döndürür. Her rapor, kullanıcının e-postası gibi rapora özgü parametrelerle temel rapor uç noktası isteğini kullanır. Her rapor için maksimum dönem son 180 gündür.

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

Bir alan için Google Workspace giriş etkinliklerini alma

Alanı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 dokümanlarında 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 örnek satır sonlarıyla 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, hesabınızın son 180 gün içindeki tüm giriş etkinlikleriyle ilgili bir rapor elde edilir. maxResults sorgu parametresi, bu raporun her sayfada 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ün içindeki tüm giriş etkinlikleriyle ilgili bir rapor elde edilmektedir. 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çime sahip 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