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 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 la página de resultados que se debe mostrar. Establece este valor en el valor de nextPageToken que se muestra de 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 filtro de 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 el que cada expresión tiene el formato "valor del operador de campo".

Campos admitidos:

  • time: Utiliza operadores numéricos en valores de fecha 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 "has" (:) y un valor singular o una lista de tipos de acciones permitidas encerrados 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. Los criterios principales de la consulta. El valor predeterminado es ancestorName = items/root, si no se especifica una clave. 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 los elementos subordinados. El formato es items/ITEM_ID.

Cuerpo de la respuesta

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.

Alcances 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

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.

NoConsolidation

Este tipo no tiene campos.

Es una estrategia que no consolida las actividades individuales.

Heredada

Este tipo no tiene campos.

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