Reports API: Kullanıcı Kullanım Raporu

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 rapor için varsayılan ve maksimum dönem son 450 gündür.

Bu kullanıcı kullanım raporları, Müşteri Sözleşmenize uygun olarak yalnızca yasal amaçlarla kullanılabilir. Ayrıca, bu raporlar Google Workspace ve Education için geçerlidir.

Tüm kullanıcı kullanım etkinliklerini al

Hesabınızdaki tüm kullanıcı etkinliklerinin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme dokümanlarında açıklanan yetkilendirme jetonunu ekleyin. Aşağıdaki örnek, okunabilirlik açısından satır sonları olacak şekilde 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 için API Referansı'na bakın. Kullanıcı kullanım raporu parametreleri hakkında bilgi için Kullanıcı Kullanım Parametreleri referansı bölümüne bakın.

Aşağıdaki örnekte, hesaba ilişkin tüm kullanıcı etkinlikleri hakkında bir rapor alını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ı etkinlikleriyle ilgili bir rapor verilmektedir.

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ınmaktadır. API yanıtı örneği için JSON yanıtı örneğine bakın. 

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, belirli bir sürenin ardından giriş yapan kullanıcılara göre filtrelenmiş, hesaptaki kullanıcıların son giriş zaman damgaları hakkında bir rapor alınmıştır. API yanıtı örneği için JSON yanıtı örneğine bakın. 

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 durumları hakkında bir rapor alınmaktadır. API yanıtı örneği için JSON yanıtı örneğine bakın. 

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 al

Hesabınızdaki belirli bir kullanıcının etkinlikleriyle ilgili rapor almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme dokümanlarında açıklanan yetkilendirme jetonunu ekleyin. Aşağıdaki örnek, okunabilirlik açısından satır sonları olacak şekilde 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ıya ait benzersiz Google Workspace profileId 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 için API Referansı'na bakın. Kullanıcı kullanım raporu parametreleri hakkında bilgi için Kullanıcı Kullanım Parametreleri referansı bölümüne bakın.

Aşağıdaki örnekte, can@example.com adresine ilişkin kullanım raporu verilmiştir.

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, 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"
    }
   ]
  }
 ]
}