获取所有间接经销商分析信息

项目
05/29/2024

适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心

如何获取客户的所有间接经销商分析信息。

先决条件

合作伙伴中心身份验证中所述的凭据。此方案仅支持使用用户凭据进行身份验证。

REST 请求

请求语法

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

URI 参数

参数	类型	描述
partnerTenantId	string	要为其检索间接经销商数据的合作伙伴的租户 ID。
id	string	间接经销商 ID
name	string	要为其检索间接经销商数据的合作伙伴的名称。
market	string	要为其检索间接经销商数据的合作伙伴市场。
firstSubscriptionCreationDate	采用 UTC 日期/时间格式的字符串	要检索间接经销商数据的第一个订阅的创建日期。
latestSubscriptionCreationDate	采用 UTC 日期/时间格式的字符串	最新订阅的创建日期。
firstSubscriptionEndDate	采用 UTC 日期/时间格式的字符串	首次终止任何订阅。
latestSubscriptionEndDate	采用 UTC 日期/时间格式的字符串	终止任何订阅的最新日期。
firstSubscriptionSuspendedDate	UTC 日期时间中的字符串	首次暂停任何订阅。
latestSubscriptionSuspendedDate	采用 UTC 日期/时间格式的字符串	暂停任何订阅的最新日期。
firstSubscriptionDeprovisionedDate	采用 UTC 日期/时间格式的字符串	首次取消预配任何订阅。
latestSubscriptionDeprovisionedDate	采用 UTC 日期/时间格式的字符串	取消预配任何订阅的最新日期。
subscriptionCount	double	所有增值经销商的订阅计数
licenseCount	double	所有增值经销商的许可证计数。
indirectResellerCount	double	间接经销商计数
top	string	要在请求中返回的数据行数。如果未指定，则最大值和默认值为 10,000。当查询中存在多行数据时，响应正文中包含的下一个链接可用于请求下一页数据。
skip	int	要在查询中跳过的行数。使用此参数可以浏览较大的数据集。例如， `top=10000 and skip=0` 检索前 10,000 行数据， `top=10000 and skip=10000` 检索接下来的 10,000 行数据，等等。
filter	string	请求中的 filter 参数包含一条或多条用来在响应中筛选行的语句。每个语句都包含一个字段和值，这些字段和值可以与`eq`或`ne`运算符相关联，并且可以使用或组合`or`语句`and`。可以指定以下字段： partnerTenantId id Name 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	string	指定用于检索聚合数据的时间范围。可以是以下字符串之一：“day”、“week”或“month”。如果未指定，则默认值为“day”。 `aggregationLevel` 如果没有 .，则不支持 aggregationLevel/>。 `aggregationLevel`适用于中显示的所有日期字段`aggregationLevel`
orderby	string	一个用来对每次安装的结果数据值进行排序的语句。语法为 `...&orderby=field[order],field [order],...`。字段参数可以是以下字符串之一： “partnerTenantId” "id" "name" “market” “firstSubscriptionCreationDate” “latestSubscriptionCreationDate” “firstSubscriptionEndDate” “latestSubscriptionEndDate” “firstSubscriptionSuspendedDate” “latestSubscriptionSuspendedDate” “firstSubscriptionDeprovisionedDate” “latestSubscriptionDeprovisionedDate” “subscriptionCount” “licenseCount” 顺序参数是可选的，可以是`asc`或 ;，可以指定`desc`每个字段的升序或降序。默认为 `asc`。示例： `...&orderby=market,subscriptionCount`
groupby	string	仅将数据聚合应用于指定字段的语句。可以指定以下字段： partnerTenantId ID Name 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
}

另请参阅

合作伙伴中心分析 - 资源

通过