---
title: 计量限制和常见问题
slug: zh/2FwepB_41_63bbGumBUDc
icon: {"faIcon":"fa-brands fa-wordpress"}
createdAt: 2026-02-23T14:38:52.766Z
---



# 什么是 Metering（用通俗的话解释）？

当客户在 Microsoft Marketplace 上购买 SaaS 产品时，他们通常会支付固定的月费。但有些产品还会根据实际使用量收费——例如发送的电子邮件数量、发出的 API 调用次数或处理的数据 GB 数量。这称为按量计费（metered billing）。

其工作方式很简单：您的平台（ISV 的软件）会跟踪客户的使用量，当使用量超过包含的额度时，它会向 Microsoft 发送一份报告，说明“该客户使用了 Y 项中的 X 个单位”。然后 Microsoft 会针对这些额外使用量向客户收费。

该报告通过 Metering Service API 发送。而该 API 对您何时以及如何发送这些报告有明确规定。



# 您需要了解的一条规则

关于 metering API，几乎所有内容都归结为一条规则：



| **📌 黄金规则**<br />对于每个客户订阅、每个计费指标、每个日历小时，您只能发送 ONE 条使用量报告。如果您尝试在同一小时内为相同组合发送第二条报告，它会因重复而被拒绝。 |
| ------------------------------------------------------------------------------------------- |



就是这样。其他所有情况都只是这一规则的变体。



## “每个订阅 + 每个指标 + 每小时”到底是什么意思？

订阅（Subscription）= 一个客户的订单。每个订单都有唯一 ID。

指标（Metric，也称 dimension）= 您收费的项目（例如 emails\_sent、api\_calls、storage\_gb）。每个产品可以有多个指标。

日历小时（Calendar hour）= 例如 08:00–08:59 算作一个小时。09:00 会开始一个新的时间段。



因此，这条规则适用于这三者的特定组合。只要其中任意一个发生变化，它就是一个完全独立的时间槽。



# 那么我可以发送什么？

## ✅ 不同客户的两条报告——没问题

如果客户 A 和客户 B 都有活动订阅，您可以在完全相同的时间为两者发送报告。它们具有不同的订阅 ID，因此彼此完全独立。您甚至可以同时为 100 个不同客户发送报告。



## ✅ 不同指标的两条报告——没问题

如果您的产品有两个计费维度（例如 emails\_sent 和 api\_calls），您可以在同一分钟内为两者发送报告。不同指标 = 不同时间槽。不会冲突。



## ✅ 相同客户、相同指标、不同小时的两条报告——可以

如果您在 08:55 发送了一条关于客户 A 邮件使用量的报告，然后又在 09:05 再发送一次——这是可以的。这属于两个不同的日历小时，因此是两个独立的时间槽。



## ❌ 相同客户、相同指标、相同小时的两条报告——会被拒绝

如果您在 08:10 为客户 A 的邮件使用量发送了一条报告，然后又在 08:45 为同一指标发送另一条报告——第二条会被拒绝。因为您已经占用了该时间槽。



| **💡 正确的处理方式**<br />不要在每次发生使用事件时都立即发送。相反，请在一小时内收集并汇总所有使用量，然后在该小时结束时发送一条包含总量的报告。这也是 Microsoft 推荐的做法。 |
| --------------------------------------------------------------------------------------------------- |



# 仅限活动订阅

您只能为当前处于活动状态的订阅发送使用量报告。Microsoft 会拒绝以下订阅的事件：

•        已取消 / 已退订

•        已暂停

•        仍在等待激活（PendingFulfillmentStart）



唯一的例外情况：如果客户今天取消了订阅，您仍然可以为取消之前期间的使用量发送报告——只要您在 24 小时窗口内完成即可。



# 常见场景一览



| **情况**                                  | **结果**     | **原因**                   |
| --------------------------------------- | ---------- | ------------------------ |
| 同一订单、同一计量器的两个事件，相隔 5 分钟（同一小时内）          | **❌  已拒绝** | 同一小时内 — 合并为一个事件          |
| 同一订单、同一计量器的两个事件，但处于不同时段（例如 8:50 和 9:05） | **✅  已接受** | 不同时段，不存在冲突               |
| 同一订单、不同计量器的两个事件，时间相同                    | **✅  已接受** | 不同维度彼此独立                 |
| 不同订单（订阅）、同一计量器、相同时间的两个事件                | **✅  已接受** | 不同订阅 = 完全不存在冲突           |
| 已取消或已暂停订阅的事件                            | **❌  已拒绝** | 仅接受处于活动状态（Subscribed）的订阅 |





*[来源：Microsoft Learn — Metering Service APIs 与常见问题](https://learn.microsoft.com/en-us/partner-center/marketplace-offers/marketplace-metering-service-apis)*
