Esta página foi traduzida pela API Cloud Translation.

Method: activities.watch

Solicitação HTTP
Parâmetros de caminho
Parâmetros de consulta
Corpo da solicitação
Corpo da resposta
- Representação JSON
Escopos de autorização
ApplicationName

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

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.

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. Os dados anteriores a 17 de dezembro de 2018 não aparecem nos resultados filtrados.
`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 }

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.