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, las acciones relacionadas no se consolidarán.
pageSize

integer

El número mínimo de actividades deseadas en la respuesta; el servidor intenta mostrar al menos esta cantidad. 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 mostrará. Establece esto en el valor de nextPageToken que se muestra en una consulta anterior para obtener la siguiente página de resultados. Si no se establece, se muestra la primera página de resultados.
filter

string

El filtrado de los elementos mostrados en esta solicitud de consulta. El formato de la cadena de filtro es una secuencia de expresiones unidas por un "AND" opcional, donde cada expresión tiene el formato "valor del operador de campo".

Campos admitidos:

  • time: Usa operadores numéricos en los valores de fecha 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 "has" (:) y un valor singular o una lista de 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. El valor predeterminado es ancestorName = items/root, si no se especifica una clave. key puede ser solo uno de los siguientes:
itemName

string

Devolver actividades para este elemento de Drive. El formato es items/ITEM_ID.
ancestorName

string

Mostrar actividades para esta carpeta de Drive, además de todos los elementos secundarios y subordinados 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.

ConsolidationStrategy

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

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 usando la estrategia heredada.

NoConsolidation

Es una estrategia que no consolida las actividades individuales.

Heredada

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