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

Получение всех аналитических сведений о непрямых торговых посредниках

  • Статья

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

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

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

Запрос REST

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

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

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

Параметр Тип Описание
partnerTenantId строка Идентификатор клиента партнера, для которого требуется получить данные косвенных торговых посредников.
id строка Идентификатор косвенного торгового посредника
name строка Имя партнера, для которого требуется получить данные косвенных торговых посредников.
на рынок строка Рынок партнера, для которого требуется получить данные косвенных торговых посредников.
firstSubscriptionCreationDate Строка в формате даты и времени UTC Дата создания первой подписки на основе которой требуется получить данные косвенных торговых посредников.
latestSubscriptionCreationDate Строка в формате даты и времени UTC Дата создания последней подписки.
firstSubscriptionEndDate Строка в формате даты и времени UTC При первом завершении любой подписки.
latestSubscriptionEndDate Строка в формате даты и времени UTC Последняя дата окончания подписки.
firstSubscriptionSuspendedDate строка в время даты в формате UTC При первом приостановке любой подписки.
latestSubscriptionSuspendedDate Строка в формате даты и времени UTC Последняя дата приостановки подписки.
firstSubscriptionDeprovisionedDate Строка в формате даты и времени UTC При первом отмене подписки.
latestSubscriptionDeprovisionedDate Строка в формате даты и времени UTC Последняя дата, когда любая подписка была отменена.
subscriptionCount двойной точности Количество подписок для всех добавленных торговых посредников значений
licenseCount двойной точности Количество лицензий для всех добавленных торговых посредников.
indirectResellerCount двойной точности Число косвенных торговых посредников
популярное строка Количество строк данных, возвращаемых в запросе. Максимальное значение и значение по умолчанию, если не указано 10 000. Если в запросе есть больше строк, текст ответа содержит следующую ссылку, которую можно использовать для запроса следующей страницы данных.
skip INT Количество строк, пропускаемых в запросе. Используйте этот параметр для страницы с помощью больших наборов данных. Например, top=10000 and skip=0 извлекает первые 10 000 строк данных, top=10000 and skip=10000 извлекает следующие 10 000 строк данных и т. д.
Фильтр строка Параметр фильтра запроса содержит одну или несколько инструкций, которые фильтруют строки в ответе. Каждая инструкция содержит поле и значение, связанное с eq операторами или ne операторами, и операторы могут объединяться с помощью and или or. Можно указать следующие поля:

partnerTenantId
id
Имя
рынок
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Пример:
.../indirectresellers?filter=market eq 'US'

Пример:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel строка Указывает диапазон времени, для которого требуется получить статистические данные. Может быть одной из следующих строк: "day", "week" или "month". Если не указано, значение по умолчанию — day.

aggregationLevel не поддерживается без aggregationLevel. aggregationLevel применяется ко всем полям дат, присутствующих в aggregationLevel
orderby строка Инструкция, которая упорядочивает значения результирующих данных для каждой установки. Синтаксис: ...&orderby=field[order],field [order],.... Параметр поля может быть одной из следующих строк:

PartnerTenantId
"id"
"name"
"рынок"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

Параметр заказа является необязательным и может быть asc или desc; для указания возрастания или убывания для каждого поля. Значение по умолчанию — asc.

Пример:
...&orderby=market,subscriptionCount
groupby строка Инструкция, которая применяет агрегирование данных только к указанным полям. Можно указать следующие поля:

partnerTenantId
ИД
Имя
рынок
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Возвращаемые строки данных содержат поля, указанные в groupby предложении, и следующие поля:

indirectResellerCount
licenseCount
subscriptionCount

Параметр groupby можно использовать с параметром aggregationLevel .

Пример:
...&groupby=ageGroup,market&aggregationLevel=week

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

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

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

Нет.

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

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

Ответ REST

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

Коды успешного выполнения и ошибок в ответе

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

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

{
    "partnerTenantId": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE",
    "id": "1111111",
    "name": "RESELLER NAME",
    "market": "US",
    "firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "firstSubscriptionEndDate": "2018-11-07T00:00:00",
    "latestSubscriptionEndDate": "2018-11-07T00:00:00",
    "firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
    "latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
    "subscriptionCount": 10,
    "licenseCount": 20
}

См. также