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 as ações relacionadas que compõem a atividade Se a política 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 poderá retornar menos atividades se tiver uma resposta parcial pronta antes que a solicitação expire. Se não for definido, um valor padrão será usado.
pageToken

string

O token identifica qual página de resultados deve ser retornada. Defina-o como o valor nextPageToken retornado de uma consulta anterior para acessar a próxima página de resultados. Se não for definido, a primeira página de resultados será retornada.
filter

string

A filtragem para 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 (link em inglês). Exemplos:

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

  • detail.action_detail_case: usa o operador "has" (:) 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, adicione um hífen (-) ao 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. O critério primário na consulta. O padrão será anceName = items/root, se nenhuma chave for especificada. key pode ser apenas de um dos tipos a seguir:
itemName

string

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

string

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

Corpo da resposta

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

Mensagem de resposta para consultar a atividade do Drive.

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 de 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, elas poderão ser consolidadas em uma atividade combinada, como um ator realizando a mesma ação em vários destinos ou vários atores realizando a mesma ação em um único destino. A estratégia define as regras para as quais as atividades estão relacionadas.

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 estão consolidadas.
legacy

object (Legacy)

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

NoConsolidation

Uma estratégia que não faz a consolidação das atividades individuais.

Legada

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