将渠道服务数据导出到 BigQuery

注意： 此导出功能仅适用于 Google Cloud 和 Google Workspace 合作伙伴。

本页介绍了如何配置 Channel Services 导出，还介绍了可用于导出的架构。

借助 BigQuery，您可以将渠道服务结算数据导出到指定的 BigQuery 数据集。这些数据有助于您详细分析客户或渠道合作伙伴使用您所提供服务的方式。

从渠道服务导出的数据包含特定于转销商的数据，这些数据不会包含在 Cloud Billing 导出中。这类数据包括费用、赠金以及应用了配置的重新定价规则的使用情况数据。这些导出操作还会将客户父级结算账号的所有信息汇总到一个数据集中。

不过，渠道服务导出中的数据与 Cloud Billing 导出中的数据兼容，您可以使用查询联接这两个数据集以进行分析。

如需了解非经销商 Cloud Billing 导出，请参阅设置将 Cloud Billing 数据导出到 BigQuery 的功能。

准备工作

在开始导出渠道服务结算数据之前，您必须：

• 设置一个项目来托管您的 BigQuery 数据集，确保该项目已启用结算功能。
• 在项目中启用 BigQuery Data Transfer Service API。
• 为导出的数据创建数据集。

如果您已有一个项目和 BigQuery 数据集用于导出 Cloud Billing 数据，则可以将该项目和数据集重复用于导出渠道服务数据。

如需详细了解如何设置项目和数据集，请参阅设置将 Cloud Billing 数据导出到 BigQuery 的功能。

导出所需的权限

如需启用和配置渠道服务导出，您需要拥有以下角色：

• 对于 BigQuery，如果您创建了目标数据集，则需要对包含该数据集的项目拥有 BigQuery User。如果数据集是由其他人创建的，您需要拥有 BigQuery Data Owner 角色。

• 如需启用 Google Cloud 导出功能，您必须在 Partner Sales Console 中拥有 Google Cloud 转销商管理员角色。

  了解如何在 Partner Sales Console 中分配 Google Cloud 角色

• 如需启用 Google Workspace 导出功能，您必须是转销商管理员或拥有 Google Workspace 结算权限。

  了解如何在 Partner Sales Console 中分配 Google Workspace 角色

• （可选）包含目标 BigQuery 数据集的项目的 Project Viewer，用于自动检查项目是否已启用结算功能。

选择项目和数据集

在 Partner Sales Console 中，选择 BigQuery 中的项目和数据集，以存储 Channel Services 数据。为项目启用结算功能（如果尚未启用）。

选择或创建 BigQuery 数据集时，您可以为数据集选择一个受支持的 BigQuery 位置。首次为每个数据源（Google Cloud 或 Google Workspace）启用渠道服务数据导出功能时：

• 如果您将 BigQuery 数据集配置为使用多区域位置，则系统会从上月初开始提供每个所选数据源的 BigQuery 导出数据。例如，如果您在 9 月 23 日启用了 BigQuery 导出，则导出内容将包含从 8 月 1 日开始的数据。

• 如果您将 BigQuery 数据集配置为使用单区域位置（美国或欧盟多区域位置除外），则 BigQuery 导出数据自您启用导出之日起开始提供，并且适用于每个所选数据源。也就是说，系统不会针对非多区域数据集位置以追溯方式添加 BigQuery Export 数据，因此您不会看到启用导出之前的 BigQuery Export 数据。

注意： 对于线下订单结算导出（预览版），导出功能仅支持多区域数据集位置。

警告：如果合作伙伴停用 BigQuery 导出功能，之后又重新启用该功能，或者将导出数据集更改为其他 BigQuery 位置，那么在明确停用导出功能的这段时间，或者在上次导出与跨区域数据集更改发生之间，数据可能无法使用。在这些情况下，我们无法回填数据。

如需导出多个 Partner Sales Console 账号的结算数据，请按以下步骤操作：

1. 在您要将数据导出到的 BigQuery 数据集上，确保每个 Partner Sales Console 账号的结算管理员都有权查看该数据集。
2. 在每个 Partner Sales Console 账号中设置结算数据导出时，请选择统一的数据集。

支持的 BigQuery 位置

BigQuery 支持两种类型的区域。

多区域

下表列出了支持渠道服务 BigQuery 数据导出的多区域。

多区域说明	多区域名称
欧盟成员国（外部链接）的数据中心	EU
美国的数据中心	US

区域

下表列出了支持频道服务 BigQuery 数据导出的美洲区域。

区域说明	区域名称
爱荷华	us-central1
拉斯维加斯	us-west4
洛杉矶	us-west2
蒙特利尔	northamerica-northeast1
北弗吉尼亚	us-east4
俄勒冈	us-west1
盐湖城	us-west3
圣保罗	southamerica-east1
南卡罗来纳	us-east1

下表列出了支持 Channel Services BigQuery 数据导出的亚太区域。

区域说明	区域名称
香港	asia-east2
雅加达	asia-southeast2
孟买	asia-south1
大阪	asia-northeast2
首尔	asia-northeast3
新加坡	asia-southeast1
悉尼	australia-southeast1
台湾	asia-east1
东京	asia-northeast1

下表列出了支持将渠道服务 BigQuery 数据导出的欧洲区域。

区域说明	区域名称
比利时	europe-west1
芬兰	europe-north1
法兰克福	europe-west3
伦敦	europe-west2
荷兰	europe-west4
华沙	europe-central2
苏黎世	europe-west6

启用导出功能

在启用数据导出之前，请记下您的完全限定数据集 ID，其格式为 PROJECT_ID:DATASET_NAME。

注意 ：如果您之前未在项目中启用结算功能，BigQuery 可能会在沙盒模式下运行，这可能会导致导出行为异常。了解如何从 BigQuery 沙盒升级。

如需启用渠道服务导出功能，请执行以下操作：

1. 在 Partner Sales Console 中，打开结算页面。
2. 选择结算数据导出。
3. 在重新结算数据集字段中输入完全限定的数据集 ID。
4. 选择要导出哪些数据源的数据。
5. 点击更新。如果您看到更新数据集权限的提示，请点击更新。

设置完成后，结算导出功能会每天提供增量使用情况数据。只有在您的账号首次运行结算信息导出功能后，导出表格才会显示出来。相应数据集包含自首次配置为保留数据以来的数据。

警告：请勿修改导出的数据表。

修改这些表可能会导致数据导出停止。在您还原所做更改或删除表之前，手动添加的数据会丢失。如果您想混合使用之前导出到 BigQuery 的 Cloud Billing 数据，建议您将数据保存在单独的表中，并改为使用UNION查询。

如需停止将重新结算费用数据导出到数据集，请在客户重新结算页面上点击停用结算数据导出。如需重新启用导出功能，请按照上述步骤指定数据集 ID。

在该功能停用期间，您可能无法查看重新结算费用数据。如果您在该时间段内删除了任何已导出的数据，系统将无法回填已删除的记录。

所需的服务账号权限

渠道服务数据导出功能使用由 Google 拥有和管理的服务账号，该账号有权将结算记录写入表中。服务账号为：

[e-mail]

此服务账号需要具有预定义角色：roles/bigquery.dataEditor，才能允许导出。您可以按照启用导出的步骤配置权限。

警告：如果在启用将结算数据导出到 BigQuery 的功能后移除此服务账号，可能会导致数据丢失。

如果您移除了该服务账号，则必须重新添加该服务账号，或在结算数据导出页面上点击更新按钮，重新配置数据集权限。如果您移除已导出的数据，或者将导出重定向到其他数据集，我们就无法回填已删除或已导出的记录。

高效查询数据

默认情况下，BigQuery 表按 export_time 分区，并按 payer_billing_account_id 聚簇。这意味着，表被划分为较小的分区，每个分区又进一步划分为较小的聚类。 在查询中使用分区键和聚簇键有助于 BigQuery 快速找到相关数据，从而显著降低查询费用。

例如，与不含分区键和聚类键的查询相比，以下查询的效率更高：

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

如需详细了解分区、聚簇和最佳实践，请参阅以下链接：

1. 查询分区表
2. 查询聚簇表
3. 优化查询计算
4. 控制 BigQuery 费用的最佳实践

查找付款人的结算账号 ID

如需查找付款人的结算账号 ID，请打开 Partner Sales Console 的结算账号页面，然后点击合作伙伴结算标签页。

您可以查看所有结算账号和付款人结算账号 ID。

为导出数据集中的其他用户设置访问权限控制

您可以通过多种方式为 BigQuery 导出中的数据设置访问权限控制。如需了解详情，请参阅 BigQuery 访问权限控制。

为确保用户只能访问他们有权查看的数据，我们建议您设置已获授权的视图，以便共享导出数据集中的数据。

注意： 请勿对数据集使用行级或列级访问权限控制。启用这些访问权限控制功能会导致结算数据导出失败。

对于持续数据导出，在为用户设置权限时，请确保服务账号 [e-mail] 始终对导出数据集拥有完整的编辑者访问权限。

表架构

警告：尝试自行修改导出架构可能会导致数据不再导出。如果您想添加或移除列，可以创建视图或具体化视图，也可以在查询中与其他表进行联接。

如果您的表格处于此状态，您必须将其恢复为仅包含所有正确的列。之后，您可能需要前往账单导出页面，然后点击更新。

以下架构描述了 BigQuery 表中的数据。

在 BigQuery 数据集中，详细重新结算费用导出数据会加载到名为 reseller_billing_detailed_export_v1 的数据表中。

字段	类型	说明
billing_account_id	字符串	与使用情况关联的账号 ID，可能是客户的账号 ID，也可能是您的账号 ID。根据产品系列的不同，这可能是结算账号或 Cloud Identity。
payer_billing_account_id	字符串	父级结算账号的 ID。
invoice.month	字符串	包含费用专列项的账单的年份和月份 (YYYYMM)。 例如：“202101”相当于 2021 年 1 月。
cost_type	字符串	相应专列项代表的费用类型：常规费用、税费、调整项或舍入误差。
service.id	字符串	与使用量关联的服务的 ID。
service.description	字符串	报告结算数据的 Google 服务。
sku.id	字符串	服务使用的资源的 SKU ID。
sku.description	字符串	服务使用的资源类型的说明。 例如，Cloud Storage 的类型为“Standard Storage US”。
usage_start_time	时间戳	计算出的费用的每小时使用时间段的开始时间。所有服务的使用情况和费用按小时显示。长时间运行的服务的使用情况横跨多个每小时时间段。对于订阅产品，此字段为结算月的开始时间。
usage_end_time	时间戳	计算出的费用的每小时使用时间段的结束时间。所有服务的使用情况和费用按小时显示。长时间运行的服务的使用情况横跨多个每小时时间段。对于订阅产品，此字段为结算月的结束时间。
project	结构体	生成 Cloud Billing 数据的 Google Cloud 项目的相关信息。
project.number	字符串	为生成 Cloud Billing 数据的 Google Cloud 项目内部生成的匿名化唯一标识符。
project.id	字符串	生成 Cloud Billing 数据的 Google Cloud 项目的 ID。
project.name	字符串	生成 Cloud Billing 数据的 Google Cloud 项目的名称。
project.labels	Struct，重复
project.labels.key	字符串	如果存在标签，则为键值对的键部分。
project.labels.value	字符串	如果存在标签，则为键值对的值部分。
project.ancestry_numbers	字符串	由 project.id 标识的项目的资源层次结构祖先。
labels	Struct，重复
labels.key	字符串	如果存在标签，则为键值对的键部分。
labels.value	字符串	如果存在标签，则为键值对的值部分。
system_labels	Struct，重复
system_labels.key	字符串	如果存在系统标签，则为键值对中的“键”部分。
system_labels.value	字符串	如果存在系统标签，则为键值对中的“值”部分。
location.location	字符串	国家/地区、区域或可用区层级的使用位置。对于没有特定位置的资源，显示 global。如需了解详情，请参阅地区和可用区。
location.country	字符串	当 location.location 是国家/地区、区域或可用区时，此字段是发生了使用的国家/地区。例如 US。如需了解详情，请参阅地区和可用区。
location.region	字符串	当 location.location 是国家或区域时，此字段是发生了使用的区域。例如 us-central1。如需了解详情，请参阅地区和可用区。
location.zone	字符串	当 location.location 是可用区时，此字段是发生了使用的可用区。例如 us-central1-a。如需了解详情，请参阅地区和可用区。
resource	结构体	描述与产生服务用量的服务资源（例如虚拟机或 SSD）相关的信息的结构和值。
resource.name	字符串	生成相关用量的资源的特定于服务的标识符。可以是用户生成的内容。
resource.global_name	字符串	产生相关用量的资源的全局唯一服务标识符。
cost	数字	适用使用模式下的费用，包括与您的 Cloud Billing 账号相关联的合同中的自定义价格所反映的任何协商折扣（如适用）。
currency	字符串	费用的结算币种。如需了解详情，请参阅结算和付款支持的本地货币。
currency_conversion_rate	浮点数	美元兑本地货币的汇率。也就是说，cost ÷ currency_conversion_rate 得出以美元为单位的费用。
usage.amount	数字	所用 usage.unit 的数量。
usage.unit	字符串	用于衡量资源用量的基本单位。例如，标准存储空间的基本单位是“字节/秒”。
usage.amount_in_pricing_unit	数字	usage.pricing_unit 的使用量。
usage.pricing_unit	字符串	用于衡量资源用量的单位。
credits	Struct，重复	包含描述赠金结构和值的字段。
credits.id	字符串	如果已填充，则表示赠金与产品 SKU 相关联。
credits.full_name	字符串	与产品 SKU 关联的赠金的名称。
credits.type	字符串	此字段说明 credits.id 的用途或来源。
credits.name	字符串	对使用量应用的赠金的说明。
credits.amount	数字	对使用量应用的赠金金额。
credits.channel_partner_amount	数字	重新结算加价和折扣后，应用到相应使用量的赠金金额。基于 channel_partner_name 和关联的 ChannelPartnerRepricingConfig。如果 credits.type 为 RESELLER_MARGIN，则此金额将为零。
credits.customer_amount	数字	重新结算加价和折扣后，应用到相应使用量的赠金金额。基于 customer_name 和关联的 CustomerRepricingConfig。如果 credits.type 为 RESELLER_MARGIN，则此金额将为零。
adjustmentsInfo	Struct，重复	包含一些字段，用于说明费用专列项的调整项的结构和值。
adjustmentsInfo.adjustment_id	字符串	如果填充了值，则表示调整项与费用专列项相关联。adjustmentsInfo.adjustments_id 是某个问题导致的所有调整项的唯一 ID。
adjustmentsInfo.adjustment_description	字符串	调整项及其原因的说明。
adjustmentsInfo.adjustment_type	字符串	调整的类型。
adjustmentsInfo.adjustment_mode	字符串	发出调整项的方式。
export_time	时间戳	与附加结算数据关联的处理时间。每次导出新数据时，该值都会增加。使用 export_time 列可以了解导出的结算数据的上次更新时间。
entitlement_name	字符串	Cloud Channel API 使用权的资源名称。使用以下格式：accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name	字符串	（仅限分销商）向最终客户进行销售的渠道合作伙伴的资源名称。使用以下格式：accounts/{account}/channelPartnerLinks/{channelPartner}。
channel_partner_cost	数字	（仅限发行商）在应用现有 ChannelPartnerRepricingConfig 后，由 channel_partner_name 标识的渠道合作伙伴的费用。
customer_name	字符串	消耗此使用量的转销商客户的资源名称，格式为：accounts/{account}/customers/{customer}
customer_cost	数字	在应用 CustomerRepricingConfig（如有）后，由 customer_name 列标识的转销商客户的费用。
cost_at_list	数字	按默认使用模式计算的定价费用。
customer_repricing_config_name	字符串	Cloud Channel API CustomerRepricingConfig 的资源名称。使用以下格式：accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}。 注意：对于 Google Cloud，生成拥有此字段的数据的第一个整月是 2023 年 1 月。如果 Cloud Marketplace 非公开优惠配置了重新定价，则此字段为 `NULL`。
channel_partner_repricing_config_name	字符串	（仅限分销商）Cloud Channel API ChannelPartnerRepricingConfig 的资源名称。使用以下格式：accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}。 注意：对于 Google Cloud，包含此字段的第一个整月数据是 2023 年 1 月。
tags	结构体	描述标记的字段，例如键、值和命名空间。 注意：对于 Google Cloud，生成拥有这些标记的数据的第一个整月是 2023 年 1 月。
tags.key	字符串	与此特定标记关联的键的简称或显示名。
tags.value	字符串	附加到标记键的资源。在任何给定时间，对于给定键，一个资源只能附加一个值。
tags.inherited	布尔值	指示标记绑定是继承的（继承的标记 = True）还是直接的/非继承的（继承的标记 = False）。
tags.namespace	字符串	表示定义标记键和值的资源层次结构。命名空间可以与标记键和标记值简称组合使用，以为标记键或标记值创建全局唯一的完全限定名称。
customer_correlation_id	字符串	客户的外部 CRM ID。仅当相应客户存在 CRM ID 时才会填充。 注意：对于 Google Cloud，包含此字段的第一个整月数据是 2023 年 3 月。
price	结构体	描述与支付的使用费相关的结构和值的字段。 注意：对于 Google Cloud，包含价格字段的第一个整月数据是 2023 年 5 月。
price.effective_price	数字	适用使用模式下基于与您的 Cloud Billing 账号相关联的合同中的自定义价格（如果适用）的 SKU 价格，其中包含任何商定的折扣。
price.tier_start_amount	数字	相应 SKU 价格层级的下限单位数。如需了解详情，请参阅价格层级简介。
price.unit	字符串	指定价格和衡量资源用量所依据的使用单位。
price.pricing_unit_quantity	数字	SKU 价格层级的下限单位数。如需了解详情，请参阅价格层级简介。
price.list_price	数字	默认使用模式下的 SKU 定价。
price.effective_price_default	数字	默认使用模式下的 SKU 价格，包括与您的 Cloud Billing 账号相关联的合同中的自定义价格所反映的任何协商折扣（如果适用）。
price.list_price_consumption_model	数字	在与您的 Cloud Billing 账号相关联的合同中的自定义价格反映任何协商折扣之前，SKU 的适用使用模式下的定价（如果适用）。
transaction_type	字符串	卖家的交易类型。交易类型可能是以下各项之一： GOOGLE = 1： Google Cloud出售的服务。 THIRD_PARTY_RESELLER = 2： Google Cloud转售的第三方服务。 THIRD_PARTY_AGENCY = 3：合作伙伴出售的第三方服务，由 Google Cloud 充当代理商。 注意：对于 Google Cloud，包含此字段的第一个整月数据是 2023 年 8 月。
seller_name	字符串	卖家的法定名称。 注意：对于 Google Cloud，生成拥有此字段的数据的第一个整月是 2023 年 8 月。
subscription	结构体	描述基于支出或基于资源的承诺的字段。您可以使用这些字段来分析特定承诺的费用。
subscription.instance_id	字符串	与承诺相关联的订阅 ID。 注意：对于 Google Cloud，包含价格字段的第一个整月数据是 2024 年 2 月。
cost_at_effective_price_default	数字	默认使用模式下的费用，包括与您的 Cloud Billing 账号相关联的合同中的自定义价格所反映的任何协议折扣（如果适用）。
cost_at_list_consumption_model	数字	适用使用模式下的费用，不含与您的 Cloud Billing 账号相关联的合同中的自定义价格所反映的任何协商折扣（如果适用）。
consumption_model	结构体	用于描述适用使用模式的字段。
consumption_model.id	字符串	使用模式的 ID。
consumption_model.description	字符串	使用模式的说明。

有关架构的其他说明

以下是关于架构的一些其他说明。

不适用于 Google Workspace 的列

如果某列或某字段不适用于某个产品系列，则该产品系列的导出数据中相应字段会包含 null。以下字段不适用于 Google Workspace 导出：

• project
• labels
• resource
• credits
• adjustmentsInfo
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

不适用于 Google Workspace 使用型 SKU 的列

如果某列或某字段不适用于某个产品系列，则该产品系列的导出数据中相应字段会包含 null。以下字段不适用于 Google Workspace 导出：

• service.id
• sku.id
• project
• labels
• resource
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name
• subscription

不适用于线下订单的列（预览版）

如果某个列或字段不适用于某个产品系列，则该产品系列的导出数据中相应列或字段会包含 null。以下列或字段不适用于线下订单账单导出：

• project
• labels
• system_labels
• location
• resource
• credits
• entitlement_name
• channel_partner_name
• channel_partner_cost
• customer_name
• customer_cost
• cost_at_list
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

有关 Google Workspace 导出功能的其他注意事项

Google Workspace 导出功能有以下几种特殊行为：

• Google Workspace 数据不包含经销商自己的使用情况。
• 当 cost_type 为 tax 和 adjustment 时，usage.amount_in_pricing_units 始终为 1。
• 在 Google Workspace 账单上，税费会显示为一个订单项。在导出文件中，税费按客户细分。虽然总税额应与账单一致，但个别税额可能存在细微的四舍五入误差。

billing_account_id

• 对于 Google Cloud，这是与用量相关联的 Cloud Billing 账号。
• 对于 Google Workspace，这是客户的 Cloud Identity。
• 对于线下订单，这是客户的姓名。

“service”和“sku”

对于 Google Workspace，这些列表示与使用情况相关的“产品”和“SKU”。详细了解商品 ID 和 SKU ID。 。

对于 Google Workspace 消费型 SKU（Google Voice 和云端硬盘），sku.id 和 service.id 列包含 null。

注意： 对于旧版 Google 云端硬盘 SKU，sku.description 可能与账单 CSV 中的“订阅”列不一致（例如，CSV 显示“Google 云端硬盘存储空间 20 GB”，但 sku.description 显示 20 GB）。对于旧版 Google 云端硬盘 SKU，这是正常现象。您可以在 Partner Sales Console 中找到此值。前往特定客户，点击旧版订阅，然后点击“查看付款方案”。然后，您应该会看到与 sku.description 对应的值。

“usage_start_time”和“usage_end_time”

在 Google Workspace 账单 CSV 中，此数据以日期表示。在导出数据中，这些时间会以时间戳的形式表示：

• 对于 usage_start_time，这是订阅的开始时间（含），即开始日期当天 0:00（太平洋标准时间）。
• 对于 usage_end_time，这是订阅的结束时间（不含），即结束日期后一天的 0:00（美国太平洋标准时间）。

project.labels

对于 Google Cloud，这些是发生使用情况的Google Cloud 项目中的键值对。如需了解详情，请参阅使用标签。

labels

对于 Google Cloud，这些是发生使用量的 Google Cloud资源中的键值对。如需了解详情，请参阅使用标签。

system_labels

• 对于 Google Cloud，这些是发生使用量的Google Cloud 资源中的键值对。如需了解详情，请参阅可用的系统标签。

• 对于 Google Workspace，这些是与费用相关的其他元数据，包括：

  • workspace.googleapis.com/domain_name：客户的域名。
  • workspace.googleapis.com/order_id：订单 ID。
  • workspace.googleapis.com/purchase_order_id：采购订单 (PO) ID。
  • workspace.googleapis.com/subscription_id：订阅 ID。
  • workspace.googleapis.com/usage_type：使用类型。如果 cost_type 不是 regular，则不适用。

注意： 对于 Google Workspace 消费型 SKU（Google Voice 和云端硬盘），系统只会填充 workspace.googleapis.com/domain_name 和 workspace.googleapis.com/subscription_id。

Google Workspace 用量类型包括：

• COMMITMENT_TERM_START_ITEM：订阅开始时间。通常与按月结算的合约期订阅的部分月份以及预付费订阅的结算期或合约期相关联。
• COMMITMENT_TERM_END_ITEM：订阅结束。通常与按月结算的承诺订阅的最后一个月费用相关联。
• COMMITMENT_TERM_RENEWAL_ITEM：后续订阅周期的开始时间。
• COMMITMENT_MONTHLY_ITEM：在月初时已存在的承诺的记录使用量。在大多数情况下，相应费用将涵盖整个月。
• COMMITMENT_SEATS_CHANGE_ITEM：在承诺级别发生变化（增加或减少）时记录。通常从月中开始，对于按月结算的合约型订阅，会持续到月底；对于预付费订阅，会持续到结算期或合约期结束。
• COMMITMENT_CANCEL_ITEM：在订阅取消时记录。 包括与提前终止相关的费用。表示合同在中间取消时剩余合同期限的费用，或合同在中间更改或取消时剩余结算周期的赠金。
• FLEXIBLE_SEATS_ITEM：记录了在连续若干天内，若干用户的用量。仅适用于无合约的用户。
• COUPON_DISCOUNT_ITEM：与优惠券关联的折扣金额。
• MIGRATED_CREDIT_ITEM：Postini 迁移带来的积分。
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM：表示在结算周期开始时为整个周期创建的使用情况信息（针对承诺预付款订阅）。

usage.amount

对于 Google Workspace 基于席位的使用量，此字段表示付费席位。例如，购买承诺的承诺席位数，或弹性方案的付费席位数。

对于 Google Workspace 消耗性 SKU（Google Voice 和云端硬盘），这是已使用的分钟数。

usage.pricing_unit

• 对于 Google Cloud，请详细了解 Cloud Billing Catalog API{: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• 对于 Google Workspace，此值为 count。

credits.id

对于 Google Cloud，此值可以是字母数字的唯一标识符 (12-b34-c56-d78)，也可以是赠金类型说明（承诺使用折扣：CPU）。如果 credits.id 字段为空，则表示相应产品 SKU 未与任何赠金相关联。

credits.full_name

对于 Google Cloud，此字段是对以字母数字表示的 credits.id 用户可理解的说明。示例包括：免费试用赠金或基于支出的承诺使用折扣。credits.full_name 值仅适用于具有字母数字 credits.id 的 SKU。如果 credits.id 的值是赠金类型（例如承诺使用折扣：CPU）的说明，则 credits.full_name 字段将为空。

credits.type

对于 Google Cloud，赠金类型包括：

• COMMITTED_USAGE_DISCOUNT：为 Compute Engine 购买的基于资源的承诺使用合约，以获得大幅度的虚拟机使用费折扣。
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE：为服务购买的基于支出的承诺使用合约，旨在换取您的最低消费额承诺。
• DISCOUNT：折扣赠金类型用于达到合同支出阈值后获得的赠金。请注意，在 Partner Sales Console 提供的 Cloud Billing 报告中，折扣赠金类型被列为“基于支出的折扣（按合同规定）”。
• FREE_TIER：某些服务允许在指定限额内免费使用资源。对于这些服务，赠金用于实现免费层级使用量。
• PROMOTION：促销赠金类型包括Google Cloud 免费试用和营销活动赠金，或其他 Google Cloud用量补贴。 在适用情况下，促销赠金会被视为一种付款方式，并会自动应用以减少您的账单总额。
• RESELLER_MARGIN：如果您是转销商，转销商利润赠金类型表示每个符合条件的专列项获得的转销商计划折扣。
• SUBSCRIPTION_BENEFIT：通过购买服务的长期订阅以换取折扣而获得的赠金。
• SUSTAINED_USAGE_DISCOUNT：持续使用折扣赠金类型是因在结算月份的大部分时间内运行特定 Compute Engine 资源而获得的自动折扣。

adjustmentsInfo

对于 Google Cloud，仅当为 Cloud Billing 修改生成了费用专列项时，系统才会填充这些值。adjustmentsInfo 类型包含调整项的详细信息，无论调整项是出于更正错误还是其他原因发出。

adjustmentsInfo.adjustment_type

对于 Google Cloud，这包括：

• USAGE_CORRECTION：错误报告的使用量导致的更正。
• PRICE_CORRECTION：错误的定价规则导致的更正。
• METADATA_CORRECTION：为修复元数据进行的更正，不更改费用。
• GOODWILL：出于善意向客户发放的赠金。
• SALES_BASED_GOODWILL：作为合同的一部分，出于善意向客户发放的赠金。
• SLA_VIOLATION：由于服务等级目标 (SLO) 违规而向客户发放的赠金。
• BALANCE_TRANSFER：将资金从一个付款账号转移到另一个付款账号的调整项。
• ACCOUNT_CLOSURE：将已关闭账号的余额变为零的调整项。
• GENERAL_ADJUSTMENT：常规的 Cloud Billing 账号修改。

adjustmentsInfo.adjustment_mode

对于 Google Cloud，这包括：

• PARTIAL_CORRECTION：更正部分取消原始使用量和费用。
• COMPLETE_NEGATION_WITH_REMONETIZATION：更正完全取消原始使用量和费用，并使用更新后的使用量和费用发出更正后的专列项。
• COMPLETE_NEGATION：更正完全取消原始使用量和费用，并且不再重新计算使用量的费用。
• MANUAL_ADJUSTMENT：手动将调整项分配给费用和使用量。

price.effective_price

对于 Google Cloud，这是使用Google Cloud 或 Google Maps Platform SKU 和 SKU 价格层级所产生的费用。 如果您的 Cloud Billing 账号具有自定义的合同价格，则此价格是您的 Cloud Billing 账号专享的。否则，这是相应 SKU 或 SKU 层级的定价。