Method: activity.query

Consultar la actividad anterior en Google Drive

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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)

Detalles sobre cómo consolidar las acciones relacionadas que conforman la actividad Si no la estableces, no se consolidarán las acciones relacionadas.
pageSize

integer

La cantidad mínima de actividades deseadas en la respuesta. El servidor intenta mostrar esta cantidad como mínimo. El servidor también puede mostrar menos actividades si tiene una respuesta parcial lista antes de que se agote el tiempo de espera de la solicitud. Si no se establece, se usa un valor predeterminado.
pageToken

string

El token identifica qué página de resultados se muestran. Establece este valor en el valor nextPageToken que se muestra en una consulta anterior para obtener la siguiente página de resultados. Si no la estableces, se mostrará la primera página de resultados.
filter

string

El filtrado de elementos que se muestran en esta solicitud de consulta. El formato de la string de filtro es una secuencia de expresiones unidas por un “AND” opcional, en el que cada expresión tiene el formato “valor de operador de campo”.

Campos compatibles:

  • time: Usa operadores numéricos en valores de fecha, ya sea en milisegundos, desde el 1 de enero de 1970 o en formato RFC 3339. Ejemplos:

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

  • detail.action_detail_case: Usa el operador "has" (:) y un valor singular o una lista de los tipos de acciones permitidos entre paréntesis, separados por un espacio. Para excluir un resultado de la respuesta, agrega un guion (-) al principio de la string de filtro. Ejemplos:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Campo de unión key. Los criterios principales de la consulta. Si no se especifica una clave, el valor predeterminado es anceName = items/root. key puede ser solo uno de los siguientes:
itemName

string

Muestra las actividades de este elemento de Drive. El formato es items/ITEM_ID.
ancestorName

string

Muestra las actividades de esta carpeta de Drive, además de todos los elementos secundarios y descendientes. El formato es items/ITEM_ID.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Mensaje de respuesta para consultar la actividad de Drive.

Representación JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Campos
activities[]

object (DriveActivity)

Lista de actividades solicitadas.
nextPageToken

string

Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta la Guía de autorización.

Estrategia de consolidación

Cómo se consolidan las actividades individuales Si un conjunto de actividades está relacionado, se pueden consolidar en una actividad combinada, como un actor que realiza la misma acción en varios objetivos o varios actores que realizan la misma acción en un solo objetivo. La estrategia define las reglas con las que se relacionan las actividades.

Representación 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ón strategy. Cómo se consolidan las actividades individuales Las direcciones (strategy) solo pueden ser una de las siguientes opciones:
none

object (NoConsolidation)

Las actividades individuales no están consolidadas.
legacy

object (Legacy)

Las actividades individuales se consolidan con la estrategia heredada.

Sin consolidación

Una estrategia que no consolida las actividades individuales.

Heredada

Una estrategia que consolida actividades mediante las reglas de agrupación de la API heredada de actividad V1. Las acciones similares que se realizan dentro de un período pueden agruparse en varios destinos (como mover un conjunto de archivos a la vez) o varios actores (como varios usuarios que editan el mismo elemento). Las reglas de agrupación para esta estrategia son específicas de cada tipo de acción.