Kullanıcı kullanım raporu, alanınızdaki belirli bir kullanıcının Google Workspace hizmet kullanımı bilgilerini döndürür. Bu raporlar, belirli kullanım bilgilerine göre özelleştirilebilir ve filtrelenebilir. Her raporun varsayılan ve maksimum dönemi son 450 gündür.
Bu kullanıcı kullanım raporu, Müşteri Sözleşmenize uygun şekilde yalnızca yasal amaçlarla kullanılabilir. Ayrıca, bu raporlar Google Workspace ve Education için de geçerlidir.
Tüm kullanıcı kullanım etkinliklerini al
Hesabınızdaki tüm kullanıcı etkinliklerinin bir raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu dahil edin. Okunabilirlik açısından aşağıdaki örnek, satır sonları ile biçimlendirilmiştir:
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
dates değeri kullanımın gerçekleştiği tarihtir ve zaman damgası ISO 8601 biçiminde, yyyy-aa-gg. Sorgu dizesi parametreleri ve yanıt özellikleri hakkında daha fazla bilgi edinmek için API Referansı'na bakın. Kullanıcı kullanım raporu parametreleri hakkında bilgi için Kullanıcı Kullanım Parametreleri referansına bakın.
Aşağıdaki örnekte, hesaptaki tüm kullanıcı etkinliklerinin bir raporu alınmıştır.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
Aşağıdaki örnekte, belirli bir müşteri hesabındaki tüm kullanıcı etkinliklerinin bir raporu alınmıştır.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?customerId=C03az79cb
Aşağıdaki örnekte, hesaptaki kullanıcıların son giriş zaman damgalarıyla ilgili bir rapor alınmıştır. API yanıtı örneği için JSON yanıtı örneğini inceleyin.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&maxResults=2
Aşağıdaki örnekte, hesaptaki kullanıcıların son giriş zaman damgalarıyla ilgili bir rapor bulunmaktadır. Bu rapor, belirli bir süreden sonra giriş yapan kullanıcılara göre filtrelenir. API yanıtı örneği için JSON yanıtı örneğini inceleyin.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&filters=accounts:last_login_time >2010-10-28T10:26:35.000Z"
Aşağıdaki örnekte, hesaptaki kullanıcıların son giriş zaman damgaları ve askıya alınma durumu ile ilgili bir rapor alınmıştır. API yanıtı örneği için JSON yanıtı örneğini inceleyin.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time,accounts:is_disabled"
Belirli bir kullanıcının kullanım etkinliklerini alma
Hesabınızdaki belirli bir kullanıcı etkinliklerinin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu dahil edin. Okunabilirlik açısından aşağıdaki örnek satır sonları ile biçimlendirilmiştir.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
userKey, rapordaki kullanıcının birincil e-posta adresi veya kullanıcının benzersiz Google Workspace profileId adresi olabilir. dates değeri kullanımın gerçekleştiği tarihtir ve zaman damgası ISO 8601 biçiminde, yyyy-aa-gg. Sorgu dizesi parametreleri ve yanıt özellikleri hakkında daha fazla bilgi edinmek için API Referansı'na bakın. Kullanıcı kullanım raporu parametreleri hakkında bilgi için Kullanıcı Kullanım Parametreleri referansına bakın.
Aşağıdaki örnekte, can@example.com hesabının kullanım raporu bulunmaktadır.
https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03
Kullanım raporu örneği JSON yanıtı
Başarılı bir yanıt, bir HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte bir rapor döndürür.
Kullanıcı raporu için JSON yanıtı
{
"kind": "reports#usageReports",
"warnings": [
{
"code": warning machine-readable code,
"message": warning human-readable message,
"data": [
{
"key": key for key-value pair that gives detailed warning information,
"value": value for key-value pair giving detailed warning information
}
]
}
],
"nextPageToken": "N:NNN:NNN:N:C03az79cb",
"usageReports": [
{
"kind": "usageReport",
"date": "2013-03-03",
"entity": {
"type": "USER",
"customerId": "C03az79cb",
"userEmail": "liz@example.com",
"profileId": "user's unique Google Workspace ID"
},
"parameters": [
{
"name": "accounts:is_disabled",
"boolValue": false
},
{
"name": "accounts:disabled_reason",
"stringValue": "reason description"
},
{
"name": "accounts:first_name",
"stringValue": "Liz"
},
{
"name": "accounts:is_2sv_enforced",
"boolValue": false
},
{
"name": "accounts:is_2sv_enrolled",
"boolValue": false
},
{
"name": "accounts:last_name",
"stringValue": "Smith"
},
{
"name": "accounts:creation_time",
"datetimeValue": "2010-10-28T10:26:35.000Z"
},
{
"name": "accounts:last_login_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
},
{
"name": "accounts:last_sso_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
}
]
}
]
}