Google Drive Parameters

В этом документе перечислены параметры для различных типов событий активности Google Drive. Вы можете получить доступ к этим событиям, вызвав метод UserUsageReport.get() с parameters=drive: PARAMETER .

Эти показатели отражают совокупное поведение пользователей при работе с элементами Google Drive в вашем домене.

Данные отчетности можно разделить на числовые значения с точки зрения участника или владельца.
  • Показатели действия — это человек, выполняющий действие над файлом.
  • Показатели владельца — это данные о лице, которому принадлежит обрабатываемый файл. Значения, в названиях которых присутствует owned , относятся к данным о владельце.

Параметры видимости

Параметры могут предоставлять сводные показатели видимости и принадлежности для элементов в вашем домене. Эти параметры делятся на три основные формы, где * заменяется любым из полей, перечисленных в таблице уровней видимости ниже:

num_owned_items_with_visibility_*_added
К таким элементам в Docs или Google Drive относится тот, для которого было выполнено хотя бы одно событие addition , например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента. Множественные события addition к одному и тому же файлу не увеличивают счетчик.
num_owned_items_with_visibility_*_removed
Это касается элементов в Документах или Диске, над которыми было выполнено хотя бы одно действие типа removal , например, перемещение в корзину, окончательное удаление или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_*_delta
Чистое изменение количества принадлежащих пользователю элементов Google Docs и Google Drive для всего домена, с разбивкой по пользователям. Например, если один элемент добавлен, а другой удален, показатели добавления и удаления будут равны 1, а показатель дельты — 0.

При подсчете общего количества событий учитывается только одно событие addition или removal для каждого элемента. Например, если файл сначала добавляется в Google Диск, а затем передается другому владельцу, это вызывает два события addition и одно событие removal , но итоговый результат для этого файла будет одним добавлением и одним удалением.

Определения видимости

В следующей таблице поля перечислены в порядке видимости от наименьшей (частная) до наибольшей (публичная).

Таблица: Уровни видимости
Поле Определение
private Файл никому не передается.
shared_internally Файл предоставляется в общий доступ только пользователям/группам в домене владельца.
anyone_in_domain_with_link Файл доступен для всех пользователей домена, имеющих ссылку на него.
anyone_in_domain Файл доступен для всех пользователей в домене, поэтому любой может найти его и получить к нему доступ.
shared_externally Файл предоставляется в общий доступ, чтобы пользователи/группы, не входящие в домен владельца, могли его видеть.
anyone_with_link Файл доступен для всех, у кого есть ссылка.
public Файл находится в открытом доступе.

Метрики по нескольким уровням видимости или событиям

При расчете метрик видимости учитывается только наивысшее — или наиболее общедоступное — состояние видимости для любого заданного файла. Например, рассмотрим следующие настройки доступа, примененные к одному файлу. Хотя файл имеет несколько состояний видимости, сообщается только о public состоянии видимости.

Пример состояния видимости
Настройки общего доступа состояние видимости
Общедоступный public
Предоставлено нескольким пользователям в домене. shared_internally
Доступно только определенным пользователям за пределами домена. shared_externally

Параметры активности элемента

Параметры активности элементов могут предоставлять метрики активности для элементов в вашей предметной области.

Имя Тип Описание
num_google_documents_created целое число Количество документов Google, созданных пользователем или доменом. Эта информация не отслеживает элементы, попавшие в руки клиента в результате удаления, восстановления или передачи прав собственности.
num_google_documents_edited целое число Количество документов Google, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_google_documents_trashed целое число Количество удаленных пользователем или доменом документов Google. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в метрике. Если элемент был удален несколько раз, он будет учтен в метрике только один раз.
num_google_documents_viewed целое число Количество просмотров документов Google пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_google_drawings_created целое число Количество рисунков Google Drawings, созданных пользователем или доменом. Эта информация не отслеживает элементы, попавшие в руки клиента в результате удаления, восстановления или передачи прав собственности.
num_google_drawings_edited целое число Количество рисунков Google Drawings, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_google_drawings_trashed целое число Количество удаленных пользователем или доменом рисунков Google Drawings. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в метрике. Если элемент был удален несколько раз, он будет учтен в метрике только один раз.
num_google_drawings_viewed целое число Количество просмотров одного и того же файла пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_google_forms_created целое число Количество созданных пользователем или доменом форм Google Forms. Эта информация не отслеживает элементы, попавшие в руки клиента в результате удаления, восстановления или передачи прав собственности.
num_google_forms_edited целое число Количество форм Google Forms, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_google_forms_trashed целое число Количество удаленных пользователем или доменом форм Google Forms. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в метрике. Если элемент был удален несколько раз, он будет учтен в метрике только один раз.
num_google_forms_viewed целое число Количество просмотров форм Google Forms пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_google_presentations_created целое число Количество презентаций Google, созданных пользователем или доменом. Эта информация не отслеживает элементы, попавшие в руки клиента в результате удаления, восстановления или передачи прав собственности.
num_google_presentations_edited целое число Количество презентаций Google, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_google_presentations_trashed целое число Количество удаленных пользователем или доменом презентаций Google. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в метрике. Если элемент был удален несколько раз, он будет учтен в метрике только один раз.
num_google_presentations_viewed целое число Количество просмотров презентаций Google, выполненных пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_google_sites_created целое число Количество сайтов Google Sites, созданных пользователем или доменом. Эта информация не отслеживает элементы, попавшие в собственность клиента в результате удаления, восстановления или передачи прав собственности.
num_google_sites_edited целое число Количество сайтов Google, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_google_sites_trashed целое число Количество сайтов Google, удаленных пользователем или доменом. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в метрике. Если элемент был удален несколько раз, он учитывается в метрике только один раз.
num_google_sites_viewed целое число Количество просмотров сайта Google Sites пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_google_spreadsheets_created целое число Количество таблиц Google Spreadsheets, созданных пользователем или доменом. Это не учитывает элементы, попавшие в руки клиента в результате удаления, восстановления или передачи прав собственности.
num_google_spreadsheets_edited целое число Количество таблиц Google Sheets, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_google_spreadsheets_trashed целое число Количество удаленных пользователем или доменом таблиц Google Sheets. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в показателе. Если элемент был удален несколько раз, он будет учтен в показателе только один раз.
num_google_spreadsheets_viewed целое число Количество просмотров таблиц Google Sheets пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_items_created целое число Количество элементов Google Drive, созданных пользователем или доменом. Это не учитывает элементы, попавшие в руки клиента в результате восстановления из корзины, удаления или передачи прав собственности.
num_items_edited целое число Количество элементов Google Диска, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_items_trashed целое число Количество элементов Google Drive, удаленных пользователем или доменом. Если элемент был удален сначала, а затем восстановлен, он все равно будет учтен в метрике. Если элемент был удален несколько раз, он учитывается в метрике только один раз.
num_items_viewed целое число Количество элементов Google Диска, просмотренных пользователем или доменом. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_other_types_created целое число Количество любых других элементов Google Drive, созданных пользователем или доменом. Это не отслеживает элементы, которые попали в руки клиента в результате восстановления из корзины, удаления или передачи прав собственности.
num_other_types_edited целое число Количество любых других элементов Google Диска, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_other_types_trashed целое число Количество любых других элементов Google Drive, удаленных пользователем или доменом. Если элемент был удален сначала, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент был удален несколько раз, он учитывается в метрике только один раз.
num_other_types_viewed целое число Количество просмотров пользователем или доменом любых других элементов Google Drive. Многократные просмотры одного и того же файла учитываются только один раз для каждого файла.
num_owned_external_items_added целое число Количество внешних элементов Google Drive, добавленных в организацию.
num_owned_external_items_delta целое число
num_owned_external_items_removed целое число
num_owned_google_documents_added целое число Количество документов Google, в которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_google_documents_created целое число Количество документов Google, созданных в день составления этого отчета, владельцем которых является пользователь домена. Данные не учитывают элементы, попавшие в руки клиента в результате восстановления из корзины, повторного удаления или передачи права собственности.
num_owned_google_documents_delta целое число Количество документов Google в учетной записи клиента, в которых изменилось право собственности (увеличилось или уменьшилось).
num_owned_google_documents_edited целое число Количество отредактированных документов Google в учетной записи клиента.
num_owned_google_documents_removed целое число Количество удаленных документов Google в учетной записи клиента.
num_owned_google_documents_trashed целое число Количество удаленных документов Google в учетной записи клиента.
num_owned_google_documents_viewed целое число Количество просмотренных документов Google в учетной записи клиента.
num_owned_google_drawings_added целое число Количество рисунков Google Drawings, для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_google_drawings_created целое число Количество рисунков Google Drawings, созданных в день составления этого отчета, владельцем которых является пользователь домена. Это не учитывает элементы, попавшие в собственность клиента в результате удаления, восстановления или передачи права собственности.
num_owned_google_drawings_delta целое число Количество рисунков Google Drawings в учетной записи клиента, в которых изменился владелец (увеличилось или уменьшилось количество прав собственности на файл).
num_owned_google_drawings_edited целое число Количество отредактированных документов Google в учетной записи клиента.
num_owned_google_drawings_removed целое число Количество удаленных рисунков Google Drawings из учетной записи клиента.
num_owned_google_drawings_trashed целое число Количество удаленных рисунков Google Drawings в учетной записи клиента.
num_owned_google_drawings_viewed целое число Количество просмотренных рисунков Google Drawings в учетной записи клиента.
num_owned_google_forms_added целое число Количество форм Google Forms, в которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_google_forms_created целое число Количество созданных в день составления отчета форм Google Forms, владельцем которых является пользователь домена. Данные не учитывают элементы, попавшие в распоряжение клиента в результате удаления, восстановления или передачи прав собственности.
num_owned_google_forms_delta целое число Количество форм Google Forms в учетной записи клиента, в которых изменилось право собственности (увеличилось или уменьшилось).
num_owned_google_forms_edited целое число Количество отредактированных документов Google в учетной записи клиента.
num_owned_google_forms_removed целое число Количество удаленных форм Google Forms в аккаунте клиента.
num_owned_google_forms_trashed целое число Количество удаленных форм Google Forms в аккаунте клиента.
num_owned_google_forms_viewed целое число Количество просмотренных форм Google Forms в аккаунте клиента.
num_owned_google_presentations_added целое число Количество презентаций Google, в которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_google_presentations_created целое число Количество презентаций Google, созданных в день составления этого отчета, владельцем которых является пользователь домена. Это не учитывает элементы, попавшие в собственность клиента в результате восстановления из корзины, повторного удаления или передачи прав собственности.
num_owned_google_presentations_delta целое число Количество презентаций Google в учетной записи клиента, в которых изменилось право собственности (увеличилось или уменьшилось).
num_owned_google_presentations_edited целое число Количество отредактированных презентаций Google в аккаунте клиента.
num_owned_google_presentations_removed целое число Количество удаленных презентаций Google в аккаунте клиента.
num_owned_google_presentations_trashed целое число Количество удаленных презентаций Google в аккаунте клиента.
num_owned_google_presentations_viewed целое число Количество просмотренных презентаций Google в аккаунте клиента.
num_owned_google_sites_added целое число Количество сайтов Google, на которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_google_sites_created целое число Количество сайтов Google Sites, созданных в день составления этого отчета, владельцем которых является пользователь домена. Данные не учитывают элементы, попавшие в собственность клиента в результате восстановления, удаления или передачи прав собственности.
num_owned_google_sites_delta целое число Количество сайтов Google в учетной записи клиента, в которых изменилось право собственности, либо увеличилось, либо уменьшилось.
num_owned_google_sites_edited целое число Количество сайтов Google Sites в учетной записи клиента, которые были отредактированы.
num_owned_google_sites_removed целое число Количество сайтов Google в учетной записи клиента, которые были удалены.
num_owned_google_sites_trashed целое число Количество сайтов Google Sites в учетной записи клиента, которые были удалены.
num_owned_google_sites_viewed целое число Количество просмотренных сайтов Google Sites в аккаунте клиента.
num_owned_google_spreadsheets_added целое число Количество таблиц Google Sheets, в которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_google_spreadsheets_created целое число Количество таблиц Google Spreadsheets, созданных в день составления этого отчета, владельцем которых является пользователь домена. Это не учитывает элементы, попавшие в распоряжение клиента в результате восстановления, удаления или передачи прав собственности.
num_owned_google_spreadsheets_delta целое число Количество таблиц Google Таблиц в учетной записи клиента, в которых изменился владелец (увеличилось или уменьшилось количество файлов).
num_owned_google_spreadsheets_edited целое число Количество отредактированных таблиц Google Sheets в учетной записи клиента.
num_owned_google_spreadsheets_removed целое число Количество удаленных таблиц Google Spreadsheets из учетной записи клиента.
num_owned_google_spreadsheets_trashed целое число Количество удаленных таблиц Google Таблиц в учетной записи клиента.
num_owned_google_spreadsheets_viewed целое число Количество просмотренных таблиц Google Sheets в учетной записи клиента.
num_owned_internal_items_added целое число Количество внутренних элементов Google Drive, для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_internal_items_delta целое число
num_owned_internal_items_removed целое число
num_owned_items_added целое число Количество элементов Google Drive, для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_created целое число Количество элементов Google Drive, созданных в день составления этого отчета, владельцем которых является пользователь домена. В этот список не входят элементы, попавшие в руки клиента в результате восстановления из корзины, удаления или передачи прав собственности.
num_owned_items_delta целое число Количество элементов Google Drive в учетной записи клиента, в которых изменилось право собственности (увеличилось или уменьшилось).
num_owned_items_edited целое число Количество отредактированных элементов в учетной записи клиента в Google Drive.
num_owned_items_removed целое число Количество удаленных элементов Google Drive из учетной записи клиента.
num_owned_items_trashed целое число Количество удаленных элементов в учетной записи клиента в Google Drive.
num_owned_items_viewed целое число Количество просмотренных элементов в учетной записи клиента в Google Drive.
num_owned_items_with_visibility_anyone_in_domain_added целое число Количество элементов Google Drive, настроенных с уровнем видимости anyone_in_domain , для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_anyone_in_domain_delta целое число Количество элементов Google Drive, для которых в учетной записи клиента был установлен уровень видимости anyone_in_domain , при котором произошло изменение прав собственности (увеличение или уменьшение прав доступа к файлу).
num_owned_items_with_visibility_anyone_in_domain_removed целое число Количество элементов Google Drive, настроенных с видимостью anyone_in_domain в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_anyone_in_domain_with_link_added целое число Количество элементов Google Drive, настроенных с уровнем видимости anyone_in_domain_with_link , для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_anyone_in_domain_with_link_delta целое число Количество элементов Google Drive, для которых в учетной записи клиента был установлен параметр видимости anyone_in_domain_with_link , при этом произошло изменение прав собственности (увеличение или уменьшение прав доступа к файлу).
num_owned_items_with_visibility_anyone_in_domain_with_link_removed целое число Количество элементов Google Drive, настроенных с видимостью anyone_in_domain_with_link в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_anyone_with_link_added целое число Количество элементов Google Drive, настроенных с уровнем видимости anyone_with_link , для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_anyone_with_link_delta целое число Количество элементов Google Drive, для которых в учетной записи клиента был установлен параметр видимости anyone_with_link , при этом произошло изменение прав собственности (увеличение или уменьшение размера файла).
num_owned_items_with_visibility_anyone_with_link_removed целое число Количество элементов Google Drive, для которых в учетной записи клиента была установлена ​​видимость anyone_with_link , и которые были удалены.
num_owned_items_with_visibility_private_added целое число Количество элементов Google Drive с настройкой видимости « private », для которых выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_private_delta целое число Количество элементов Google Drive, для которых в учетной записи клиента установлен режим видимости private , при котором изменилось право собственности (увеличилось или уменьшилось).
num_owned_items_with_visibility_private_removed целое число Количество удаленных элементов Google Drive, настроенных на private доступ в учетной записи клиента.
num_owned_items_with_visibility_public_added целое число Количество элементов Google Drive с настройкой видимости « public », для которых выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_public_delta целое число Количество элементов Google Drive, для которых в учетной записи клиента установлен режим видимости « public , при котором изменилось право собственности (увеличилось или уменьшилось).
num_owned_items_with_visibility_public_removed целое число Количество удаленных элементов Google Drive, настроенных на public доступ в учетной записи клиента.
num_owned_items_with_visibility_shared_externally_added целое число Количество элементов Google Drive, настроенных с видимостью shared_externally , для которых выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_shared_externally_delta целое число Количество элементов Google Drive, для которых в учетной записи клиента был установлен параметр видимости shared_externally , при этом произошло изменение прав собственности (увеличение или уменьшение размера файла).
num_owned_items_with_visibility_shared_externally_removed целое число Количество элементов Google Drive, настроенных с видимостью shared_externally в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_shared_internally_added целое число Количество элементов Google Drive, настроенных с уровнем видимости shared_internally , для которых выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_items_with_visibility_shared_internally_delta целое число Количество элементов Google Диска, для которых в учетной записи клиента был установлен параметр видимости shared_internally , при котором изменилось право собственности (увеличилось или уменьшилось).
num_owned_items_with_visibility_shared_internally_removed целое число Количество элементов Google Drive, настроенных с видимостью shared_internally в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_unknown_added целое число
num_owned_items_with_visibility_unknown_delta целое число
num_owned_items_with_visibility_unknown_removed целое число
num_owned_other_types_added целое число Количество любых других элементов Google Диска, для которых было выполнено хотя бы одно событие типа «добавление», например, создание, загрузка, извлечение из корзины или передача прав собственности. Эта активность регистрируется независимо от конечного состояния элемента.
num_owned_other_types_created целое число Количество любых других элементов Google Drive, созданных пользователем или доменом. Это не отслеживает элементы, которые попали в руки клиента в результате восстановления из корзины, удаления или передачи прав собственности.
num_owned_other_types_delta целое число Количество любых других элементов Google Drive в учетной записи клиента, в отношении которых изменилось право собственности, будь то увеличение или уменьшение размера файла.
num_owned_other_types_edited целое число Количество любых других элементов Google Диска, отредактированных пользователем или доменом. Многократное редактирование одного и того же файла учитывается только один раз для каждого файла.
num_owned_other_types_removed целое число Количество любых других элементов Google Drive в учетной записи клиента, которые были удалены.
num_owned_other_types_trashed целое число Количество других элементов Google Drive в учетной записи клиента, которые были удалены.
num_owned_other_types_viewed целое число Количество просмотренных элементов в других учетных записях Google Drive клиента.
timestamp_last_active_usage целое число Указывает на последнее активное использование пользователем Google Диска.