Müşteri kullanım raporu, bir alandaki tüm kullanıcılar için Google Workspace hizmet kullanımı bilgilerini toplar. Kullanıcı kullanım raporu, hesabınız genelinde Google Workspace hizmet kullanımı bilgilerini döndürür. Bu kullanım bilgileri, ilgili uygulamaya özel parametrelerden oluşan uygulama türüne göre düzenlenir. Her raporun varsayılan ve maksimum dönemi son 450 gündür.
Bu kullanım raporu, Müşteri Sözleşmenize uygun olarak yalnızca yasal amaçlarla kullanılabilir. Bu raporlar Google Workspace ve Education için de geçerlidir.
Müşteri kullanım raporu alma
Hesap etkinliklerinizin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu ekleyin. Okunabilirlik açısından aşağıdaki örnek satır sonları ile biçimlendirilmiştir:
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date ?parameters=app name: usage parameter,... &customerId=the customer's ID &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. Bunun için hesabınızın saat dilimini kullanmanızı öneririz. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na ve müşteri kullanım raporu parametreleri referansına bakın.
Aşağıdaki örnekte, son 30 gün içinde hesabınıza yapılan tüm başarılı girişlerin toplamını içeren bir rapor ve 03.03.2013 tarihinden itibaren yetkilendirilen uygulamaların listesi ve uygulama başına kullanıcı yetkilendirmelerinin sayısı yer almaktadır. maxResults sorgu dizesi, bu raporun her rapor sayfası için iki etkinlik döndürdüğünü gösterir:
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03 ?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2
Müşteri kullanım 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": "CUSTOMER",
"customerId": "C03az79cb"
},
"parameters": [
{
"name": "accounts:num_1day_logins",
"intValue": "1"
},
{
"name": "accounts:num_30day_logins",
"intValue": "1"
},
{
"name": "accounts:num_7day_logins",
"intValue": "1"
},
{
"name": "accounts:num_disabled_accounts",
"intValue": "5"
},
{
"name": "accounts:authorized_apps",
"msgValue": [
{
"client_id": "1234.apps.googleusercontent.com",
"client_name": "www.example.com",
"num_users": 2
},
{
"client_id": "4567.apps.googleusercontent.com",
"client_name": "Example",
"num_users": 1
},
...
]
}
]
}
]
}