Method: activity.query

Consultar la actividad pasada 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)

Son los detalles para consolidar las acciones relacionadas que componen la actividad. Si no se configura, no se consolidan las acciones relacionadas.
pageSize

integer

Es la cantidad mínima de actividades que se desean en la respuesta. El servidor intenta devolver al menos esta cantidad. El servidor también puede devolver 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 debe devolver. Establece este parámetro en el valor de nextPageToken que se devolvió de una búsqueda anterior para obtener la siguiente página de resultados. Si no se configura, se muestra la primera página de resultados.
filter

string

Es el filtro para los elementos que se muestran en esta solicitud de consulta. El formato de la cadena de filtro es una secuencia de expresiones, unidas por un "AND" opcional, en la que cada expresión tiene la forma "operador de campo valor".

Campos admitidos:

  • time: Usa operadores numéricos en valores de fecha, ya sea en términos de 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 "tiene" (:) y un valor singular o una lista de tipos de acción permitidos entre paréntesis, separados por un espacio. Para excluir un resultado de la respuesta, agrega un guion (-) al principio de la cadena de filtro. Ejemplos:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Campo de unión key. Es el criterio principal de la búsqueda. El valor predeterminado es ancestorName = items/root si no se especifica ninguna clave. key puede ser solo uno de los siguientes:
itemName

string

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

string

Devuelve 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

Es el mensaje de respuesta para consultar la actividad de Drive.

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

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

object (DriveActivity)

Es la 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 permisos 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.

ConsolidationStrategy

Indica cómo se consolidan las actividades individuales. Si un conjunto de actividades está relacionado, se puede 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 para 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. Indica 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 se consolidan.
legacy

object (Legacy)

Las actividades individuales se consolidan con la estrategia heredada.

NoConsolidation

Este tipo no tiene campos.

Es una estrategia que no consolida las actividades individuales.

Heredada

Este tipo no tiene campos.

Es una estrategia que consolida las actividades con las reglas de agrupación de la API de Activity v1 heredada. Las acciones similares que ocurren dentro de un período determinado se pueden agrupar en varios objetivos (por ejemplo, mover un conjunto de archivos a la vez) o varios actores (por ejemplo, varios usuarios que editan el mismo elemento). Las reglas de agrupación de esta estrategia son específicas para cada tipo de acción.