取得所有搜尋分析資訊

文章
03/08/2025

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

如何取得客戶的所有搜尋分析資訊。

先決條件

合作夥伴中心驗證中所描述的憑證。此案例僅支援使用使用者認證進行驗證。

REST 要求

要求語法

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

URI 參數

參數	類型	描述
`filter`	字串	傳回符合篩選條件的數據。範例： `.../search?filter=field eq 'value'`
`groupby`	字串	同時支援字詞和日期。限制儲槽數目的短路邏輯。範例： `.../search?groupby=termField1,dateField1,termField2`
聚合層級	字串	aggregationLevel 參數需要 `groupby`。 `aggregationLevel` 參數會套用至 `groupby`中的所有日期欄位。範例： `.../search?groupby=termField1,dateField1,termField2&aggregationLevel=day`
`top`	字串	頁面限制為 10000。接受小於 10000 的任何值。範例： `.../search?top=100`
`skip`	字串	要略過的列數。範例： `.../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"
}

另請參閱

合作夥伴中心分析 - 資源

分享方式：