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

项目
03/08/2023

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

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

必备条件

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

REST 请求

请求语法

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

URI 参数

参数	类型	说明
partnerTenantId	字符串	要检索间接经销商数据的合作伙伴的租户 ID。
id	string	间接经销商 ID
name	字符串	要检索间接经销商数据的合作伙伴的名称。
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	要在请求中返回的数据行数。如果未指定，最大值和默认值为 10000。当查询中存在多行数据时，响应正文中包含的下一个链接可用于请求下一页数据。
skip	int	要在查询中跳过的行数。使用此参数可以浏览较大的数据集。例如， `top=10000 and skip=0` 检索前 10000 行数据， `top=10000 and skip=10000` 检索接下来的 10000 行数据，等等。
filter	string	请求中的 filter 参数包含一条或多条语句，用于在响应中筛选行。每个语句都包含与或运算符关联的`eq`字段和值，可以使用或 `or`组合`and`语句。`ne` 可以指定的字段如下所示： 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	string	指定用于检索聚合数据的时间范围。可以是以下字符串之一：“day”、“week”或“month”。如果未指定，则默认值为“day”。 `aggregationLevel` 如果没有 `aggregationLevel`，则不支持。 `aggregationLevel`适用于中存在的所有日期字段`aggregationLevel`
orderby	string	对每个安装的结果数据值进行排序的语句。语法为 `...&orderby=field[order],field [order],...`。 field 参数可以是以下字符串之一。 “partnerTenantId” "id" “name” “market” “firstSubscriptionCreationDate” “latestSubscriptionCreationDate” “firstSubscriptionEndDate” “latestSubscriptionEndDate” “firstSubscriptionSuspendedDate” “latestSubscriptionSuspendedDate” “firstSubscriptionDeprovisionedDate” “latestSubscriptionDeprovisionedDate” “subscriptionCount” “licenseCount” order 参数是可选的，可以是 `asc` 或 `desc`;用于指定每个字段的升序或降序。默认为 `asc`。示例： `...&orderby=market,subscriptionCount`
groupby	string	仅将数据聚合应用于指定字段的语句。可以指定的字段如下所示： partnerTenantId id 名称 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": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE",
    "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
}

另请参阅

合作伙伴中心分析 - 资源