Method: customers.reports.findSaasUsage

Belirtilen arama ve sıralama ölçütlerine göre bir müşterinin SaaS kullanım raporlarını bulabilirsiniz.

HTTP isteği

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

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
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 FindSaasUsageReports çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken FindSaasUsageReports öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
filter

string

İsteğe bağlı. Döndürülecek SaaS 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:

  • uygulama
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • category
  • kuruluş
  • foundedYear
  • genel merkezler
  • primaryDomain
  • alan adları
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

string

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

Desteklenen alanlar:

  • uygulama
  • category
  • kuruluş
  • foundedYear
  • genel merkezler
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

Örnek: visitsCount desc

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

reports.findSaasUsage yöntemine yanıt.

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

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

object (SaasUsageReport)

SaaS kullanım 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ğe uygun toplam SaaS kullanım raporu sayısı.

Yetkilendirme kapsamları

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

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

SaasUsageReport

Tek bir SaaS raporu girişini temsil eder.

JSON gösterimi 
{
  "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
}
Alanlar
app

string

Yalnızca çıkış. Uygulamanın adı.
orgUnitId

string

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

string

Yalnızca çıkış. Uygulamanın kategorisi.
organization

string

Yalnızca çıkış. Uygulamayı geliştiren kuruluş.
foundedYear

integer

Yalnızca çıkış. Kuruluşun kurulduğu yıl.
headquarters

string

Yalnızca çıkış. Kuruluşun genel merkezinin bulunduğu konum.
primaryDomain

string

Yalnızca çıkış. Uygulamanın birincil alanı.
domains[]

string

Yalnızca çıkış. Uygulamayla ilişkili alan adlarının ve alt alan adlarının listesi.
encryptionProtocols[]

string

Yalnızca çıkış. Uygulamaya erişmek için kullanılan şifreleme protokollerinin listesi.
visitsCount

string (int64 format)

Yalnızca çıkış. Uygulamaya yapılan toplam ziyaret sayısı.
distinctUsersCount

string (int64 format)

Yalnızca çıkış. Uygulamayı ziyaret eden farklı kullanıcıların sayısı.
distinctBrowsersCount

string (int64 format)

Yalnızca çıkış. Uygulamayı ziyaret eden farklı tarayıcıların sayısı.
contentTransferDetails

object (ContentTransferDetails)

Yalnızca çıkış. Varsa içerik aktarımı etkinlikleri hakkında bilgi sağlar.
firstNavigationTime

string (Timestamp format)

Yalnızca çıkış. Uygulamaya 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 en son gezinilen 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".

ContentTransferDetails

Varsa içerik aktarımı etkinlikleri hakkında bilgi sağlar.

JSON gösterimi 
{
  "contentTransferCount": string
}
Alanlar
contentTransferCount

string (int64 format)

Yalnızca çıkış. Uygulamayla ilişkili toplam içerik aktarımı sayısı.