Method: customers.reports.findSaasUsageBrowsers

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

Solicitação HTTP

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

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
app

string

Obrigatório. O nome do aplicativo SaaS (por exemplo, ChatGPT, Gemini).
pageSize

integer

Opcional. O número máximo de navegadores a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 100 navegadores 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 reports.findSaasUsageBrowsers anterior. Forneça isso para recuperar a página subsequente.
filter

string

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

Campos aceitos:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

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

Campos aceitos:

  • machine
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta ao método reports.findSaasUsageBrowsers.

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

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

object (SaasUsageBrowser)

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

string

Um token, que pode ser enviado como pageToken para recuperar a próxima página.
totalSize

string (int64 format)

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

SaasUsageBrowser

Detalhes de um navegador de uso de SaaS.

Representação JSON 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
Campos
machine

string

Apenas saída. O nome da máquina.
devicePermanentId

string

Apenas saída. O ID permanente do dispositivo.
firstNavigationTime

string (Timestamp format)

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

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 por esse navegador.

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

string

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

enum (DeviceSystem)

Apenas saída. A plataforma do SO.
osVersion

string

Apenas saída. A versão do SO.