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

Мақала
03/08/2023

Область применения: Центр партнеров | Центр партнеров для 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 требуется groupby. Параметр aggregationLevel применяется ко всем полям даты, присутствующим в groupby. Примере: `.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day`
top	строка	Ограничение страницы — 10 000. Принимает любое значение меньше 10 000. Примере: `.../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"
}

См. также раздел

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

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