Method: customers.reports.findSaasUsage

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

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customer

string

Wajib. ID pelanggan yang diacak dengan awalan "customers/C" atau "customers/my_customer".

Parameter kueri

Parameter
pageSize

integer

Opsional. Jumlah maksimum laporan yang akan ditampilkan. Layanan dapat menampilkan kurang dari nilai ini. Jika tidak ditentukan, maksimal 100 laporan akan ditampilkan. Nilai maksimumnya adalah 200; nilai di atas 200 akan dipaksa menjadi 200.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan FindSaasUsageReports sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk FindSaasUsageReports harus sesuai dengan panggilan yang memberikan token halaman.
filter

string

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

Kolom yang didukung:

  • app
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • organization
  • foundedYear
  • headquarters
  • primaryDomain
  • domains
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

Contoh: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

Opsional. Ekspresi pengurutan untuk mengurutkan laporan SaaS.

Kolom yang didukung:

  • app
  • category
  • organization
  • foundedYear
  • headquarters
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Contoh: visitsCount desc

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons terhadap metode reports.findSaasUsage.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

object (SaasUsageReport)

Daftar laporan penggunaan SaaS.
nextPageToken

string

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

string (int64 format)

Jumlah total laporan penggunaan SaaS yang sesuai dengan permintaan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

SaasUsageReport

Mewakili satu entri laporan SaaS.

Representasi JSON 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
Kolom
app

string

Hanya output. Nama aplikasi.
orgUnitId

string

Hanya output. ID unit organisasi.
category

string

Hanya output. Kategori aplikasi.
organization

string

Hanya output. Organisasi yang mengembangkan aplikasi.
foundedYear

integer

Hanya output. Tahun organisasi didirikan.
headquarters

string

Hanya output. Lokasi kantor pusat organisasi.
primaryDomain

string

Hanya output. Domain utama aplikasi.
domains[]

string

Hanya output. Daftar domain dan subdomain yang terkait dengan aplikasi.
encryptionProtocols[]

string

Hanya output. Daftar protokol enkripsi yang digunakan untuk mengakses aplikasi.
visitsCount

string (int64 format)

Hanya output. Total jumlah kunjungan ke aplikasi.
distinctUsersCount

string (int64 format)

Hanya output. Jumlah pengguna unik yang mengunjungi aplikasi.
distinctBrowsersCount

string (int64 format)

Hanya output. Jumlah browser unik yang mengunjungi aplikasi.
contentTransferDetails

object (ContentTransferDetails)

Hanya output. Memberikan informasi tentang peristiwa transfer konten, jika tersedia.
firstNavigationTime

string (Timestamp format)

Hanya output. Stempel waktu saat aplikasi pertama kali dibuka.

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.

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".

ContentTransferDetails

Memberikan informasi tentang peristiwa transfer konten, jika tersedia.

Representasi JSON 
{
  "contentTransferCount": string
}
Kolom
contentTransferCount

string (int64 format)

Hanya output. Total jumlah transfer konten yang terkait dengan aplikasi.