Method: activity.query

Consulte atividades anteriores no Google Drive.

Solicitação HTTP

POST https://driveactivity.googleapis.com/v2/activity:query

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

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
Campos
consolidationStrategy

object (ConsolidationStrategy)

Detalhes sobre como consolidar ações relacionadas que compõem a atividade. Se ela não for definida, as ações relacionadas não serão consolidadas.
pageSize

integer

o número mínimo de atividades desejadas na resposta; o servidor tenta retornar pelo menos essa quantidade. O servidor também pode retornar menos atividades se tiver uma resposta parcial pronta antes de a solicitação expirar. Se não for definido, um valor padrão será usado.
pageToken

string

O token identifica qual página de resultados deve ser retornado. Defina-o como o valor nextPageToken retornado de uma consulta anterior para ver a seguinte página de resultados. Se ela não for definida, a primeira página de resultados será retornada.
filter

string

A filtragem de itens retornados dessa solicitação de consulta. O formato da string de filtro é uma sequência de expressões, unidas por um "AND" opcional, em que cada expressão tem o formato "valor do operador de campo".

Campos compatíveis:

  • time: usa operadores numéricos em valores de data em termos de milissegundos desde 1o de janeiro de 1970 ou no formato RFC 3339 (em inglês). Exemplos:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: usa "tem" operador (:) e um valor singular ou uma lista de tipos de ação permitidos entre parênteses e separados por um espaço. Para excluir um resultado da resposta, inclua um hífen (-) no início da string de filtro. Exemplos:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Campo de união key. Os critérios principais da consulta. O padrão é ancestorName = items/root, se nenhuma chave for especificada. key pode ser apenas de um dos tipos a seguir:
itemName

string

Retorna atividades para este item do Google Drive. O formato é items/ITEM_ID.
ancestorName

string

Retorna atividades desta pasta do Drive, além de todos os filhos e descendentes. O formato é items/ITEM_ID.

Corpo da resposta

Mensagem de resposta para consultar a atividade do Drive.

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

Representação JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Campos
activities[]

object (DriveActivity)

Lista de atividades solicitadas.
nextPageToken

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados na lista.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

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

ConsolidationStrategy

Como as atividades individuais são consolidadas. Se um conjunto de atividades estiver relacionado, ele poderá ser consolidado em uma atividade combinada, como um ator executando a mesma ação em vários alvos ou vários atores realizando a mesma ação em um único alvo. A estratégia define as regras relacionadas às atividades.

Representação JSON 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
Campos
Campo de união strategy. Como as atividades individuais são consolidadas. strategy pode ser apenas de um dos tipos a seguir:
none

object (NoConsolidation)

As atividades individuais não são consolidadas.
legacy

object (Legacy)

As atividades individuais são consolidadas usando a estratégia legada.

NoConsolidation

Esse tipo não tem campos.

Uma estratégia que não consolida as atividades individuais.

Legado

Esse tipo não tem campos.

Uma estratégia que consolida atividades usando as regras de agrupamento da API V1 Activity legada. Ações semelhantes que ocorrem em uma janela de tempo podem ser agrupadas entre vários alvos (como mover um conjunto de arquivos de uma só vez) ou vários atores (como vários usuários editando o mesmo item). As regras de agrupamento dessa estratégia são específicas para cada tipo de ação.