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

Статья
07/04/2024

Область применения: Центр партнеров | Центр партнеров для Microsoft Cloud for US Government

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

Необходимые компоненты

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

Запрос REST

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

Способ	URI запроса
GET	{baseURL}/partner/v1/analytics/referrals HTTP/1.1

Параметры универсального кода ресурса (URI)

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

См. также

Аналитика Центра партнеров. Ресурсы

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