Method: customers.reports.findSaasUsageProfiles

Temukan laporan penggunaan SaaS pelanggan yang dikelompokkan menurut profil berdasarkan kriteria penelusuran dan pengurutan yang diberikan.

Permintaan HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsageProfiles

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customer

string

Wajib. ID pelanggan yang di-obfuscate dengan awalan "customers/C" atau "customers/my_customer".

Parameter kueri

Parameter
app

string

Wajib. Nama aplikasi SaaS (misalnya, ChatGPT, Gemini).
pageSize

integer

Opsional. Jumlah maksimum laporan yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 100 laporan akan ditampilkan. Nilai maksimum adalah 200; nilai di atas 200 akan dikonversi menjadi 200.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan reports.findSaasUsageProfiles sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.
filter

string

Opsional. Ekspresi filter untuk mempersempit laporan profil SaaS yang akan ditampilkan. Operator yang didukung adalah: =, !=, <, <=, >, >=, :. Operator logika AND, OR, dan NOT didukung.

Kolom yang didukung:

  • email
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

Opsional. Urutan menurut ekspresi untuk mengurutkan laporan profil SaaS.

Kolom yang didukung:

  • email
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

Urutan defaultnya adalah menaik. Untuk menentukan urutan menurun untuk kolom, tambahkan "desc".

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons terhadap metode reports.findSaasUsageProfiles.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Kolom
profileReports[]

object (SaasUsageProfileReport)

Daftar laporan profil penggunaan SaaS.
nextPageToken

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.
totalSize

string (int64 format)

Jumlah total laporan profil penggunaan SaaS yang cocok dengan permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

SaasUsageProfileReport

Mewakili satu entri laporan SaaS yang dikelompokkan menurut profil.

Representasi JSON 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Kolom
email

string

Hanya output. Email pengguna.
profilePermanentId

string

Hanya output. ID permanen profil.
firstNavigationTime

string (Timestamp format)

Hanya output. Stempel waktu saat aplikasi pertama kali dibuka oleh profil ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Hanya output. Stempel waktu saat aplikasi terakhir kali dibuka oleh profil ini.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
orgUnitId

string

Hanya output. ID unit organisasi.
osPlatform

enum (DeviceSystem)

Hanya output. Platform OS.
osVersion

string

Hanya output. Versi OS.