Google Drive Parameters

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

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

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

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

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

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

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

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

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

Таблица: Уровни видимости
Поле Определение
частный Файл никому не доступен.
общий_внутренний Файл доступен только пользователям/группам в домене владельца.
кто-либо_в_домене_с_ссылкой Файл является общим, поэтому доступ к нему может получить любой пользователь домена, у которого есть ссылка.
кто-нибудь_в_домене Файл является общим, поэтому любой пользователь домена может найти его и получить к нему доступ.
общий_внешний Файл доступен для общего доступа, поэтому пользователи/группы, не входящие в домен владельца, могут его видеть.
кто-нибудь_с_ссылкой Доступ к файлу открыт для всех, у кого есть ссылка.
публичный Файл находится в открытом доступе.

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

При расчете метрик видимости учитывается только самое высокое — или наиболее общедоступное — состояние видимости для любого заданного файла. Например, рассмотрим следующие параметры общего доступа, примененные к одному файлу. Хотя файл имеет несколько состояний видимости, сообщается только 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, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_google_drawings_edited целое число Количество рисунков Google, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_google_drawings_trashed целое число Количество рисунков Google, удаленных пользователем или доменом. Если элемент сначала был удален, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент отправляется в корзину несколько раз, он учитывается в метрике только один раз.
num_google_drawings_viewed целое число Количество рисунков Google, просмотренных пользователем или доменом. Несколько просмотров одного и того же файла учитываются только один раз для каждого файла.
num_google_forms_created целое число Количество форм Google, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_google_forms_edited целое число Количество Google Forms, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_google_forms_trashed целое число Количество Google Форм, удаленных пользователем или доменом. Если элемент сначала был удален, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент отправляется в корзину несколько раз, он учитывается в метрике только один раз.
num_google_forms_viewed целое число Количество форм Google, просмотренных пользователем или доменом. Несколько просмотров одного и того же файла учитываются только один раз для каждого файла.
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, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_google_sites_edited целое число Количество Сайтов Google, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_google_sites_trashed целое число Количество Сайтов Google, удаленных пользователем или доменом. Если элемент сначала был удален, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент отправляется в корзину несколько раз, он учитывается в метрике только один раз.
num_google_sites_viewed целое число Количество Сайтов Google, просмотренных пользователем или доменом. Несколько просмотров одного и того же файла учитываются только один раз для каждого файла.
num_google_spreadsheets_created целое число Количество таблиц Google, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_google_spreadsheets_edited целое число Количество таблиц Google, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_google_spreadsheets_trashed целое число Количество электронных таблиц Google, удаленных пользователем или доменом. Если элемент сначала был удален, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент отправляется в корзину несколько раз, он учитывается в метрике только один раз.
num_google_spreadsheets_viewed целое число Количество таблиц Google, просмотренных пользователем или доменом. Несколько просмотров одного и того же файла учитываются только один раз для каждого файла.
num_items_created целое число Количество элементов Google Диска, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_items_edited целое число Количество элементов Google Диска, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_items_trashed целое число Количество элементов Google Диска, удаленных пользователем или доменом. Если элемент сначала был удален, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент отправляется в корзину несколько раз, он учитывается в метрике только один раз.
num_items_viewed целое число Количество элементов Google Диска, просмотренных пользователем или доменом. Несколько просмотров одного и того же файла учитываются только один раз для каждого файла.
num_other_types_created целое число Количество любых других элементов Google Диска, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_other_types_edited целое число Количество любых других элементов Google Диска, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_other_types_trashed целое число Количество любых других элементов Google Диска, удаленных пользователем или доменом. Если элемент сначала был удален, а затем восстановлен, он все равно будет учитываться в метрике. Если элемент отправляется в корзину несколько раз, он учитывается в метрике только один раз.
num_other_types_viewed целое число Количество любых других элементов Google Диска, просмотренных пользователем или доменом. Несколько просмотров одного и того же файла учитываются только один раз для каждого файла.
num_owned_external_items_added целое число Количество внешних элементов Google Диска, добавленных в организацию.
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, для которых выполнено хотя бы одно событие типа «добавление», например создание, загрузка, удаление событий или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_google_drawings_created целое число Количество рисунков Google, созданных в день составления этого отчета, владельцем которых является пользователь домена. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_owned_google_drawings_delta целое число Количество рисунков Google в учетной записи клиента, права собственности на которые изменились, чтобы увеличить или уменьшить права собственности на файлы.
num_owned_google_drawings_edited целое число Количество документов Google в учетной записи клиента, которые были отредактированы.
num_owned_google_drawings_removed целое число Количество удаленных рисунков Google в аккаунте клиента.
num_owned_google_drawings_trashed целое число Количество Google Рисунков в аккаунте клиента, которые были удалены из корзины.
num_owned_google_drawings_viewed целое число Количество просмотренных рисунков Google в учетной записи клиента.
num_owned_google_forms_added целое число Количество Google Форм, для которых выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление событий или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_google_forms_created целое число Количество форм Google, созданных в день составления этого отчета, владельцем которых является пользователь домена. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
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 Форм в аккаунте клиента, которые были удалены из корзины.
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, созданных в день составления этого отчета, владельцем которых является пользователь домена. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_owned_google_sites_delta целое число Количество Сайтов Google в учетной записи клиента, права собственности на которые изменились, чтобы увеличить или уменьшить права собственности на файлы.
num_owned_google_sites_edited целое число Количество Сайтов Google в аккаунте клиента, которые были изменены.
num_owned_google_sites_removed целое число Количество удаленных Сайтов Google в аккаунте клиента.
num_owned_google_sites_trashed целое число Количество Сайтов Google в аккаунте клиента, которые были удалены из корзины.
num_owned_google_sites_viewed целое число Количество просмотренных сайтов Google в аккаунте клиента.
num_owned_google_spreadsheets_added целое число Количество таблиц Google, в отношении которых было выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление событий или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_google_spreadsheets_created целое число Количество таблиц Google, созданных в день составления этого отчета, владельцем которых является пользователь домена. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_owned_google_spreadsheets_delta целое число Количество электронных таблиц Google в учетной записи клиента, права собственности на которые изменились в сторону увеличения или уменьшения права собственности на файлы.
num_owned_google_spreadsheets_edited целое число Количество таблиц Google в аккаунте клиента, которые были отредактированы.
num_owned_google_spreadsheets_removed целое число Количество удаленных таблиц Google в аккаунте клиента.
num_owned_google_spreadsheets_trashed целое число Количество таблиц Google в аккаунте клиента, которые были удалены из корзины.
num_owned_google_spreadsheets_viewed целое число Количество просмотренных электронных таблиц Google в аккаунте клиента.
num_owned_internal_items_added целое число Количество внутренних элементов Google Диска, для которых выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление событий или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_internal_items_delta целое число
num_owned_internal_items_removed целое число
num_owned_items_added целое число Количество элементов на Google Диске, для которых выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление из корзины или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_created целое число Количество элементов Google Диска, созданных в день составления этого отчета, владельцем которых является пользователь домена. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_owned_items_delta целое число Количество элементов Google Диска в учетной записи клиента, право собственности на которые изменилось, чтобы увеличить или уменьшить право собственности на файл.
num_owned_items_edited целое число Количество элементов Google Диска в учетной записи клиента, которые были отредактированы.
num_owned_items_removed целое число Количество удаленных элементов Google Диска в учетной записи клиента.
num_owned_items_trashed целое число Количество элементов Google Диска в учетной записи клиента, которые были удалены в корзину.
num_owned_items_viewed целое число Количество просмотренных элементов Google Диска в учетной записи клиента.
num_owned_items_with_visibility_anyone_in_domain_added целое число Количество элементов на Google Диске, для которых настроена видимость для anyone_in_domain с хотя бы одним событием типа "дополнение", например созданием, загрузкой, удалением событий или передачей права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_anyone_in_domain_delta целое число Количество элементов на Google Диске, настроенных с anyone_in_domain в учетной записи клиента, права собственности на которые изменились либо для увеличения, либо для уменьшения права собственности на файл.
num_owned_items_with_visibility_anyone_in_domain_removed целое число Количество удаленных элементов Google Диска, в которых настроено anyone_in_domain в учетной записи клиента.
num_owned_items_with_visibility_anyone_in_domain_with_link_added целое число Количество элементов на Google Диске, для которых настроена видимость для anyone_in_domain_with_link и для которых выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление из корзины или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_anyone_in_domain_with_link_delta целое число Количество элементов на Google Диске, для которых настроено anyone_in_domain_with_link в ​​учетной записи клиента, права собственности на которые изменились, либо для увеличения, либо для уменьшения права собственности на файл.
num_owned_items_with_visibility_anyone_in_domain_with_link_removed целое число Количество удаленных элементов Google Диска, настроенных для видимости anyone_in_domain_with_link в ​​учетной записи клиента.
num_owned_items_with_visibility_anyone_with_link_added целое число Количество элементов на Google Диске, для которых настроена видимость для anyone_with_link , для которых выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление из корзины или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_anyone_with_link_delta целое число Количество элементов Google Диска, настроенных с видимостью для anyone_with_link в ​​учетной записи клиента, права собственности на которые изменились либо для увеличения, либо для уменьшения права собственности на файл.
num_owned_items_with_visibility_anyone_with_link_removed целое число Количество удаленных элементов Google Диска, настроенных для видимости для anyone_with_link в ​​учетной записи клиента.
num_owned_items_with_visibility_private_added целое число Количество элементов Google Диска, для которых настроена видимость private , с которыми было выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление событий или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_private_delta целое число Количество элементов Google Диска, настроенных с видимостью private данных в учетной записи клиента, где право собственности изменилось, чтобы увеличить или уменьшить право собственности на файл.
num_owned_items_with_visibility_private_removed целое число Количество элементов Google Диска, настроенных с видимостью private в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_public_added целое число Количество элементов Google Диска, для которых настроена public для всех , с которыми было выполнено хотя бы одно событие типа "добавление", например создание, загрузка, удаление событий или передача права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_public_delta целое число Количество элементов на Google Диске, настроенных для public доступа в учетной записи клиента, где право собственности изменилось, чтобы увеличить или уменьшить право собственности на файл.
num_owned_items_with_visibility_public_removed целое число Количество элементов Google Диска, настроенных для public доступа в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_shared_externally_added целое число Количество элементов Google Диска, для которых настроена видимость shared_externally с хотя бы одним событием типа "добавление", выполненным с ними, например созданием, загрузкой, удалением событий или передачей права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_shared_externally_delta целое число Количество элементов Google Диска, настроенных с видимостью shared_externally в учетной записи клиента, где право собственности изменилось, чтобы увеличить или уменьшить право собственности на файл.
num_owned_items_with_visibility_shared_externally_removed целое число Количество элементов Google Диска, настроенных с видимостью shared_externally в учетной записи клиента, которые были удалены.
num_owned_items_with_visibility_shared_internally_added целое число Количество элементов Google Диска, настроенных с видимостью shared_internally с выполненным над ними хотя бы одним событием типа "добавление", например созданием, загрузкой, удалением событий или передачей права собственности. Об этом действии сообщается независимо от конечного состояния элемента.
num_owned_items_with_visibility_shared_internally_delta целое число Количество элементов Google Диска, настроенных с видимостью shared_internally в учетной записи клиента, где право собственности изменилось, чтобы увеличить или уменьшить право собственности на файл.
num_owned_items_with_visibility_shared_internally_removed целое число Количество элементов Google Диска, настроенных с видимостью 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 Диска, созданных пользователем или доменом. При этом не отслеживаются элементы, которые попали во владение клиента в результате извлечения, восстановления или передачи права собственности.
num_owned_other_types_delta целое число Количество любых других элементов Google Диска в учетной записи клиента, право собственности на которые изменилось, чтобы увеличить или уменьшить право собственности на файл.
num_owned_other_types_edited целое число Количество любых других элементов Google Диска, отредактированных пользователем или доменом. Несколько правок одного и того же файла учитываются только один раз для каждого файла.
num_owned_other_types_removed целое число Количество любых других удаленных элементов Google Диска в учетной записи клиента.
num_owned_other_types_trashed целое число Количество любых других элементов Google Диска в аккаунте клиента, которые были удалены в корзину.
num_owned_other_types_viewed целое число Количество любых других просмотренных элементов Google Диска в учетной записи клиента.
timestamp_last_active_usage целое число Указывает на последнее активное использование пользователем Google Диска.