Method: customers.reports.findSaasUsageProfiles

Belirli arama ve sıralama ölçütlerine göre profillere göre gruplandırılmış bir müşterinin SaaS kullanım raporlarını bulabilirsiniz.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customer

string

Zorunlu. "customers/C" veya "customers/my_customer" ile başlayan, karartılmış müşteri kimliği.

Sorgu parametreleri

Parametreler
app

string

Zorunlu. SaaS uygulamasının adı (ör. ChatGPT, Gemini).
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum rapor sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 100 rapor döndürülür. Maksimum değer 200'dür. 200'den yüksek değerler 200'e zorlanır.
pageToken

string

İsteğe bağlı. Önceki bir reports.findSaasUsageProfiles çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.
filter

string

İsteğe bağlı. Döndürülecek SaaS profili raporlarını daraltmak için kullanılan filtre ifadesi. Desteklenen operatörler şunlardır: =, !=, <, <=, >, >=, :. AND, OR ve NOT mantıksal operatörleri desteklenir.

Desteklenen alanlar:

  • e-posta
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

İsteğe bağlı. SaaS profili raporlarını sıralamak için kullanılan order by ifadesi.

Desteklenen alanlar:

  • e-posta
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

Varsayılan sıra artandır. Bir alan için azalan sırayı belirtmek üzere " desc" ifadesini ekleyin.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

reports.findSaasUsageProfiles yöntemine yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "profileReports": [
    {
      object (SaasUsageProfileReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Alanlar
profileReports[]

object (SaasUsageProfileReport)

SaaS kullanım profili raporlarının listesi.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.
totalSize

string (int64 format)

İsteği karşılayan toplam SaaS kullanım profili raporu sayısı.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

SaasUsageProfileReport

Profile göre gruplandırılmış tek bir SaaS raporu girişini temsil eder.

JSON gösterimi 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Alanlar
email

string

Yalnızca çıkış. Kullanıcının e-posta adresi.
profilePermanentId

string

Yalnızca çıkış. Profilin kalıcı kimliği.
firstNavigationTime

string (Timestamp format)

Yalnızca çıkış. Uygulamaya bu profille ilk kez gidildiğinde alınan zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Yalnızca çıkış. Uygulamada bu profille en son gezinildiği zamanın zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
orgUnitId

string

Yalnızca çıkış. Kuruluş biriminin kimliği.
osPlatform

enum (DeviceSystem)

Yalnızca çıkış. İşletim sistemi platformu.
osVersion

string

Yalnızca çıkış. İşletim sisteminin sürümü.