关于使用情况报告

使用情况报告提供了关于你帐户的 GitHub 使用情况的详细信息，包括每种 SKU 的使用情况及相应的可计费金额。

要生成使用情况报告，请参阅“收集有关支出的见解”。

使用情况报告类型

汇总报告

汇总使用情况报告会根据以下值的组合对 quantity、gross_amount、discount_amount 和 net_amount 字段进行求和：date、sku、repository、cost_center_name。 如果使用情况报告适用于具有组织的企业，则金额也将按组织价值进行汇总。

可以请求最长期限为一年的汇总报告。

详细报告

详细使用情况报告包含与汇总报告相同的字段，并添加 username 和 workflow_path。

详细使用情况报告会根据以下值的组合对 quantity、gross_amount、discount_amount 和 net_amount 字段进行求和：date、sku、organization、repository、cost_center_name、username、workflow_path。

可以请求最长期限为 31 天的详细报告。

使用情况报告字段

使用情况报告包含以下字段。

字段	说明
date	使用日期。 所有使用情况均以 UTC 格式记录。
product	已使用的 GitHub 产品。
sku	已使用的特定 GitHub 产品 SKU。
quantity	已使用的 SKU 的数量。
unit_type	产品 SKU 的度量单位。
applied_cost_per_quantity	产品 SKU 的单位成本。
gross_amount	已使用的产品 SKU 的数量。
discount_amount	获得折扣的使用量。 作为帐户包含的使用情况的一部分而享受折扣的使用情况将显示在此字段中。 还包括 GitHub Actions 在公共仓库中使用标准 GitHub 托管运行器以及使用自托管运行器时所享受的折扣。
net_amount	应用 discount_amount 后的可计费使用量。 这是你的帐户将被计费的金额。 gross_amount - discount_amount = net_amount。
username	与使用情况关联的用户（如适用）。 仅在详细报告中提供。
organization	与使用情况关联的组织（如适用）。
repository	与使用情况关联的仓库（如适用）。
workflow_path	生成此使用情况的 GitHub Actions 工作流路径（如适用）。 仅在详细报告中提供。
cost_center_name	与使用情况关联的成本中心（如适用）。

已弃用报告字段

GitHub 旨在最大程度地减少对使用情况报告结构的更改，但有时报告结构或字段可能会发生变化。

已弃用字段	替代功能
usage_at	请改为参考 date。
workflow_name	请改为参考 workflow_path。

接收报告

使用情况报告会通过电子邮件发送至与你的 GitHub 帐户关联的默认电子邮件地址。