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 )

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

NoConsolidation

Этот тип не имеет полей.

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

Наследие

Этот тип не имеет полей.

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