Marketplace 計量付費 API - 常見問題集

在理想情況下，只有在前一小時內有使用量時，您預期會每小時發出使用量。

沒有這樣的限制。 只會在發生時發出使用量。 例如，如果您只需要提交每個訂用帳戶存留期的一個使用量單位，就可以這麼做。

在理想情況下，過去一小時內發生的事件會每小時發出使用量事件。 不過，預期會有延遲。 允許的最大延遲為 24 小時，之後將不會接受使用事件。 最佳做法是收集每小時使用量，而發出是當做一個事件在一小時結束時。

例如，如果使用量事件發生在一天下午 1 點，您直到第二天下午 1 點，才會發出與此事件相關聯的使用量事件。 如果系統發出使用量已關閉，它可以復原，然後針對發生使用量的小時間隔傳送使用量事件，而不會遺失精確度。

如果在實際使用量之後經過 24 小時，您仍然可以使用較晚的使用事件發出已取用的單位。 不過，這種做法可能會損害客戶計費事件報告的可信度。 建議您避免每天/周/月傳送計量排放一次。 更難瞭解客戶的實際使用量，並解決有關使用事件的問題或問題。

每小時傳送使用量的另一個原因是避免使用者在發行者傳送每日/每周/每月排放事件之前取消訂閱的情況。

一小時間隔只接受一個使用量事件。 小時間隔從分鐘 0 開始，並以分鐘 59 結束。 如果在同一小時內發出多個使用量事件，則任何後續的使用事件都會卸除為重複專案。

不會收取固定費率金額，但超額使用量將會收費。

是，您可以將自定義維度定義為一次性付款的一個單位，並針對每個客戶只發出一次。

是，可以使用代表單一價格區間的每個自定義維度來實作。

例如，Contoso 想要針對前 1000 封電子郵件收取每封電子郵件 $0.5 美元、每封電子郵件 1000 到 5000 封電子郵件 0.4 美元，以及超過 5000 封電子郵件的每封電子郵件 $0.2 美元。 他們可以定義三個自定義維度，其對應至三個電子郵件定價層。 只要電子郵件數目保持在 1000 以下，就會發出第一個維度的單位，然後在電子郵件數目介於 1000 到 5000 之間時，第二個維度的單位，最後是超過 5000 封電子郵件的第三個維度單位。

如果ISV傳送自定義計量並收到錯誤，這可能是由 Microsoft 端的問題所造成（通常是在類似事件之前接受但未發生錯誤的情況下），ISV 應該等候並重試排放。

如果錯誤持續發生，則會在下一小時重新提交該自定義計量（累積數量）。 繼續此程式，直到收到非錯誤響應為止。

刪除 SaaS 訂用帳戶之後，將不會接受任何向 Marketplace 平台發出的使用量事件。

只能針對訂閱狀態的訂用帳戶發出使用量（不適用於、 Suspended或 Unsubscribed 狀態中的PendingFulfillmentStart訂用帳戶）。

唯一的例外狀況是報告 SaaS 訂用帳戶取消之前的時間使用量。

例如，客戶今天下午 3 點取消了 SaaS 訂用帳戶。 現在為下午 5 點，發行者仍然可以在此 SaaS 訂閱的昨天下午 6 點到今天下午 3 點之間發出使用量。

是，當您呼叫 GET 訂用帳戶清單 API 時，它會包含所有 SaaS 訂用帳戶的清單。 每個 SaaS 訂用帳戶回應中的狀態欄位會擷取訂用帳戶為作用中或取消訂閱。

在訂閱狀態中，現有 SaaS 訂用帳戶可以隨時發出超額事件。 發行者有責任根據計費方案中所定義的原則發出使用量事件。 超額必須根據 SaaS 訂用帳戶期間定義的日期來計算。

例如，如果發行者定義 SaaS 方案，其中包含每月 100 美元一般費率的 1000 封電子郵件，則每個超過 1000 的電子郵件都會透過自定義維度向 $1 計費。

當客戶於 1 月 6 日購買並啟用訂閱時，一般費率中包含的 1000 封電子郵件將從這一天開始計算。 因此，如果直到 2 月 5 日（訂閱的第一個月結束）才會傳送 900 封電子郵件，客戶只會支付此訂閱的第一個月固定費率，而發行者在 1 月 6 日至 2 月 5 日期間不會發出超額使用量事件。 在 2 月 6 日，訂閱將自動更新，計數將會再次啟動。 如果客戶在 2 月 15 日收到 1000 封電子郵件，則傳送到 3 月 5 日的其餘電子郵件會根據發行者發出的超額使用量事件收取超額（每封電子郵件 1 美元）。

下一步

• 如需詳細資訊，請參閱 Marketplace 計量服務 API。