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

Artigo
07/04/2024

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

Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação somente com credenciais de usuário.

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 or`ne`, 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

Análise do Partner Center – recursos

Compartilhar via