Reports API: Laporan Penggunaan Entitas

Laporan penggunaan entitas menampilkan aktivitas layanan Google Workspace yang terkait dengan entitas yang digunakan oleh pengguna akun Anda. Laporan ini dapat disesuaikan dan difilter untuk penggunaan tertentu tidak akurat atau tidak sesuai. Data tersedia selama 30 hari terakhir.

Laporan penggunaan entitas hanya dapat digunakan untuk tujuan yang sah di sesuai dengan Perjanjian Pelanggan Anda. Laporan ini juga berlaku untuk Google Workspace dan Education.

Ambil semua aktivitas penggunaan entity

Saat ini, satu-satunya jenis entitas yang didukung oleh API ini adalah komunitas Google+. Untuk mengambil semua aktivitas yang berkaitan dengan entitas aplikasi di akun Anda, gunakan laporan GET, dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. Sebagai keterbacaan, contoh berikut diformat dengan baris yang menampilkan:

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/date
?parameters=applicationParameters
&filters=parameterFilters
&maxResults=maxResults

Nilai date adalah tanggal penggunaan terjadi dan stempel waktu berada dalam Format ISO 8601, yyyy-mm-dd. Sebaiknya gunakan zona waktu akun Anda untuk ini. Untuk informasi lebih lanjut tentang parameter {i>string <i}kueri dan properti respons, lihat referensi API Referensi. Untuk informasi tentang parameter laporan penggunaan entitas, lihat Parameter Penggunaan Entity .

applicationParameters adalah daftar parameter yang dipisahkan koma yang ingin Anda ambil. Misalnya, setiap parameter diformat sebagai application:parameter_name, gplus:community_name. Parameter yang tersedia didokumentasikan dalam Parameter Penggunaan Entity . Jika tidak ada parameter yang ditentukan, semua akan ditampilkan.

parameterFilters adalah daftar filter yang dipisahkan koma untuk diterapkan pada hasil. Masing-masing filter diformat sebagai application:parameter_name[relational_operator]parameter_value. Misalnya, filter gplus:num_total_members>100 memfilter hasil agar hanya berisi hasil dengan parameter gplus:num_total_members memiliki nilai lebih besar dari 100.

maxResults adalah jumlah maksimum hasil untuk ditampilkan dalam satu pengambilan. Jika total hasil lebih besar dari ini, respons akan terpotong dan nextPageToken akan disertakan (lihat Contoh respons JSON di bawah).

Contoh

Contoh berikut mendapatkan laporan yang berisi semua parameter untuk semua entitas gplus_communities.

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all
/dates/2017-12-11

Contoh berikut mendapatkan laporan yang berisi parameter community_name untuk semua entitas gplus_communities.

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all
/dates/2017-12-11?parameters=gplus:community_name

Contoh berikut mendapatkan laporan community_name dan num_total_members untuk setiap entitas gplus_communities, difilter menurut komunitas yang memiliki lebih dari 100 anggota. Untuk contoh respons API, lihat Contoh respons JSON.

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-11
?parameters=gplus:community_name,gplus:num_total_members&filters=gplus:num_total_members>100

GET https://admin.googleapis.com/admin/reports/v1/gplus_communities/entityKey/dates/date
?parameters=applicationParameters
&filters=parameterFilters
&maxResults=maxResults

https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/1234/dates/2017-12-11

{
 "kind": "reports#usageReports",
 "nextPageToken": "NjQ1OTgwODk0MzkxNDAwNjQ0OA",
 "usageReports": [
 {
   "kind": "admin#reports#usageReport",
   "date": "2017-12-11",
   "entity": {
    "type": "OBJECT",
    "customerId": "C03az79cb",
    "objectType": "GPLUS_COMMUNITY",
    "objectId": "1234",
   },
   "parameters": [
    {
      "name": "gplus:community_name",
      "stringValue": "My Community"
    },
    {
     "name": "gplus:num_total_members",
     "intValue": 37
    },
    {
     "name": "gplus:num_7day_active_members",
     "intValue": 12
    },
    {
     "name": "gplus:num_30day_active_members",
     "intValue": 17
    },
   ]
  }
 ]
}

{
 "kind": "reports#usageReports",
 "warnings": [
    {
      "code": "PARTIAL_DATA_AVAILABLE"
      "message": "Data for date 2017-12-11 for application gplus is not available right now, please try again after a few hours."
      "data": [
        {
          "key": "date"
          "value": "2017-12-11"
        }
      ]
    }
  ],
 "usageReports": [],
}