検索の分析情報をすべて取得する
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
顧客のすべての検索分析情報を取得する方法。
前提条件
- パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、ユーザー資格情報のみを使用した認証がサポートされます。
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/partner/v1/analytics/search HTTP/1.1 |
URI パラメーター
パラメーター | 型 | 説明 |
---|---|---|
filter |
string | フィルター条件に一致するデータを返します。 Example: .../search?filter=field eq 'value' |
groupby |
string | 使用条件と日付の両方をサポートします。 バケットの数を制限する短絡ロジック。 Example: .../search?groupby=termField1,dateField1,termField2 |
aggregationLevel | string | aggregationLevel パラメーターにはgroupby が必要です。 aggregationLevel パラメーターは、groupby に存在するすべての日付フィールドに適用されます。 Example: .../search?groupby=termField1,dateField1,termField2&aggregationLevel=day |
top |
string | ページ制限は 10000 です。 10000. 未満の値を受け取ります Example: .../search?top=100 |
skip |
string | スキップする行数。 Example: .../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 応答
成功した場合、応答本文には Search リソースのコレクションが含まれます。
応答の成功とエラーのコード
各応答には、成功または失敗と追加のデバッグ情報を示す 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"
}