Method: customers.reports.findSaasUsage

Encontre relatórios de uso de SaaS de um cliente com base nos critérios de pesquisa e classificação fornecidos.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customer

string

Obrigatório. ID do cliente ofuscado com o prefixo "customers/C" ou "customers/my_customer".

Parâmetros de consulta

Parâmetros
pageSize

integer

Opcional. O número máximo de relatórios a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 100 relatórios serão retornados. O valor máximo é 200. Valores acima de 200 serão forçados para 200.
pageToken

string

Opcional. Um token de página recebido de uma chamada FindSaasUsageReports anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para FindSaasUsageReports precisam corresponder à chamada que forneceu o token da página.
filter

string

Opcional. A expressão de filtro para restringir os relatórios de SaaS a serem retornados. Os operadores compatíveis são: =, !=, <, <=, >, >=, :. Os operadores lógicos AND, OR e NOT são aceitos.

Campos compatíveis:

  • app
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • categoria
  • organização
  • foundedYear
  • centro de operações
  • primaryDomain
  • domínios
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

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

string

Opcional. A expressão de ordem para classificar os relatórios de SaaS.

Campos compatíveis:

  • app
  • categoria
  • organização
  • foundedYear
  • centro de operações
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

A ordem padrão é crescente. Para especificar a ordem decrescente de um campo, anexe " desc".

Exemplo: visitsCount desc

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao método reports.findSaasUsage.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "saasReports": [
    {
      object (SaasUsageReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Campos
saasReports[]

object (SaasUsageReport)

A lista de relatórios de uso de SaaS.
nextPageToken

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.
totalSize

string (int64 format)

Número total de relatórios de uso de SaaS que correspondem à solicitação.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

SaasUsageReport

Representa uma única entrada de relatório de SaaS.

Representação 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
}
Campos
app

string

Apenas saída. O nome do aplicativo.
orgUnitId

string

Apenas saída. O ID da unidade organizacional.
category

string

Apenas saída. A categoria do aplicativo.
organization

string

Apenas saída. A organização que desenvolve o aplicativo.
foundedYear

integer

Apenas saída. O ano em que a organização foi fundada.
headquarters

string

Apenas saída. O local da sede da organização.
primaryDomain

string

Apenas saída. O domínio principal do aplicativo.
domains[]

string

Apenas saída. Uma lista de domínios e subdomínios associados ao aplicativo.
encryptionProtocols[]

string

Apenas saída. Uma lista de protocolos de criptografia usados para acessar o aplicativo.
visitsCount

string (int64 format)

Apenas saída. Número total de visitas ao aplicativo.
distinctUsersCount

string (int64 format)

Apenas saída. Número de usuários distintos que acessaram o aplicativo.
distinctBrowsersCount

string (int64 format)

Apenas saída. Número de navegadores distintos que acessaram o aplicativo.
contentTransferDetails

object (ContentTransferDetails)

Apenas saída. Fornece informações sobre eventos de transferência de conteúdo, se disponíveis.
firstNavigationTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o aplicativo foi acessado pela primeira vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o aplicativo foi acessado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

ContentTransferDetails

Fornece informações sobre eventos de transferência de conteúdo, se disponíveis.

Representação JSON 
{
  "contentTransferCount": string
}
Campos
contentTransferCount

string (int64 format)

Apenas saída. Número total de transferências de conteúdo associadas ao aplicativo.