Method: customers.reports.findSaasUsageProfiles

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

Solicitação HTTP

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

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 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 reports.findSaasUsageProfiles anterior. Forneça isso para recuperar a página subsequente.
filter

string

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

Campos compatíveis:

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

string

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

Campos compatíveis:

  • e-mail
  • 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.findSaasUsageProfiles.

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

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

object (SaasUsageProfileReport)

A lista de relatórios de perfil 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 perfil 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

SaasUsageProfileReport

Representa uma única entrada de relatório de SaaS agrupada por perfil.

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

string

Apenas saída. O e-mail do usuário.
profilePermanentId

string

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

string (Timestamp format)

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

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

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.