Partilhar via

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

  • Artigo

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

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

Pré-requisitos

  • Credenciais conforme descrito na autenticação do Partner Center. Este cenário suporta autenticação apenas com credenciais de Utilizador.

Pedido REST

Sintaxe da solicitação

Método URI do pedido
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parâmetros de URI

Parâmetro Tipo Description
partnerTenantId string A ID do locatário do parceiro para o qual você deseja recuperar 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.
firstSubscriptionCreationDate 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.
latestSubscriptionCreationDate string no formato de data e hora UTC A data de criação da assinatura mais recente.
firstSubscriptionEndDate string no formato de data e hora UTC Primeira vez que qualquer assinatura foi encerrada.
latestSubscriptionEndDate string no formato de data e hora UTC Data mais recente em que qualquer subscrição foi encerrada.
firstSubscriptionSuspendedDate string na hora da data UTC Primeira vez que qualquer assinatura foi suspensa.
latestSubscriptionSuspendedDate string no formato de data e hora UTC Última data em que qualquer subscrição foi suspensa.
firstSubscriptionDeprovisionedDate string no formato de data e hora UTC Primeira vez que qualquer assinatura foi desprovisionada.
latestSubscriptionDeprovisionedDate string no formato de data e hora UTC Data mais recente em que qualquer subscrição foi desprovisionada.
assinaturaContagem duplo Contagem de assinaturas para todos os revendedores de valor agregado
licenseCount duplo Contagem de licenças para todos os revendedores de valor acrescentado.
indirectResellerCount duplo Contagem de revendedores indiretos
principal 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.
skip número inteiro 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 filter 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 or, e as eq instruções podem ser combinadas usando and ou or.ne Você pode especificar os seguintes campos:

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))
agregaçãoNível 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 aggregationLevelarquivo . aggregationLevel aplica-se a todos os campos de data presentes na aggregationLevel
encomendado 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 parceiroInquilino"
"Identificação"
"Nome"
"Mercado"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"assinaturaCount"
"Contagem de licenças"

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

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

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
assinaturaContagem

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

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

Cabeçalhos do pedido

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

Corpo do pedido

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 do REST

Se 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": "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
}

Consulte também