取得所有訂用帳戶的分析資訊

發行項
09/22/2023

適用于：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

本文說明如何取得客戶的所有訂用帳戶分析資訊。

必要條件

認證，如合作夥伴中心驗證所述。此案例僅支援使用使用者認證進行驗證。

REST 要求

要求語法

方法	要求 URI
GET	{baseURL} /partner/v1/analytics/subscriptions HTTP/1.1

URI 參數

下表列出選擇性參數及其描述：

參數	類型	描述
top	int	要求中要傳回的資料列數。如果未指定值，最大值和預設值為 `10000` 。如果查詢中有更多資料列，回應主體會包含下一個連結，您可以用來要求下一頁的資料。
skip	int	查詢中要略過的資料列數目。使用此參數逐頁流覽大型資料集。例如， `top=10000` 和 `skip=0` 會擷取前 10,000 個數據列， `top=10000` 並 `skip=10000` 擷取接下來 10,000 個數據列。
篩選器	string	篩選回應中資料列的一或多個語句。每個篩選語句都包含來自回應本文的功能變數名稱，以及與 `eq` 、 `ne` 或特定欄位相關聯的值， `contains` 運算子。語句可以使用或 `or` 結合 `and` 。字串值必須以篩選參數中的單引號括住。如需可篩選的欄位清單，以及這些欄位支援的運算子，請參閱下一節。
aggregationLevel	string	指定要擷取匯總資料的時間範圍。可以是下列其中一個字串：日、周或月。如果未指定值，則預設值為 dateRange 。只有當 date 欄位傳遞為 groupBy 參數的一部分時，才適用此參數。
groupBy	string	語句，僅將資料匯總套用至指定的欄位。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

無。

要求範例

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST 回應

如果成功，回應本文會包含訂 用帳戶資源的集合 。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態碼，指出成功或失敗和額外的偵錯資訊。使用網路追蹤工具來讀取此程式碼、錯誤類型等等參數。如需完整清單，請參閱錯誤碼。

回應範例

{
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "customerName": "TESTORG65656565",
    "customerMarket": "US",
    "id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
    "status": "ACTIVE",
    "productName": "OFFICE 365 BUSINESS PREMIUM",
    "subscriptionType": "Office",
    "autoRenewEnabled": true,
    "partnerId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "friendlyName": "FULL OFFICE SUITE",
    "partnerName": "Partner Name",
    "providerName": "Provider Name",
    "creationDate": "2016-02-04T19:29:38.037",
   "effectiveStartDate": "2016-02-04T00:00:00",
    "commitmentEndDate": "2019-02-10T00:00:00",
    "currentStateEndDate": "2019-02-10T00:00:00",
    "trialToPaidConversionDate": null,
    "trialStartDate": null,
    "trialEndDate": null,
    "lastUsageDate": null,
    "deprovisionedDate": null,
    "lastRenewalDate": "2018-02-10T02:39:57.729",
    "licenseCount": 2,
    "churnRisk": "High",
    "billingCycleName": "MONTHLY"

}

另請參閱

合作夥伴中心分析 - 資源

共用方式為