Obter todas as informações de análise de revendedores indiretos

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Como obter todas as informações de análise de revendedores indiretos para seus clientes.

Pré-requisitos

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parâmetros do URI

Parâmetro Type Descrição
partnerTenantId string A ID do locatário do parceiro para o qual você deseja recuperar dados de revendedores indiretos.
id string ID do revendedor indireto
name string O Nome do parceiro para o qual você deseja recuperar dados de revendedores indiretos.
market string O Mercado do parceiro para o qual você deseja recuperar dados de revendedores indiretos.
firstSubscriptionCreationDate cadeia de caracteres no formato de data e hora em UTC A data de criação da primeira assinatura com base na qual você deseja recuperar dados de revendedores indiretos.
latestSubscriptionCreationDate cadeia de caracteres no formato de data e hora em UTC A data de criação da assinatura mais recente.
firstSubscriptionEndDate cadeia de caracteres no formato de data e hora em UTC Primeira vez que qualquer assinatura foi encerrada.
latestSubscriptionEndDate cadeia de caracteres no formato de data e hora em UTC Data mais recente em que qualquer assinatura foi encerrada.
firstSubscriptionSuspendedDate cadeia de caracteres na data e hora UTC Primeira vez que qualquer assinatura foi suspensa.
latestSubscriptionSuspendedDate cadeia de caracteres no formato de data e hora em UTC Data mais recente em que qualquer assinatura foi suspensa.
firstSubscriptionDeprovisionedDate cadeia de caracteres no formato de data e hora em UTC Primeira vez que qualquer assinatura foi desprovisionada.
latestSubscriptionDeprovisionedDate cadeia de caracteres no formato de data e hora em UTC Data mais recente em que qualquer assinatura foi desprovisionada.
subscriptionCount double Contagem de assinaturas para todos os revendedores de valor agregado
licenseCount double Contagem de licenças para todos os revendedores de valor agregado.
indirectResellerCount double Contagem de revendedores indiretos
top string O número de linhas de dados a serem retornadas na solicitação. O valor máximo e o valor padrão; se não forem especificados, será 10.000. Se houver mais linhas na consulta, o corpo da resposta incluirá um link que você poderá usar para solicitar a próxima página de dados.
skip INT O número de linhas a serem ignoradas na consulta. Use este parâmetro para percorrer grandes conjuntos de dados. Por exemplo, top=10000 and skip=0 recupera as primeiras 10.000 linhas de dados, top=10000 and skip=10000 recupera as próximas 10.000 linhas de dados e assim por diante.
filter string O parâmetro filter da solicitação contém uma ou mais instruções que filtram as linhas da resposta. Cada instrução contém um campo e um valor associados aos eq operadores ou ne , e as instruções podem ser combinadas usando and ou or. Você pode especificar os campos a seguir:

partnerTenantId
id
Nome
Mercado
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Exemplo:
.../indirectresellers?filter=market eq 'US'

Exemplo:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel string Especifica o intervalo de tempo para o qual recuperar dados agregados. Pode ser uma das seguintes cadeias de caracteres: "day", "week" ou "month". Se não for especificado, o padrão será "day".

aggregationLevel não tem suporte sem um aggregationLevel. aggregationLevel aplica-se a todos os campos de data presentes no aggregationLevel
orderby string Uma instrução que classifica os valores dos dados resultantes de cada instalação. A sintaxe é ...&orderby=field[order],field [order],.... O parâmetro field pode ser uma das seguintes cadeias de caracteres:

"partnerTenantId"
"id"
"name"
"mercado"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

O parâmetro order é opcional e pode ser asc ou desc; para especificar ordem crescente ou decrescente para cada campo. O padrão é asc.

Exemplo:
...&orderby=market,subscriptionCount
groupby string Uma instrução que aplica a agregação de dados apenas aos campos especificados. Você pode especificar os campos a seguir:

partnerTenantId
id
Nome
Mercado
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

As linhas de dados retornadas contêm os campos especificados na groupby cláusula e os seguintes campos:

indirectResellerCount
licenseCount
subscriptionCount

O groupby parâmetro pode ser usado com o aggregationLevel parâmetro .

Exemplo:
...&groupby=ageGroup,market&aggregationLevel=week

Cabeçalhos de solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

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

Resposta REST

Se tiver êxito, o corpo da resposta conterá uma coleção de recursos de revendedores indiretos .

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de Erro.

Exemplo de resposta

{
    "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
}

Confira também