Google Drive Parameters

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

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

  • 操作者指标：对文件执行操作的人员。
  • 所有者指标：要执行操作的文件的所有者。 名称中包含 owned 的值是指所有者数据。

公开范围参数

参数可以为您网域中的项提供汇总的曝光度和所有权指标。这些参数分为以下三种常规形式，其中 * 将替换为下方公开范围表格中列出的任何字段：

num_owned_items_with_visibility_*_added
对其执行了至少 1 项 addition 类型事件（例如创建、上传、将内容移出回收站或转让所有权）的文档或云端硬盘内容。无论内容的最终状态如何，系统都会报告该活动。针对同一文件的多个 addition 事件不会增加计数。
num_owned_items_with_visibility_*_removed
对其执行了至少 1 项 removal 类型事件（例如移至回收站、永久删除或转移所有权）的 Google 文档或云端硬盘内容。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_*_delta
整个网域中用户拥有的 Google 文档和云端硬盘内容数量的净变化，按用户细分。例如，如果添加了一件商品，同时移除了另一件商品，添加和移除的商品对应的指标分别报告 1，但差异指标报告 0。

对于事件总计，每项仅有 1 个 addition 或 removal 事件会计入最终值。例如，如果某个文件先添加到云端硬盘，然后转移给其他所有者，这会触发两个 addition 事件和一个 removal 事件，但该文件的最终统计结果为一次添加和一次移除。

公开范围定义

下表按可见性从最低（私有）到最高（公开）的顺序列出了字段。

表格：公开范围级别
字段 定义
私享 文件不会与任何人共享。
shared_internally 文件仅与所有者网域内的用户/群组共享。
anyone_in_domain_with_link 文件会被共享，以便网域中知道链接的任何人都可以访问。
anyone_in_domain 文件处于共享状态，因此网域中的任何人都可以找到和访问该文件。
shared_externally 文件已共享，因此所有者网域外的用户/群组可以看到该文件。
anyone_with_link 文件处于共享状态，知道链接的任何人都可以访问。
公开 文件可供公开访问。

针对多个公开范围级别或事件的指标

在计算公开范围指标时，系统只会考虑任何给定文件的最高公开范围状态（即最公开的状态）。例如，假设以下共享设置应用于单个文件。虽然文件具有多个公开范围状态，但系统只会报告 public 公开范围状态。

公开范围状态示例
共享设置 公开范围状态
公开 public
已与网域中的少数用户共享 shared_internally
与网域外的特定用户共享 shared_externally
。

名称 类型 说明
num_1day_active_users integer 在指定报告日期执行了与 Google 云端硬盘中内容相关的活动的网域用户数。
num_1day_google_documents_active_users integer 在报告日期执行过 Google 文档活动的网域用户数。
num_1day_google_drawings_active_users integer 在报告日期执行过 Google 绘图活动的网域用户数。
num_1day_google_forms_active_users integer 在报告日期当天在 Google 表单上执行过活动的网域用户数。
num_1day_google_presentations_active_users integer 在报告日期执行过 Google 幻灯片活动的网域用户数。
num_1day_google_sites_active_users integer 在报告日期当天在 Google 协作平台上执行过活动的网域用户数。
num_1day_google_spreadsheets_active_users integer 在报告日期执行过 Google 表格活动的网域用户数。
num_1day_other_types_active_users integer 在报告日期执行了任何其他 Google 云端硬盘产品活动的网域用户数。
num_30day_active_users integer 过去 30 天内在 Google 云端硬盘中执行过与内容相关的活动的网域用户数。
num_30day_google_documents_active_users integer 过去 30 天内至少在 Google 文档中执行过一次活动的网域用户数。
num_30day_google_drawings_active_users integer 过去 30 天内至少在 Google 绘图中执行过 1 项活动的网域用户数。
num_30day_google_forms_active_users integer 过去 30 天内至少在 Google 表单中执行过一次活动的网域用户数。
num_30day_google_presentations_active_users integer 过去 30 天内至少在 Google 幻灯片中执行过一次活动的网域用户数。
num_30day_google_sites_active_users integer 过去 30 天内至少在 Google 协作平台上执行过 1 项活动的网域用户数。
num_30day_google_spreadsheets_active_users integer 过去 30 天内至少在 Google 表格上执行过一次活动的网域用户数。
num_30day_other_types_active_users integer 过去 30 天内至少在任何其他 Google 云端硬盘产品中执行过活动的网域用户数。
num_7day_active_users integer 过去 7 天内执行过与 Google 云端硬盘内容相关的活动的网域用户数。
num_7day_google_documents_active_users integer 过去 7 天内至少在 Google 文档中执行过 1 项活动的网域用户数。
num_7day_google_drawings_active_users integer 过去 7 天内至少在 Google 绘图中执行过 1 项活动的网域用户数。
num_7day_google_forms_active_users integer 过去 7 天内至少在 Google 表单中执行过 1 项活动的网域用户数。
num_7day_google_presentations_active_users integer 过去 7 天内至少在 Google 幻灯片中执行过 1 项活动的网域用户数。
num_7day_google_sites_active_users integer 过去 7 天内至少在 Google 协作平台上执行过 1 项活动的网域用户数。
num_7day_google_spreadsheets_active_users integer 过去 7 天内至少在 Google 表格中执行过 1 项活动的网域用户数。
num_7day_other_types_active_users integer 在过去 7 天内至少在任何其他 Google 云端硬盘产品中执行过一次活动的网域用户数。
num_collaborators integer 网域用户对文件进行编辑以及在文件中添加评论/建议/标记待办事项的次数，但仅限于他们不拥有的文件。
num_consumers integer 查看文件的网域用户数。不包括打印或预览。
num_creators integer 创建文件的网域用户数量。包括上传内容，但不包括其他添加类型事件，例如将内容移出回收站、撤消删除操作或转让所有权。
num_google_documents_created integer 用户或网域创建的 Google 文档数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_google_documents_edited integer 用户或网域编辑的 Google 文档数量。同一文件的多次修改只会计为 1 次。
num_google_documents_trashed integer 用户或网域回收的 Google 文档数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_google_documents_viewed integer 用户或网域查看的 Google 文档的数量。同一文件的多次观看只会计为一次。
num_google_drawings_created integer 用户或网域创建的 Google 绘图数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_google_drawings_edited integer 用户或网域编辑的 Google 绘图的数量。同一文件的多次修改只会计为 1 次。
num_google_drawings_trashed integer 用户或网域回收的 Google 绘图的数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_google_drawings_viewed integer 用户或网域查看的 Google 绘图的数量。同一文件的多次观看只会计为一次。
num_google_forms_created integer 用户或网域创建的 Google 表单数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_google_forms_edited integer 用户或网域编辑的 Google 表单的数量。同一文件的多次修改只会计为 1 次。
num_google_forms_trashed integer 用户或网域回收的 Google 表单的数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_google_forms_viewed integer 用户或网域查看的 Google 表单的数量。同一文件的多次观看只会计为一次。
num_google_presentations_created integer 用户或网域创建的 Google 演示文稿数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_google_presentations_edited integer 用户或网域编辑的 Google 演示文稿的数量。同一文件的多次修改只会计为 1 次。
num_google_presentations_trashed integer 用户或网域回收的 Google 演示文稿数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_google_presentations_viewed integer 用户或网域查看的 Google 演示文稿数量。同一文件的多次观看只会计为一次。
num_google_sites_created integer 用户或网域创建的 Google 协作平台网站数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_google_sites_edited integer 用户或网域编辑的 Google 协作平台网站的数量。同一文件的多次修改只会计为 1 次。
num_google_sites_trashed integer 用户或网域回收的 Google 协作平台网站数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_google_sites_viewed integer 用户或网域查看的 Google 协作平台网站数。同一文件的多次观看只会计为一次。
num_google_spreadsheets_created integer 用户或网域创建的 Google 电子表格数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_google_spreadsheets_edited integer 用户或网域编辑的 Google 电子表格的数量。同一文件的多次修改只会计为 1 次。
num_google_spreadsheets_trashed integer 用户或网域回收的 Google 表格数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_google_spreadsheets_viewed integer 用户或网域查看的 Google 电子表格的数量。同一文件的多次观看只会计为一次。
num_items_created integer 用户或网域创建的 Google 云端硬盘内容数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_items_edited integer 用户或网域编辑的 Google 云端硬盘内容的数量。同一文件的多次修改只会计为 1 次。
num_items_trashed integer 用户或网域回收的 Google 云端硬盘内容数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_items_viewed integer 用户或网域查看的 Google 云端硬盘内容数量。同一文件的多次观看只会计为一次。
num_monthly_active_users integer 月活跃用户数。
num_other_types_created integer 用户或网域创建的任何其他 Google 云端硬盘内容的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_other_types_edited integer 用户或网域编辑的任何其他 Google 云端硬盘内容的数量。同一文件的多次修改只会计为 1 次。
num_other_types_trashed integer 用户或网域回收的任何其他 Google 云端硬盘内容的数量。如果某项内容最初被移至回收站，但随后又被恢复，该内容仍会计入该指标。如果某项内容被移至回收站多次，则该指标中只会统计一次。
num_other_types_viewed integer 用户或网域查看的任何其他 Google 云端硬盘内容的数量。同一文件的多次观看只会计为一次。
num_owned_external_items_added integer 已添加到组织的 Google 云端硬盘外部内容的数量。
num_owned_external_items_delta integer
num_owned_external_items_removed integer
num_owned_google_documents_added integer 至少发生了 1 次“添加”类型事件（例如创建、上传、将文件移出回收站或转让文件所有权）的 Google 文档数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_google_documents_created integer 在生成此报告当天，网域用户创建且为其所有者的 Google 文档数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_google_documents_delta integer 客户账号中所有权发生更改（增加或减少文件所有权）的 Google 文档的数量。
num_owned_google_documents_edited integer 客户账号中已修改的 Google 文档的数量。
num_owned_google_documents_removed integer 客户账号中已移除的 Google 文档的数量。
num_owned_google_documents_trashed integer 客户账号中已移至回收站的 Google 文档数量。
num_owned_google_documents_viewed integer 客户账号中被查看的 Google 文档数量。
num_owned_google_drawings_added integer 至少发生过一次“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）的 Google 绘图的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_google_drawings_created integer 在生成此报告当天，网域用户创建的 Google 绘图的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_google_drawings_delta integer 客户账号中文件所有权发生变化（增加或减少文件所有权）的 Google 绘图的数量。
num_owned_google_drawings_edited integer 客户账号中已修改的 Google 文档的数量。
num_owned_google_drawings_removed integer 客户账号中被移除的 Google 绘图的数量。
num_owned_google_drawings_trashed integer 客户账号中已移至回收站的 Google 绘图的数量。
num_owned_google_drawings_viewed integer 客户账号中被查看的 Google 绘图的数量。
num_owned_google_forms_added integer 至少有 1 项“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）发生的 Google 表单数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_google_forms_created integer 在生成此报告当天，网域用户创建的 Google 表单的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_google_forms_delta integer 客户账号中文件所有权发生更改（增加或减少文件所有权）的 Google 表单数量。
num_owned_google_forms_edited integer 客户账号中已修改的 Google 文档的数量。
num_owned_google_forms_removed integer 客户账号中被移除的 Google 表单的数量。
num_owned_google_forms_trashed integer 客户账号中已移至回收站的 Google 表单的数量。
num_owned_google_forms_viewed integer 客户账号中被查看的 Google 表单数量。
num_owned_google_presentations_added integer 至少发生了 1 次“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）的 Google 演示文稿的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_google_presentations_created integer 在报告生成之日，由网域用户作为所有者创建的 Google 演示文稿的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_google_presentations_delta integer 客户账号中文件所有权发生变化（增加或减少文件所有权）的 Google 演示文稿的数量。
num_owned_google_presentations_edited integer 客户账号中已修改的 Google 演示文稿的数量。
num_owned_google_presentations_removed integer 客户账号中已移除的 Google 演示文稿的数量。
num_owned_google_presentations_trashed integer 客户账号中已移至回收站的 Google 演示文稿数量。
num_owned_google_presentations_viewed integer 客户账号中已被查看的 Google 演示文稿的数量。
num_owned_google_sites_added integer 在 Google 协作平台上执行了至少 1 项“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）的 Google 协作平台的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_google_sites_created integer 在生成此报告当天，由网域用户拥有且已创建的 Google 协作平台网站的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_google_sites_delta integer 客户账号中文件所有权发生变更（增加或减少文件所有权）的 Google 协作平台网站数量。
num_owned_google_sites_edited integer 客户账号中已修改的 Google 协作平台网站的数量。
num_owned_google_sites_removed integer 客户账号中被移除的 Google 网站的数量。
num_owned_google_sites_trashed integer 客户账号中已移至回收站的 Google 协作平台网站数量。
num_owned_google_sites_viewed integer 客户账号中被查看的 Google 协作平台网站数量。
num_owned_google_spreadsheets_added integer 至少发生过一次“添加”类型事件（例如创建、上传、将文件移出回收站或转让文件所有权）的 Google 表格数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_google_spreadsheets_created integer 在生成此报告当天，网域用户创建的 Google 表格数量（该用户为表格的所有者）。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_google_spreadsheets_delta integer 客户账号中所有权发生更改（增加或减少文件所有权）的 Google 表格的数量。
num_owned_google_spreadsheets_edited integer 客户账号中已修改的 Google 表格的数量。
num_owned_google_spreadsheets_removed integer 客户账号中已移除的 Google 表格数量。
num_owned_google_spreadsheets_trashed integer 客户账号中已移至回收站的 Google 表格数量。
num_owned_google_spreadsheets_viewed integer 客户账号中被查看的 Google 表格数量。
num_owned_internal_items_added integer 至少发生了 1 次“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）的内部 Google 云端硬盘内容数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_internal_items_delta integer
num_owned_internal_items_removed integer
num_owned_items_added integer 至少发生了 1 次“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）的 Google 云端硬盘内容数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_created integer 在报告生成之日，网域用户创建且为其所有者的 Google 云端硬盘内容的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_items_delta integer 客户账号中所有权发生更改（增加或减少文件所有权）的 Google 云端硬盘内容的数量。
num_owned_items_edited integer 客户账号中已修改的 Google 云端硬盘内容的数量。
num_owned_items_removed integer 客户账号中被移除的 Google 云端硬盘内容的数量。
num_owned_items_trashed integer 客户账号中已移至回收站的 Google 云端硬盘内容数量。
num_owned_items_viewed integer 客户账号中已查看的 Google 云端硬盘内容数量。
num_owned_items_with_visibility_anyone_in_domain_added integer 配置为公开范围为 anyone_in_domain 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_anyone_in_domain_delta integer 客户账号中配置为公开范围为 anyone_in_domain 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_anyone_in_domain_removed integer 客户账号中被移除且公开范围设为“anyone_in_domain”的 Google 云端硬盘内容的数量。
num_owned_items_with_visibility_anyone_in_domain_with_link_added integer 配置为公开范围为 anyone_in_domain_with_link 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_anyone_in_domain_with_link_delta integer 客户账号中配置为公开范围为 anyone_in_domain_with_link 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_anyone_in_domain_with_link_removed integer 客户账号中被移除且公开范围为 anyone_in_domain_with_link 的 Google 云端硬盘内容数量。
num_owned_items_with_visibility_anyone_with_link_added integer 配置为公开范围为 anyone_with_link 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_anyone_with_link_delta integer 客户账号中配置为公开范围为 anyone_with_link 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_anyone_with_link_removed integer 客户账号中被移除且公开范围设为 anyone_with_link 的 Google 云端硬盘内容的数量。
num_owned_items_with_visibility_private_added integer 配置为公开范围为 private 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_private_delta integer 客户账号中配置为公开范围为 private 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_private_removed integer 客户账号中被移除且公开范围为 private 的 Google 云端硬盘内容数量。
num_owned_items_with_visibility_public_added integer 配置为公开范围为 public 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_public_delta integer 客户账号中配置为公开范围为 public 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_public_removed integer 客户账号中被移除且公开范围设为 public 的 Google 云端硬盘内容的数量。
num_owned_items_with_visibility_shared_externally_added integer 配置为公开范围为 shared_externally 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_shared_externally_delta integer 客户账号中配置为公开范围为 shared_externally 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_shared_externally_removed integer 客户账号中被移除且公开范围为 shared_externally 的 Google 云端硬盘内容数量。
num_owned_items_with_visibility_shared_internally_added integer 配置为公开范围为 shared_internally 且至少发生了一次“添加”类型事件（例如创建、上传、将内容移出回收站或转移所有权）的 Google 云端硬盘内容的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_items_with_visibility_shared_internally_delta integer 客户账号中配置为公开范围为 shared_internally 的 Google 云端硬盘内容的数量。客户账号中的文件所有权发生了变化，即增加或减少了文件所有权。
num_owned_items_with_visibility_shared_internally_removed integer 客户账号中被移除且公开范围为 shared_internally 的 Google 云端硬盘内容数量。
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 在任何其他 Google 云端硬盘内容上执行了至少 1 项“添加”类型事件（例如创建、上传、将内容移出回收站或转让所有权）的数量。无论内容的最终状态如何，系统都会报告该活动。
num_owned_other_types_created integer 用户或网域创建的任何其他 Google 云端硬盘内容的数量。系统不会跟踪通过取消回收站、取消删除或所有权转移等方式转移到客户手中的项目。
num_owned_other_types_delta integer 客户账号中所有其他 Google 云端硬盘内容的数量，这些内容的所有权发生了变化，即文件所有权增加或减少。
num_owned_other_types_edited integer 用户或网域编辑的任何其他 Google 云端硬盘内容的数量。同一文件的多次修改只会计为 1 次。
num_owned_other_types_removed integer 客户账号中被移除的任何其他 Google 云端硬盘内容的数量。
num_owned_other_types_trashed integer 客户账号中已移至回收站的任何其他 Google 云端硬盘内容的数量。
num_owned_other_types_viewed integer 客户账号中被查看的任何其他 Google 云端硬盘内容的数量。
num_sharers integer 拥有 Google 云端硬盘内容非私享可见性的用户数。