共用方式為

取得所有間接轉銷商的分析資訊

  • 發行項

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

如何取得客戶的所有間接轉銷商分析資訊。

必要條件

REST 要求

要求語法

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

URI 參數

參數 類型 描述
partnerTenantId 字串 您想要擷取間接轉銷商數據的合作夥伴租用戶標識碼。
id 字串 間接轉銷商標識碼
NAME 字串 您想要擷取間接轉銷商數據的合作夥伴名稱。
market 字串 您想要擷取間接轉銷商數據的合作夥伴市場。
firstSubscriptionCreationDate UTC 日期時間格式的字串 第一個訂用帳戶的建立日期，根據您想要擷取間接轉銷商數據的建立日期。
latestSubscriptionCreationDate UTC 日期時間格式的字串 最新訂閱的建立日期。
firstSubscriptionEndDate UTC 日期時間格式的字串 第一次結束任何訂用帳戶。
latestSubscriptionEndDate UTC 日期時間格式的字串 任何訂用帳戶結束的最近日期。
firstSubscriptionSuspendedDate 以 UTC 日期時間表示的字串 第一次暫停任何訂用帳戶。
latestSubscriptionSuspendedDate UTC 日期時間格式的字串 暫停任何訂閱的最新日期。
firstSubscriptionDeprovisionedDate UTC 日期時間格式的字串 第一次取消布建任何訂用帳戶。
latestSubscriptionDeprovisionedDate UTC 日期時間格式的字串 取消布建任何訂用帳戶的最新日期。
subscriptionCount double 所有加值轉銷商的訂用帳戶計數
licenseCount double 所有加值轉銷商的授權計數。
indirectResellerCount double 間接轉銷商計數
top 字串 要求中要傳回的資料列數。 如果未指定，則最大值和預設值為10,000。 如果查詢中有更多資料列，回應本文會包含下一個連結，您可以用來要求下一頁的資料。
skip int 要在查詢中忽略的列數。 使用此參數逐頁瀏覽大型資料集。 例如，擷 top=10000 and skip=0 取前 10,000 個數據列、 top=10000 and skip=10000 擷取接下來的 10,000 個數據列等等。
篩選器 字串 要求的 filter 參數包含一或多個陳述式，可篩選回應中的資料列。 每個語句都包含與 或 ne 運算符相關聯的eq欄位和值，而語句可以使用 或or結合and。 您可以指定下列功能變數：

partnerTenantId
id
名稱
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

範例：
.../indirectresellers?filter=market eq 'US'

範例：
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel 字串 指定要擷取彙總資料的時間範圍。 可以是下列其中一個字符串：“day”、“week” 或 “month”。 如果未指定，則預設值為 「day」。

aggregationLevel 不支援沒有 aggregationLevel支援 。 aggregationLevel適用於 中的所有日期欄位aggregationLevel
orderby 字串 對每個安裝的結果資料值進行排序的陳述式。 語法是 ...&orderby=field[order],field [order],...。 field 參數可以是下列其中一個字符串：

“partnerTenantId”
"id"
"name"
“市場”
“firstSubscriptionCreationDate”
“latestSubscriptionCreationDate”
“firstSubscriptionEndDate”
“latestSubscriptionEndDate”
“firstSubscriptionSuspendedDate”
“latestSubscriptionSuspendedDate”
“firstSubscriptionDeprovisionedDate”
“latestSubscriptionDeprovisionedDate”
“subscriptionCount”
“licenseCount”

order 參數是選擇性的，可以是 asc 或 desc，以指定每個欄位的遞增或遞減順序。 預設值為 asc。

範例：
...&orderby=market,subscriptionCount
groupby 字串 僅將資料彙總套用至指定欄位的陳述式。 您可以指定下列功能變數：

partnerTenantId
識別碼
名稱
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

傳回的資料列包含 子句中指定的 groupby 欄位，以及下列欄位：

indirectResellerCount
licenseCount
subscriptionCount

參數 groupby 可以搭配 aggregationLevel 參數使用。

例：
...&groupby=ageGroup,market&aggregationLevel=week

要求標頭

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

要求本文

無。

要求範例

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

REST 回應

如果成功，回應本文會包含間接轉銷商資源的集合。

回應成功和錯誤碼

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

回應範例

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "1111111",
    "name": "RESELLER NAME",
    "market": "US",
    "firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "firstSubscriptionEndDate": "2018-11-07T00:00:00",
    "latestSubscriptionEndDate": "2018-11-07T00:00:00",
    "firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
    "latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
    "subscriptionCount": 10,
    "licenseCount": 20
}

另請參閱