Получение всех сведений об аналитике поиска

Мақала
03/07/2025

применимо к: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud для государственных организаций США

Как получить всю информацию аналитики поиска для клиентов.

Необходимые условия

Учетные данные, как описано в проверке подлинности Центра партнеров. Этот сценарий поддерживает проверку подлинности только с учетными данными пользователя.

Запрос REST

Синтаксис запроса

Метод	URI запроса
GET	{baseURL}/partner/v1/analytics/search HTTP/1.1

Параметры URI

Параметр	Тип	Описание
`filter`	струна	Возвращает данные, соответствующие условию фильтра. Пример : `.../search?filter=field eq 'value'`
`groupby`	струна	Поддерживает как условия, так и даты. Логика короткого замыкания для ограничения количества ведер. Пример : `.../search?groupby=termField1,dateField1,termField2`
уровень агрегации	струна	Для параметра уровня агрегации требуется `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"
}

См. также

Аналитика центра партнеров — ресурсы

Бөлісу құралы: