Получить всю аналитическую информацию о рефералах

Статья
03/07/2025

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

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

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

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

Запрос REST

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

Метод	URI запроса
ПОЛУЧИТЬ	{baseURL}/partner/v1/analytics/referrals HTTP/1.1

Параметры URI

Параметр	Тип	Описание
фильтр	струна	Возвращает данные, соответствующие условию фильтра. Пример : `.../referrals?filter=field eq 'value'`
groupby	струна	Поддерживает как условия, так и даты. Логика короткого замыкания, чтобы ограничить количество корзин. Пример: `.../referrals?groupby=termField1,dateField1,termField2`
уровень агрегации	струна	Параметр агрегированияLevel требует группирования. Параметр уровень агрегирования применяется ко всем полям дат, присутствующим в группировании. Пример : `.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day`
Вверх	струна	Ограничение страницы равно 10000. Принимает любое значение меньше 10000. Пример : `.../referrals?top=100`
пропустить	струна	Количество строк для пропуска. Пример: : `.../referrals?top=100&skip=100`

Заголовки запросов

Дополнительные сведения см. в заголовках REST Центра партнеров.

Текст запроса

Нет.

Пример запроса

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/referrals HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Ответ REST

В случае успешного выполнения текст ответа содержит коллекцию ресурсов рефералов.

Коды успешных ответов и ошибок

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Полный список см. в разделе Коды ошибок.

Пример ответа

{
  "id": "112310",
  "status": "Accepted",
  "customerMarket": "US",
  "customerName": "Best Customer Ever",
  "customerOrgSize": "10to50employees",
  "acceptedDate": "2018-02-07T23:43:19",
  "acknowledgedDate": "2018-02-07T23:40:50",
  "archivedDate": null,
  "declinedDate": null,
  "expiredDate": null,
  "lostDate": null,
  "missedDate": null,
  "createdDate": "2018-02-04T23:08:59",
  "skippedDate": null,
  "wonDate": null,
  "partnerMarket": "US"
}

См. также

Аналитика Партнерского центра - ресурсы

Поделиться через