Method: activities.watch

Começar a receber notificações para atividades da conta. Para mais informações, consulte Como receber notificações push.

Solicitação HTTP

POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch

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

Parâmetros de caminho

Parâmetros
userKey or all

string

Representa o ID do perfil ou o e-mail do usuário para o qual os dados devem ser filtrados. Pode ser all para todas as informações ou userKey para o ID exclusivo do perfil do Google Workspace ou o endereço de e-mail principal de um usuário. Não pode ser um usuário excluído. Para um usuário excluído, chame users.list na API Directory com showDeleted=true e use o ID retornado como userKey.

applicationName

enum (ApplicationName)

Nome do aplicativo em que os eventos serão recuperados.

Parâmetros de consulta

Parâmetros
actorIpAddress

string

O endereço IP do host em que o evento foi realizado. Essa é uma forma adicional de filtrar o resumo de um relatório usando o endereço IP do usuário cuja atividade está sendo informada. Esse endereço IP pode ou não refletir a localização física do usuário. Por exemplo, o endereço IP pode ser o endereço do servidor proxy do usuário ou um endereço da rede privada virtual (VPN). Esse parâmetro oferece suporte às versões de endereço IPv4 e IPv6.

customerId

string

O ID exclusivo do cliente para o qual os dados serão recuperados.

endTime

string

Define o fim do período mostrado no relatório. A data está no formato RFC 3339, por exemplo, 2010-10-28T10:26:35.000Z. O valor padrão é o horário aproximado da solicitação de API. Um relatório de API tem três conceitos básicos de tempo:

  • Data da solicitação da API para um relatório: quando a API criou e recuperou o relatório.
  • Horário de início do relatório: o início do período mostrado no relatório. O startTime precisa ser anterior à endTime (se especificado) e o horário atual em que a solicitação é feita. Caso contrário, a API vai retornar um erro.
  • Horário de término do relatório: o término do período mostrado no relatório. Por exemplo, o período dos eventos resumidos em um relatório pode começar em abril e terminar em maio. O relatório em si poderá ser solicitado em agosto.
Se o endTime não for especificado, o relatório retornará todas as atividades de startTime até o horário atual ou os 180 dias mais recentes, se startTime tiver mais de 180 dias.

eventName

string

O nome do evento que está sendo consultado pela API. Cada eventName está relacionado a um serviço ou recurso específico do Google Workspace que a API organiza em tipos de eventos. Um exemplo são os eventos do Google Agenda nos relatórios do aplicativo Admin Console. A estrutura type das configurações da Agenda inclui todas as atividades eventName do Agenda informadas pela API. Quando um administrador muda uma configuração do Google Agenda, a API informa essa atividade nos parâmetros type e eventName das configurações do Google Agenda. Para mais informações sobre parâmetros e strings de consulta eventName, consulte a lista de nomes de eventos dos vários aplicativos acima em applicationName.

filters

string

A string de consulta filters é uma lista separada por vírgulas composta de parâmetros de evento manipulados por operadores relacionais. Os parâmetros do evento estão no formato {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Esses parâmetros de evento estão associados a um eventName específico. Um relatório vazio será retornado se o parâmetro da solicitação não pertencer a eventName. Para mais informações sobre os campos eventName disponíveis para cada aplicativo e os parâmetros associados, acesse a tabela ApplicationName e clique na página Eventos de atividade no apêndice do aplicativo desejado.

Nos exemplos de atividades do Drive a seguir, a lista retornada consiste em todos os eventos edit em que o valor de parâmetro doc_id corresponde às condições definidas pelo operador relacional. No primeiro exemplo, a solicitação retorna todos os documentos editados com um valor doc_id igual a 12345. No segundo exemplo, o relatório retorna todos os documentos editados em que o valor doc_id não é igual a 98765. O operador <> é codificado por URL na string de consulta da solicitação (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Uma consulta filters é compatível com estes operadores relacionais:

  • ==: "igual a".
  • <> — "diferente de". Precisa ser codificado para uso em URL (%3C%3E).
  • <—'menor que'. Precisa ser codificado para uso em URL (%3C).
  • <= — "menor ou igual a". Precisa ser codificado para uso em URL (%3C=).
  • > — "maior que". Precisa ser codificado para uso em URL (%3E).
  • >=: "maior ou igual a". Precisa ser codificado para uso em URL (%3E=).

Observação:a API não aceita vários valores do mesmo parâmetro. Se um parâmetro é fornecido mais de uma vez na solicitação da API, a API aceita apenas o último valor desse parâmetro. Além disso, se um parâmetro inválido é fornecido na solicitação da API, a API ignora esse parâmetro e retorna a resposta correspondente aos parâmetros válidos restantes. Se nenhum parâmetro for solicitado, todos os parâmetros serão retornados.

maxResults

integer

Determina quantos registros de atividade são mostrados em cada página de resposta. Por exemplo, se a solicitação definir maxResults=1 e o relatório tiver duas atividades, ele terá duas páginas. A propriedade nextPageToken da resposta tem o token para a segunda página. A string de consulta maxResults é opcional na solicitação. O valor padrão é 1000.

orgUnitID
(deprecated)

string

Deprecated: Este campo foi descontinuado e não recebe mais suporte.

ID da unidade organizacional que vai gerar o relatório. Os registros de atividades serão exibidos apenas para os usuários que pertencem à unidade organizacional especificada.

pageToken

string

O token a ser especificado na próxima página. Um relatório com várias páginas tem uma propriedade nextPageToken na resposta. Na solicitação de acompanhamento para acessar a próxima página do relatório, insira o valor nextPageToken na string de consulta pageToken.

startTime

string

Define o início do período mostrado no relatório. A data está no formato RFC 3339, por exemplo, 2010-10-28T10:26:35.000Z. O relatório retorna todas as atividades de startTime até endTime. O startTime precisa ser anterior à endTime (se especificado) e o horário atual em que a solicitação é feita. Caso contrário, a API vai retornar um erro.

groupIdFilter

string

IDs de grupos separados por vírgula (ofuscados) em que as atividades do usuário são filtradas, ou seja, a resposta conterá atividades somente para os usuários que fazem parte de pelo menos um dos IDs de grupo mencionados aqui. Formato: "id:abc123,id:xyz456"

Corpo da solicitação

O corpo da solicitação contém uma instância de SubscriptionChannel.

Corpo da resposta

Um canal de notificação usado para observar alterações de recursos.

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

Representação JSON
{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}
Campos
id

string

Um UUID ou uma string única semelhante que identifica esse canal.

token

string

Uma string arbitrária entregue ao endereço de destino com cada notificação entregue por esse canal. Opcional.

expiration

string (int64 format)

Data e hora da expiração do canal de notificação, expressas como um carimbo de data/hora Unix, em milissegundos. Opcional.

type

string

O tipo de mecanismo de entrega usado para esse canal. O valor precisa ser definido como "web_hook".

address

string

O endereço onde as notificações do canal são entregues.

payload

boolean

Um valor booleano que indica se a carga útil é desejada. Um payload é um dado enviado no corpo de uma mensagem HTTP POST, PUT ou PATCH que contém informações importantes sobre a solicitação. Opcional.

params

map (key: string, value: string)

Parâmetros adicionais que controlam o comportamento do canal de entrega. Opcional.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

resourceId

string

Um ID opaco que identifica o recurso que está sendo monitorado no canal. Estável em diferentes versões da API.

resourceUri

string

Identificador específico da versão do recurso monitorado.

kind

string

Identifica isso como um canal de notificação usado para observar alterações em um recurso, que é "api#channel".

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Para mais informações, consulte o Guia de autorização.

ApplicationName

Nome do aplicativo em que os eventos serão recuperados.

Enums
access_transparency

Os relatórios de atividade da Transparência no acesso do Google Workspace retornam informações sobre diferentes tipos de eventos de atividade da Transparência no acesso.

admin

Os relatórios de atividade do aplicativo Admin Console retornam informações da conta sobre diferentes tipos de eventos de atividade do administrador.

calendar

Os relatórios de atividade do aplicativo Google Agenda retornam informações sobre vários eventos de atividade do Google Agenda.

chat Os relatórios de atividade do Chat retornam informações sobre vários eventos de atividade do Chat.
drive

Os relatórios de atividade do aplicativo Google Drive retornam informações sobre vários eventos de atividade do Google Drive. O Relatório de atividades do Drive só está disponível para clientes do Google Workspace Business e do Google Workspace Enterprise.

gcp Os relatórios de atividade do aplicativo Google Cloud Platform retornam informações sobre vários eventos de atividade do GCP.
gplus Os relatórios de atividade do aplicativo Google+ retornam informações sobre diversos eventos de atividade do Google+.
groups

Os relatórios de atividade do app Grupos do Google retornam informações sobre vários eventos de atividade dos Grupos do Google.

groups_enterprise

Os relatórios de atividade dos grupos corporativos retornam informações sobre vários eventos de atividade dos grupos do Enterprise.

jamboard Os relatórios de atividades do Jamboard retornam informações sobre vários eventos de atividade do Jamboard.
login

Os relatórios de atividade do app de login retornam informações da conta sobre diferentes tipos de eventos de atividade de login.

meet O relatório de atividades de auditoria do Meet retorna informações sobre diferentes tipos de eventos de atividade de auditoria do Meet.
mobile O relatório "Atividade de auditoria do dispositivo" retorna informações sobre diferentes tipos de eventos da atividade de auditoria do dispositivo.
rules

O relatório "Atividades das regras" retorna informações sobre diferentes tipos de eventos de atividade das regras.

saml

O relatório de atividades de SAML retorna informações sobre diferentes tipos de eventos de atividade SAML.

token

Os relatórios de atividade do aplicativo de token retornam informações da conta sobre diferentes tipos de eventos de atividade do token.

user_accounts

Os relatórios de atividade do app Contas de usuário retornam informações da conta sobre diferentes tipos de eventos de atividade das Contas de usuário.

context_aware_access

Os relatórios de atividade do acesso baseado no contexto retornam informações sobre as acesso negado devido às regras de acesso baseado no contexto.

chrome

Os relatórios de atividade do Chrome retornam informações sobre eventos do navegador Chrome e do Chrome OS.

data_studio Os relatórios de atividade do Data Studio retornam informações sobre vários tipos de eventos de atividade do Data Studio.
keep Os relatórios de atividade do aplicativo Keep retornam informações sobre vários eventos de atividade do Google Keep. O relatório de atividades do Keep só está disponível para os clientes do Google Workspace Business e Enterprise.