Google Drive Parameters

This document lists the parameters for various types of Google Drive activity events. You can retrieve these events by calling UserUsageReport.get() with parameters=drive:PARAMETER.

These metrics reflect aggregated user behavior on Google Drive items in your domain.

Reporting data can be divided into numbers from an actor's or owner's point of view.

• Actor metrics—the person performing the action on a file.
• Owner metrics—the person who owns the file being acted on. Values with owned in their names refer to owner data.

Visibility parameters

Parameters can provide aggregate visibility and ownership metrics for items within your domain. These parameters fall into three general forms, where * is replaced by any of the fields listed in the Visibility levels table below:

num_owned_items_with_visibility_*_added

those Docs or Drive items with at least one addition type event performed on them such as create, uploads, untrash events, or ownership transfer. This activity gets reported regardless of the final state of the item. Multiple addition events to the same file do not increment the count.

num_owned_items_with_visibility_*_removed

those Docs or Drive items with at least one removal type event performed on them, such as trash, permanent delete, or ownership transfer. This activity gets reported regardless of the final state of the item.

num_owned_items_with_visibility_*_delta

the net change in number of Google Docs and Drive items owned for the entire domain, segmented by user. For example, if one item gets added and another gets removed, the added and removed metrics each report 1, but the delta metric reports 0.

For event totals, only one addition or removal event per item counts toward the final value. For example, if a file is first added to Drive and then transferred to another owner, this triggers two addition events and one removal event, but the final tally for that file is one addition and one removal.

Visibility definitions

The following table lists fields in order of visibility from lowest (private) to highest (public).

Table: Visibility levels

Field	Definition
private	The file is not shared with anyone.
shared_internally	The file is shared only with users/groups within the owner's domain.
anyone_in_domain_with_link	The file is shared so that anyone in the domain with the link can access.
anyone_in_domain	The file is shared so that anyone in the domain can find and access it.
shared_externally	The file is shared so that users/groups external to the owner's domain can see it.
anyone_with_link	The file is shared so that anyone with the link can access.
public	The file is publicly accessible.

Metrics on multiple visibility levels or events

Calculation for visibility metrics considers only the highest—or most public—visibility state for any given file. For example, consider the following sharing settings applied to a single file. While the file has multiple visibilities states, only the public visibility state is reported.

Example visibility state

Sharing setting	Visibility state
Publicly visible	public
Shared with a few users in the domain	shared_internally
Shared with specific users outside the domain	shared_externally

Item activity parameters

Item activity parameters can provide activity metrics for items within your domain.

Name	Type	Description
num_google_documents_created	integer	The number of Google Documents created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_google_documents_edited	integer	The number of Google Documents edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_google_documents_trashed	integer	The number of Google Documents trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_google_documents_viewed	integer	The number of Google Documents viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_google_drawings_created	integer	The number of Google Drawings created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_google_drawings_edited	integer	The number of Google Drawings edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_google_drawings_trashed	integer	The number of Google Drawings trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_google_drawings_viewed	integer	The number of Google Drawings viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_google_forms_created	integer	The number of Google Forms created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_google_forms_edited	integer	The number of Google Forms edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_google_forms_trashed	integer	The number of Google Forms trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_google_forms_viewed	integer	The number of Google Forms viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_google_presentations_created	integer	The number of Google Presentations created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_google_presentations_edited	integer	The number of Google Presentations edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_google_presentations_trashed	integer	The number of Google Presentations trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_google_presentations_viewed	integer	The number of Google Presentations viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_google_sites_created	integer	The number of Google Sites created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_google_sites_edited	integer	The number of Google Sites edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_google_sites_trashed	integer	The number of Google Sites trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_google_sites_viewed	integer	The number of Google Sites viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_google_spreadsheets_created	integer	The number of Google Spreadsheets created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_google_spreadsheets_edited	integer	The number of Google Spreadsheets edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_google_spreadsheets_trashed	integer	The number of Google Spreadsheets trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_google_spreadsheets_viewed	integer	The number of Google Spreadsheets viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_items_created	integer	The number of Google Drive items created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_items_edited	integer	The number of Google Drive items edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_items_trashed	integer	The number of Google Drive items trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_items_viewed	integer	The number of Google Drive items viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_other_types_created	integer	The number of any other Google Drive items created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_other_types_edited	integer	The number of any other Google Drive items edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_other_types_trashed	integer	The number of any other Google Drive items trashed by the user or domain. If an item is trashed at first, but then restored, it will still be counted in the metric. If an item is trashed multiple times, it is counted only once in the metric.
num_other_types_viewed	integer	The number of any other Google Drive items viewed by the user or domain. Multiple views of the same file are counted just once per file.
num_owned_external_items_added	integer	The number of external Google Drive items added to the organization.
num_owned_external_items_delta	integer
num_owned_external_items_removed	integer
num_owned_google_documents_added	integer	The number of Google Documents with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_google_documents_created	integer	The number of Google Documents created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_google_documents_delta	integer	The number of Google Documents within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_google_documents_edited	integer	The number of Google Documents within the customer's account which were edited.
num_owned_google_documents_removed	integer	The number of Google Documents within the customer's account which were removed.
num_owned_google_documents_trashed	integer	The number of Google Documents within the customer's account which were trashed.
num_owned_google_documents_viewed	integer	The number of Google Documents within the customer's account which were viewed.
num_owned_google_drawings_added	integer	The number of Google Drawings with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_google_drawings_created	integer	The number of Google Drawings created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_google_drawings_delta	integer	The number of Google Drawings within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_google_drawings_edited	integer	The number of Google Documents within the customer's account which were edited.
num_owned_google_drawings_removed	integer	The number of Google Drawings within the customer's account which were removed.
num_owned_google_drawings_trashed	integer	The number of Google Drawings within the customer's account which were trashed.
num_owned_google_drawings_viewed	integer	The number of Google Drawings within the customer's account which were viewed.
num_owned_google_forms_added	integer	The number of Google Forms with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_google_forms_created	integer	The number of Google Forms created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_google_forms_delta	integer	The number of Google Forms within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_google_forms_edited	integer	The number of Google Documents within the customer's account which were edited.
num_owned_google_forms_removed	integer	The number of Google Forms within the customer's account which were removed.
num_owned_google_forms_trashed	integer	The number of Google Forms within the customer's account which were trashed.
num_owned_google_forms_viewed	integer	The number of Google Forms within the customer's account which were viewed.
num_owned_google_presentations_added	integer	The number of Google Presentations with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_google_presentations_created	integer	The number of Google Presentations created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_google_presentations_delta	integer	The number of Google Presentations within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_google_presentations_edited	integer	The number of Google Presentations within the customer's account which were edited.
num_owned_google_presentations_removed	integer	The number of Google Presentations within the customer's account which were removed.
num_owned_google_presentations_trashed	integer	The number of Google Presentations within the customer's account which were trashed.
num_owned_google_presentations_viewed	integer	The number of Google Presentations within the customer's account which were viewed.
num_owned_google_sites_added	integer	The number of Google Sites with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_google_sites_created	integer	The number of Google Sites created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_google_sites_delta	integer	The number of Google Sites within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_google_sites_edited	integer	The number of Google Sites within the customer's account which were edited.
num_owned_google_sites_removed	integer	The number of Google Sites within the customer's account which were removed.
num_owned_google_sites_trashed	integer	The number of Google Sites within the customer's account which were trashed.
num_owned_google_sites_viewed	integer	The number of Google Sites within the customer's account which were viewed.
num_owned_google_spreadsheets_added	integer	The number of Google Spreadsheets with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_google_spreadsheets_created	integer	The number of Google Spreadsheets created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_google_spreadsheets_delta	integer	The number of Google Spreadsheets within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_google_spreadsheets_edited	integer	The number of Google Spreadsheets within the customer's account which were edited.
num_owned_google_spreadsheets_removed	integer	The number of Google Spreadsheets within the customer's account which were removed.
num_owned_google_spreadsheets_trashed	integer	The number of Google Spreadsheets within the customer's account which were trashed.
num_owned_google_spreadsheets_viewed	integer	The number of Google Spreadsheets within the customer's account which were viewed.
num_owned_internal_items_added	integer	The number of internal Google Drive items with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_internal_items_delta	integer
num_owned_internal_items_removed	integer
num_owned_items_added	integer	The number of Google Drive items with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_created	integer	The number of Google Drive items created on the day of this report for which the domain's user is the owner. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_items_delta	integer	The number of Google Drive items within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_edited	integer	The number of Google Drive items within the customer's account which were edited.
num_owned_items_removed	integer	The number of Google Drive items within the customer's account which were removed.
num_owned_items_trashed	integer	The number of Google Drive items within the customer's account which were trashed.
num_owned_items_viewed	integer	The number of Google Drive items within the customer's account which were viewed.
num_owned_items_with_visibility_anyone_in_domain_added	integer	The number of Google Drive items configured with a visibility of anyone_in_domain with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_anyone_in_domain_delta	integer	The number of Google Drive items configured with a visibility of anyone_in_domain within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_anyone_in_domain_removed	integer	The number of Google Drive items configured with a visibility of anyone_in_domain within the customer's account which were removed.
num_owned_items_with_visibility_anyone_in_domain_with_link_added	integer	The number of Google Drive items configured with a visibility of anyone_in_domain_with_link with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_anyone_in_domain_with_link_delta	integer	The number of Google Drive items configured with a visibility of anyone_in_domain_with_link within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_anyone_in_domain_with_link_removed	integer	The number of Google Drive items configured with a visibility of anyone_in_domain_with_link within the customer's account which were removed.
num_owned_items_with_visibility_anyone_with_link_added	integer	The number of Google Drive items configured with a visibility of anyone_with_link with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_anyone_with_link_delta	integer	The number of Google Drive items configured with a visibility of anyone_with_link within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_anyone_with_link_removed	integer	The number of Google Drive items configured with a visibility of anyone_with_link within the customer's account which were removed.
num_owned_items_with_visibility_private_added	integer	The number of Google Drive items configured with a visibility of private with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_private_delta	integer	The number of Google Drive items configured with a visibility of private within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_private_removed	integer	The number of Google Drive items configured with a visibility of private within the customer's account which were removed.
num_owned_items_with_visibility_public_added	integer	The number of Google Drive items configured with a visibility of public with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_public_delta	integer	The number of Google Drive items configured with a visibility of public within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_public_removed	integer	The number of Google Drive items configured with a visibility of public within the customer's account which were removed.
num_owned_items_with_visibility_shared_externally_added	integer	The number of Google Drive items configured with a visibility of shared_externally with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_shared_externally_delta	integer	The number of Google Drive items configured with a visibility of shared_externally within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_shared_externally_removed	integer	The number of Google Drive items configured with a visibility of shared_externally within the customer's account which were removed.
num_owned_items_with_visibility_shared_internally_added	integer	The number of Google Drive items configured with a visibility of shared_internally with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_items_with_visibility_shared_internally_delta	integer	The number of Google Drive items configured with a visibility of shared_internally within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_items_with_visibility_shared_internally_removed	integer	The number of Google Drive items configured with a visibility of shared_internally within the customer's account which were removed.
num_owned_items_with_visibility_unknown_added	integer
num_owned_items_with_visibility_unknown_delta	integer
num_owned_items_with_visibility_unknown_removed	integer
num_owned_other_types_added	integer	The number of any other Google Drive items with at least one "addition" type event performed on them, such as create, uploads, untrash events, or ownership transfer. This activity is reported regardless of the final state of the item.
num_owned_other_types_created	integer	The number of any other Google Drive items created by the user or domain. This does not track items that came into the customer's possession by way of untrashing, undeleting, or ownership transfer.
num_owned_other_types_delta	integer	The number of any other Google Drive items within the customer's account where ownership has changed, either to increase or decrease file ownership.
num_owned_other_types_edited	integer	The number of any other Google Drive items edited by the user or domain. Multiple edits of the same file are counted just once per file.
num_owned_other_types_removed	integer	The number of any other Google Drive items within the customer's account which were removed.
num_owned_other_types_trashed	integer	The number of any other Google Drive items within the customer's account which were trashed.
num_owned_other_types_viewed	integer	The number of any other Google Drive items within the customer's account which were viewed.
timestamp_last_active_usage	integer	Indicates the user's last active Google Drive use.