Method: activity.query

Запросите прошлую активность на Google Диске.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Тело запроса

Тело запроса содержит данные следующей структуры:

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.
}
Поля
consolidationStrategy

object ( ConsolidationStrategy )

Подробности о том, как объединить связанные действия, составляющие деятельность. Если этот параметр не установлен, связанные действия не объединяются.

pageSize

integer

Минимальное количество действий, желаемых в ответе; сервер пытается вернуть хотя бы это количество. Сервер также может возвращать меньше действий, если у него есть готовый частичный ответ до истечения времени запроса. Если не установлено, используется значение по умолчанию.

pageToken

string

Токен определяет, какую страницу результатов следует вернуть. Установите для этого значения значение nextPageToken, возвращенное из предыдущего запроса, чтобы получить следующую страницу результатов. Если не установлено, возвращается первая страница результатов.

filter

string

Фильтрация элементов, возвращаемых по этому запросу. Формат строки фильтра представляет собой последовательность выражений, соединенных необязательным оператором «И», где каждое выражение имеет форму «значение оператора поля».

Поддерживаемые поля:

  • time : использует числовые операторы для значений даты либо в миллисекундах с 1 января 1970 года, либо в формате RFC 3339 . Примеры:

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

  • detail.action_detail_case : использует оператор has (:) и либо единственное значение, либо список разрешенных типов действий, заключенных в круглые скобки и разделенных пробелом. Чтобы исключить результат из ответа, добавьте дефис ( - ) в начало строки фильтра. Примеры:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
key поля объединения. Основные критерии в запросе. По умолчанию используется ancestorName = items/root , если ключ не указан. key может быть только одним из следующих:
itemName

string

Возвращаемые действия для этого объекта на Диске. Формат: items/ITEM_ID .

ancestorName

string

Вернуть действия для этой папки Диска, а также всех дочерних и потомков. Формат: items/ITEM_ID .

Тело ответа

В случае успеха тело ответа содержит данные следующей структуры:

Ответное сообщение на запрос активности Диска.

JSON-представление
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Поля
activities[]

object ( DriveActivity )

Список запрошенных действий.

nextPageToken

string

Токен для получения следующей страницы результатов или пустой, если в списке больше нет результатов.

Области авторизации

Требуется одна из следующих областей OAuth:

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

Дополнительную информацию см. в руководстве по авторизации .

КонсолидацияСтратегия

Как консолидируются отдельные виды деятельности. Если набор действий связан, их можно объединить в одно комбинированное действие, например, когда один участник выполняет одно и то же действие для нескольких целей, или несколько участников выполняют одно и то же действие для одной цели. Стратегия определяет правила, по которым связаны действия.

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.
}
Поля
Полевая strategy Союза. Как консолидируются отдельные виды деятельности. strategy может быть только одной из следующих:
none

object ( NoConsolidation )

Отдельные виды деятельности не консолидируются.

legacy

object ( Legacy )

Отдельные действия объединяются с использованием устаревшей стратегии.

НетКонсолидация

Стратегия, которая не предполагает консолидации отдельных видов деятельности.

Наследие

Стратегия, которая объединяет действия с использованием правил группировки из устаревшего API действий V1. Подобные действия, происходящие в течение определенного периода времени, могут быть сгруппированы по нескольким целям (например, одновременное перемещение набора файлов) или нескольким субъектам (например, несколько пользователей, редактирующих один и тот же элемент). Правила группировки для этой стратегии специфичны для каждого типа действий.