获取所有搜索分析信息
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
如何获取客户的所有搜索分析信息。
先决条件
- 合作伙伴中心身份验证中所述的凭据。 此方案仅支持使用用户凭据进行身份验证。
REST 请求
请求语法
方法 | 请求 URI |
---|---|
GET | {baseURL}/partner/v1/analytics/search HTTP/1.1 |
URI 参数
参数 | 类型 | 说明 |
---|---|---|
filter |
string | 返回与筛选条件匹配的数据。 例: .../search?filter=field eq 'value' |
groupby |
string | 支持术语和日期。 用于限制存储桶数的短路逻辑。 例: .../search?groupby=termField1,dateField1,termField2 |
aggregationLevel | string | aggregationLevel 参数需要一个 groupby 。 该 aggregationLevel 参数适用于 .. 中 groupby 存在的所有日期字段。 例: .../search?groupby=termField1,dateField1,termField2&aggregationLevel=day |
top |
string | 页面限制为 10000。 采用小于 10000 的任何值。 例: .../search?top=100 |
skip |
string | 要跳过的行数。 例: .../search?top=100&skip=100 |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无。
请求示例
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/search HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
REST 响应
如果成功,响应正文将包含搜索资源的集合。
响应的成功和错误代码
每个响应都有一个 HTTP 状态代码,指示成功或失败以及额外的调试信息。 使用网络跟踪工具读取此代码、错误类型和其他参数。 有关完整列表,请参阅错误代码。
响应示例
{
"companyName": "my company",
"contactButtonClicked": false,
"keywordCountry": null,
"detailsViewed": true,
"keywordIndustryFocus": null,
"mpnId": 2604568,
"partnerMarket": "CN",
"keywordProduct": null,
"referralSubmitted": false,
"searchDate": "2018-05-30",
"keywordSearchText": " my company"
}