Partilhar via

Obtenha todas as informações analíticas de revendedores indiretos

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud para o Governo dos EUA

Como obter todas as informações analíticas de revendedores indiretos para seus clientes.

Pré-requisitos

Pedido REST

Sintaxe da solicitação

Método Solicitar URI
OBTER {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parâmetros de URI

Parâmetro Tipo Descrição
partnerTenantId string O ID do locatário do parceiro para o qual pretendes obter dados de revendedores indiretos.
ID string ID de revendedor indireto
Nome string O Nome do parceiro para o qual você deseja recuperar dados de revendedores indiretos.
mercado string O Mercado do parceiro para o qual você deseja recuperar dados de revendedores indiretos.
primeiraDataDeCriaçãoDaSubscrição string no formato de data e hora UTC A data de criação da primeira assinatura com base na qual você deseja recuperar dados de revendedores indiretos.
dataDaÚltimaCriaçãoDeSubscrição string no formato de data e hora UTC A data de criação da assinatura mais recente.
dataFimPrimeiraSubscrição cadeia de caracteres no formato de data e hora UTC Primeira vez que qualquer assinatura foi encerrada.
dataFinalMaisRecenteDaSubscrição cadeia de caracteres no formato de data e hora UTC Data mais recente em que qualquer subscrição foi encerrada.
primeiraDataDeSuspensãoDeAssinatura string com a data e hora em UTC Primeira vez que qualquer assinatura foi suspensa.
dataÚltimaSuspensãoAssinatura string no formato de data e hora UTC Última data em que qualquer subscrição foi suspensa.
dataPrimeiraSubscriçãoDesprovisionada cadeia de caracteres no formato de data e hora UTC Primeira vez que uma assinatura foi desativada.
dataMaisRecenteDeCancelamentoDeSubscrição string em formato de data e hora UTC Data mais recente em que qualquer subscrição foi desprovisionada.
contagemDeAssinaturas duplo Contagem de assinaturas para todos os revendedores de valor agregado
contagem de licenças duplo Número de licenças para todos os revendedores de valor agregado.
númeroRevendedoresIndiretos duplo Contagem de revendedores indiretos
Início 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 especificado, é 10.000. Se houver mais linhas na consulta, o corpo da resposta incluirá um próximo link que você pode usar para solicitar a próxima página de dados.
pular 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.
filtrar string O parâmetro do filtro da solicitação contém uma ou mais instruções que filtram as linhas na resposta. Cada instrução contém um campo e um valor associados aos operadores eq ou ne, e as instruções podem ser combinadas usando and ou or. Você pode especificar os seguintes campos:

partnerTenantId
id
Nome
mercado
dataDeCriaçãoDaPrimeiraAssinatura
dataDeCriaçãoDeSubscriçãoMaisRecente
firstSubscriptionEndDate
dataFinalDeSubscriçãoMaisRecente
firstSubscriptionSuspendedDate
dataSuspensaoSubscricaoMaisRecente
firstSubscriptionDeprovisionedDate
mais recenteSubscriptionDeprovisionedDate

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))
nível de agregação string Especifica o intervalo de tempo para o qual recuperar dados agregados. Pode ser uma das seguintes strings: "dia", "semana" ou "mês". Se não especificado, o padrão é "dia".

aggregationLevel não é suportado sem um aggregationLevel. aggregationLevel se aplica a todos os campos de data presentes no aggregationLevel
ordenar por string Uma instrução que ordena os valores dos dados de resultado para cada instalação. A sintaxe é ...&orderby=field[order],field [order],.... O parâmetro field pode ser uma das seguintes strings:

"Identificação do parceiro Inquilino"
"Identificação"
"Nome"
"Mercado"
dataDeCriaçãoDaPrimeiraSubscrição
"dataDeCriaçãoDaÚltimaSubscrição"
dataFimPrimeiraSubscrição
dataFimÚltimaSubscrição
dataPrimeiraSuspensãoAssinatura
dataMaisRecenteSuspensaoSubscricao
dataPrimeiraDesativaçãoAssinatura
DataDeÚltimaCessaçãoDeSubscrição
contagemDeAssinaturas
Contagem de licenças

O parâmetro de ordem é opcional e pode ser asc ou desc, para especificar a 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 somente aos campos especificados. Você pode especificar os seguintes campos:

IdInquilinoParceiro
ID
Nome
mercado
dataDeCriaçãoDaPrimeiraSubscrição
data de criação da subscrição mais recente
dataFimPrimeiraSubscricao
data mais recente de fim de subscrição
firstSubscriptionSuspendedDate
dataMaisRecenteSuspensaoSubscricao
firstSubscriptionDeprovisionedDate
mais recenteSubscriptionDeprovisionedDate

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

númeroDeRevendedoresIndiretos
Contagem de Licenças
contagemDeSubscrições

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

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

Cabeçalhos de solicitação

Para mais informações, consulte os cabeçalhos REST do Partner Center .

Corpo do pedido

Nenhuma.

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 for bem-sucedida, a resposta contém uma coleção de recursos de revendedores indiretos .

Códigos de sucesso e erro de resposta

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

Exemplo de resposta

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "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
}

Ver também