Method: activity.query

Consultar 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 não for definido, 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 do tempo limite da solicitação. Se não for definido, um valor padrão será usado.
pageToken

string

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

string

A filtragem dos 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 a forma "campo operador valor".

Campos aceitos:

  • time: usa operadores numéricos em valores de data em termos de milissegundos desde 1º de janeiro de 1970 ou no formato RFC 3339. 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 único ou uma lista de tipos de ação permitidos entre parênteses, separados por um espaço. Para excluir um resultado da resposta, adicione 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. O critério principal na 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 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 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 quais 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 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 atividades individuais.

Legado

Esse tipo não tem campos.

Uma estratégia que consolida atividades usando as regras de agrupamento da API Activity V1 legada. Ações semelhantes que ocorrem em um período podem ser agrupadas em vários destinos (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 para essa estratégia são específicas para cada tipo de ação.