- Solicitud HTTP
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- ConsolidationStrategy
- NoConsolidation
- Heredado
- Pruébala
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 ( |
Campos | |
---|---|
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 |
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 |
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 |
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:
|
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 |
Devolver actividades para este elemento de Drive. El formato es |
ancestorName |
Mostrar actividades para esta carpeta de Drive, además de todos los elementos secundarios y subordinados El formato es |
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 ( |
Campos | |
---|---|
activities[] |
Lista de actividades solicitadas. |
nextPageToken |
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 |
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 |
Las actividades individuales no están consolidadas. |
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.