Compartilhar 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 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 Tipo Descrição
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
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.
mais recenteSubscriptionCreationDate 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.
data_finaldeSubscription_latest cadeia de caracteres no formato de data e hora em UTC Data mais recente em que qualquer assinatura foi encerrada.
firstSubscriptionSuspendedDate string em 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.
dataDeprovisionedDeprovisioned, mais recente, cadeia de caracteres no formato de data e hora em UTC Data mais recente em que qualquer assinatura foi desprovisionada.
contagem de assinaturas 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 especificado, são 10.000. Se houver mais linhas na consulta, o corpo da resposta incluirá um proximo 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 esse 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.
filtro 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 orne, e as eq instruções podem ser combinadas usando and ou or. Você pode especificar os seguintes campos:

partnerTenantId
id
Nome
market
firstSubscriptionCreationDate
mais recenteSubscriptionCreationDate
firstSubscriptionEndDate
data_finaldeSubscription_latest
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
dataDeprovisionedDeprovisioned, mais recente,

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 cujos dados agregados serão recuperados. Pode ser uma das seguintes cadeias de caracteres: "dia", "semana" ou "mês". Se não for especificado, o padrão é "dia".

aggregationLevel não é suportado sem um aggregationLevel. aggregationLevel aplica-se a todos os campos de data presentes no aggregationLevel
orderby 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:

"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 a ordem crescente ou decrescente para cada campo. O padrão é asc.

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

partnerTenantId
ID
Nome
market
firstSubscriptionCreationDate
mais recenteSubscriptionCreationDate
firstSubscriptionEndDate
data_finaldeSubscription_latest
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
dataDeprovisionedDeprovisioned, mais recente,

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

indirectResellerCount
licenseCount
contagem de assinaturas

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

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

Cabeçalhos da 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 for bem-sucedido, 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 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, 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