Reports API: Müşteri Kullanım Raporu

Müşterilerin kullanım raporu Bir alandaki tüm kullanıcılara ait Google Workspace hizmet kullanım bilgilerini toplar. Kullanıcı kullanım raporu, hesabınızdaki Google Workspace hizmet kullanım bilgilerini döndürür. Bu kullanım bilgileri, söz konusu uygulamaya özel parametrelerden oluşan uygulama türüne göre düzenlenir. Her rapor için varsayılan ve maksimum dönem son 450 gündür.

Bu kullanım raporları, Müşteri Sözleşmenize uygun olarak yalnızca yasal amaçlarla kullanılabilir. Ayrıca bu Google Workspace ve Education için 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 jetonunu ekleyin. yetkilendirme dokümanlarında açıklandığından emin olun. Okunabilirlik açısından aşağıdaki örnek, satır sonları kullanılarak 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 bir liste sağlanır sayısı ve kullanıcı yetkilendirmesi sayısı, 03.03.2013 tarihinden itibaren 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
      },
     ...
     ]
    }
   ]
  }
 ]
}