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. Подобные действия, происходящие в течение определенного периода времени, могут быть сгруппированы по нескольким целям (например, одновременное перемещение набора файлов) или по нескольким действующим лицам (например, по нескольким пользователям, редактирующим один и тот же элемент). Правила группировки для этой стратегии специфичны для каждого типа действий.