Google Drive Parameters

本文档列出了各种类型的 Google 云端硬盘活动事件的参数。您可以通过使用 parameters=drive:PARAMETER 调用 CustomerUsageReports.get() 来检索这些事件。

报告数据可以分为从演员或所有者的角度来看的数字。

  • 操作者指标 - 对文件执行操作的人员。
  • 所有者指标 - 正在处理的文件的所有者。 名称中包含 owned 的值是指所有者数据。

曝光度参数

参数可以提供您网域内商品的汇总曝光度和所有权指标。这些参数一般有三种形式，其中 * 会替换为下方的公开程度表格中列出的任何字段：

num_owned_items_with_visibility_*_added
至少发生过一次 addition 类型事件的文档或云端硬盘内容，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。针对同一文件的多个 addition 事件不会增加计数。
num_owned_items_with_visibility_*_removed
至少发生过一次 removal 类型事件的文档或云端硬盘项目，例如放入回收站、永久删除或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_*_delta
整个网域中用户拥有的 Google 文档和云端硬盘项目的数量净变化。例如，如果添加了一项指标并移除了另一项指标，则添加的指标和移除的指标各自报告 1，但增量指标报告 0。

对于事件总数，每个商品只有一次 addition 或 removal 事件计入最终价值。例如，如果某个文件先添加到云端硬盘，然后转移给其他所有者，则会触发两次 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_1day_active_users 整数 在指定报告日期，执行了与 Google 云端硬盘中的内容相关的活动的网域用户数量。
num_1day_google_documents_active_users 整数 在相应报告日期，在 Google 文档中执行过活动的用户数。
num_1day_google_drawings_active_users 整数 在相应报告日期，在 Google 绘图上执行过活动的用户数。
num_1day_google_forms_active_users 整数 在相应报告日期，在 Google 表单中执行过活动的用户网域用户数量。
num_1day_google_presentations_active_users 整数 在相应报告日期，在 Google 演示上执行过活动的用户数量。
num_1day_google_sites_active_users 整数 在相应报告日期，在 Google 协作平台上执行过活动的用户数。
num_1day_google_spreadsheets_active_users 整数 在相应报告日期，在 Google 表格中执行过活动的网域用户数量。
num_1day_other_types_active_users 整数 在报告日期当天，在任何其他 Google 云端硬盘产品中执行过活动的用户数量。
num_30day_active_users 整数 过去 30 天内在 Google 云端硬盘中执行过与内容相关的活动的网域用户数。
num_30day_google_documents_active_users 整数 过去 30 天内至少在 Google 文档中执行过一次活动的网域用户数。
num_30day_google_drawings_active_users 整数 过去 30 天内至少在 Google 绘图上执行过一次操作的网域用户数。
num_30day_google_forms_active_users 整数 过去 30 天内至少在 Google 表单上执行过一次操作的网域用户数。
num_30day_google_presentations_active_users 整数 过去 30 天内至少在 Google 演示上执行过一次操作的网域用户数。
num_30day_google_sites_active_users 整数 过去 30 天内至少在 Google 协作平台上执行过一次操作的网域用户数。
num_30day_google_spreadsheets_active_users 整数 过去 30 天内至少在 Google 表格中执行过一次活动的网域用户数。
num_30day_other_types_active_users 整数 过去 30 天内至少在任何其他 Google 云端硬盘产品上执行过活动的用户数量。
num_7day_active_users 整数 过去 7 天内在 Google 云端硬盘中执行过与内容相关的活动的网域用户数。
num_7day_google_documents_active_users 整数 过去 7 天内至少在 Google 文档中执行过一次操作的网域用户数。
num_7day_google_drawings_active_users 整数 过去 7 天内至少在 Google 绘图上执行过一次操作的网域用户数。
num_7day_google_forms_active_users 整数 过去 7 天内至少在 Google 表单上执行过一次操作的网域用户数。
num_7day_google_presentations_active_users 整数 过去 7 天内至少在 Google 演示上执行过一次操作的网域用户数。
num_7day_google_sites_active_users 整数 过去 7 天内至少在 Google 协作平台上执行过一次操作的网域用户数。
num_7day_google_spreadsheets_active_users 整数 过去 7 天内至少在 Google 电子表格中执行过一次操作的网域用户数。
num_7day_other_types_active_users 整数 在过去 7 天内至少使用过一次任何其他 Google 云端硬盘产品的网域用户数。
num_collaborators 整数 编辑文件、在文件中添加评论/建议/待办事项的网域用户数，但仅限于他们不拥有的文件。
num_consumers 整数 网域内查看文件的用户数量。这不包括打印或预览。
num_creators 整数 创建文件的网域用户数量。包括上传内容，但不包括其他“添加”类型的事件，例如将文件移出回收站、取消删除文件或转移所有权。
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 表单的数量。同一文件的多次编辑仅计为一次。
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_monthly_active_users 整数 月活跃用户数。
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 表单的数量。
num_owned_google_forms_edited 整数 客户账号中已编辑的 Google 文档数量。
num_owned_google_forms_removed 整数 客户账号中被移除的 Google 表单的数量。
num_owned_google_forms_trashed 整数 客户账号中被放入回收站的 Google 表单的数量。
num_owned_google_forms_viewed 整数 客户账号中被查看的 Google 表单的数量。
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 整数 配置为公开范围为 anyone_in_domain 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_anyone_in_domain_delta 整数 客户账号中配置为“anyone_in_domain”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_anyone_in_domain_removed 整数 客户账号中配置为公开anyone_in_domain的 Google 云端硬盘内容被移除的数量。
num_owned_items_with_visibility_anyone_in_domain_with_link_added 整数 配置为公开范围为 anyone_in_domain_with_link 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_anyone_in_domain_with_link_delta 整数 客户账号中配置为“anyone_in_domain_with_link”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_anyone_in_domain_with_link_removed 整数 客户账号中配置为公开anyone_in_domain_with_link的 Google 云端硬盘内容被移除的数量。
num_owned_items_with_visibility_anyone_with_link_added 整数 配置为公开范围为 anyone_with_link 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_anyone_with_link_delta 整数 客户账号中配置为“anyone_with_link”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_anyone_with_link_removed 整数 客户账号中配置为公开anyone_with_link的 Google 云端硬盘内容被移除的数量。
num_owned_items_with_visibility_private_added 整数 配置为公开范围为 private 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_private_delta 整数 客户账号中配置为“private”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_private_removed 整数 客户账号中配置为公开private的 Google 云端硬盘内容被移除的数量。
num_owned_items_with_visibility_public_added 整数 配置为公开范围为 public 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_public_delta 整数 客户账号中配置为“public”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_public_removed 整数 客户账号中配置为公开public的 Google 云端硬盘内容被移除的数量。
num_owned_items_with_visibility_shared_externally_added 整数 配置为公开范围为 shared_externally 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_shared_externally_delta 整数 客户账号中配置为“shared_externally”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_shared_externally_removed 整数 客户账号中配置为公开shared_externally的 Google 云端硬盘内容被移除的数量。
num_owned_items_with_visibility_shared_internally_added 整数 配置为公开范围为 shared_internally 的 Google 云端硬盘内容数量，这些内容至少发生过一次“添加”类型的事件，例如创建、上传、移出回收站事件或所有权转移。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_shared_internally_delta 整数 客户账号中配置为“shared_internally”公开范围且所有权发生变更（无论是增加还是减少文件所有权）的 Google 云端硬盘项目数。
num_owned_items_with_visibility_shared_internally_removed 整数 客户账号中配置为公开shared_internally的 Google 云端硬盘内容被移除的数量。
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 云端硬盘内容的数量。
num_sharers 整数 Google 云端硬盘中某个项目的非私密可见性用户数。