Análise do Partner Center – recursosPartner Center Analytics - Resources

Aplica-se aApplies To

  • Partner CenterPartner Center
  • Partner Center operado pela 21VianetPartner Center operated by 21Vianet
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

A API de análise permite que você acesse os dados que estão sendo apresentados na experiência do usuário de forma programática.The Analytics API allows you to programmatically access data that is being presented in the User Experience.

Pré-requisitosPrerequisites

Programa CSP: análise de uso do AzureCSP program: Azure usage analytics

O cenário a seguir mostra como usar a API de análise para recuperar todas as informações de análise de uso do Azure do Partner Center.The following scenario shows you how to use the Analytics API to retrieve all your Partner Center Azure usage analytics information.

Esse cenário retorna as informações de análise em uma coleção de recursos de uso do Azure .This scenario returns your analytics information in a collection of Azure usage resources.

Recurso de uso do AzureAzure usage resource

Representa todos os dados analíticos para uso do Azure.Represents all of the analytical data for Azure usage.

PropriedadeProperty TipoType DescriçãoDescription
CustomerTenantIdCustomerTenantId stringstring O identificador do locatário do cliente.The customer tenant identifier.
customerNamecustomerName stringstring O nome do cliente.The customer name.
subscriptionIdsubscriptionId stringstring O identificador da assinatura.The subscription identifier.
subscriptionNamesubscriptionName stringstring O nome da assinatura.The subscription name.
usageDateusageDate stringstring A data de uso.The usage date.
resourceLocationresourceLocation stringstring O local do data center, Europa Ocidental, por exemplo.The location of the data center, Western Europe, for example.
meterCategorymeterCategory stringstring A categoria de medidor, gerenciamento de dados, por exemplo.The meter category, data management, for example.
meterSubcategorymeterSubcategory stringstring A subcategoria de medidor, por exemplo, com redundância geográfica.The meter subcategory, for example, geo redundant.
meterUnitmeterUnit stringstring A unidade de medição, como gigabytes ou horas.The meter unit, such as gigabytes or hours.
reservationOrderIdreservationOrderId stringstring A ordem de reserva para uma instância reservada de VM do Azure.The reservation order for an Azure VM Reserved Instance.
reservationIdreservationId stringstring Instâncias reservadas em uma ordem de RI específica.Reserved instances under a specific RI order.
serviceTypeserviceType stringstring Indica o tipo de máquina virtual.Indicates the virtual machine type. Por exemplo, Standard_E4s_v3.For example, Standard_E4s_v3.
quantidadequantity longlong Indica os números usados na unidade de medição.Indicates the numbers used in the meter unit.

Programa CSP: análise indireta de revendedoresCSP program: indirect resellers analytics

O cenário a seguir mostra como usar a API de análise para recuperar todas as informações de análise de revendedores indiretos do Partner Center.The following scenario shows you how to use the Analytics API to retrieve all your Partner Center indirect resellers analytics information.

Esse cenário retorna as informações de análise em uma coleção de recursos de revendedores indiretos .This scenario returns your analytics information in a collection of indirect resellers resources.

Recurso de revendedor indiretoIndirect resellers resource

Representa todos os dados analíticos para revendedores indiretos.Represents all of the analytical data for indirect resellers.

PropriedadeProperty TipoType DescriçãoDescription
partnerTenantIdpartnerTenantId stringstring A ID do locatário do parceiro para o qual você deseja recuperar dados de revendedores indiretos.The Tenant ID of the partner for which you want to retrieve indirect resellers data.
idid stringstring ID indireta do revendedor.Indirect reseller ID.
namename stringstring O nome do parceiro para o qual você deseja recuperar dados de revendedores indiretos.The Name of the partner for which you want to retrieve indirect resellers data.
marketmarket stringstring O mercado do parceiro para o qual você deseja recuperar dados de revendedores indiretos.The Market of the partner for which you want to retrieve indirect resellers data.
firstSubscriptionCreationDatefirstSubscriptionCreationDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data de criação da primeira assinatura com base na qual você deseja recuperar dados de revendedores indiretos.The creation date of the first subscription based on which you want to retrieve indirect resellers data.
latestSubscriptionCreationDatelatestSubscriptionCreationDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data de criação da assinatura mais recente.The creation date of the latest subscription.
firstSubscriptionEndDatefirstSubscriptionEndDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Primeira vez que qualquer assinatura foi encerrada.First time any subscription was ended.
latestSubscriptionEndDatelatestSubscriptionEndDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Data mais recente em que uma assinatura foi encerrada.Latest date when any subscription was ended.
firstSubscriptionSuspendedDatefirstSubscriptionSuspendedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Primeira vez que qualquer assinatura foi suspensa.First time any subscription was suspended.
latestSubscriptionSuspendedDatelatestSubscriptionSuspendedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Última data em que uma assinatura foi suspensa.Latest date when any subscription was suspended.
firstSubscriptionDeprovisionedDatefirstSubscriptionDeprovisionedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Primeira vez que qualquer assinatura foi desprovisionada.First time any subscription was deprovisioned.
latestSubscriptionDeprovisionedDatelatestSubscriptionDeprovisionedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Data mais recente em que qualquer assinatura foi desprovisionada.Latest date when any subscription was deprovisioned.
subscriptionCountsubscriptionCount doubledouble Contagem de assinaturas para todos os revendedores de valor agregadoSubscription count for all value added resellers
licenseCountlicenseCount doubledouble Contagem de licenças para todos os revendedores de valor agregadoLicense count for all value added resellers
indirectResellerCountindirectResellerCount doubledouble Contagem de revendedores indiretosIndirect resellers count

Programa CSP: análise de assinaturaCSP program: subscription analytics

Os cenários a seguir mostram como usar a API de análise para recuperar todas as informações de análise de assinatura do Partner Center, filtrá-las com uma consulta de pesquisa ou agrupá-las por datas ou termos.The following scenarios show you how to use the Analytics API to retrieve all your Partner Center subscription analytics information, filter it with a search query, or group it by dates or terms.

Todos esses cenários retornam suas informações de análise em uma coleção de recursos de assinatura .All of these scenarios return your analytics information in a collection of Subscription resources.

Recurso de assinaturaSubscription resource

Representa todos os dados analíticos de uma assinatura.Represents all of the analytical data for a subscription.

PropriedadeProperty TipoType DescriçãoDescription
customerTenantIdcustomerTenantId stringstring Uma cadeia de caracteres formatada em GUID que identifica o locatário do cliente.A GUID-formatted string that identifies the customer tenant.
customerNamecustomerName stringstring O nome do cliente.The name of the customer.
customerMarketcustomerMarket stringstring O país/região no qual o cliente faz negócios.The country/region that the customer does business in.
idid stringstring O identificador da assinatura.The subscription identifier.
statusstatus stringstring O status da assinatura: "ativo", "suspenso" ou "desprovisionado".The subscription status: "ACTIVE", "SUSPENDED", or "DEPROVISIONED".
productNameproductName stringstring O nome do produto.The name of the product.
subscriptionTypesubscriptionType stringstring O tipo de assinatura.The subscription type. Observação: esse campo diferencia maiúsculas de minúsculas.Note: This field is case sensitive. Os valores com suporte são: "Office", "Azure", "Microsoft365", "Dynamics", "EMS".Supported values are: "Office", "Azure", "Microsoft365", "Dynamics", "EMS".
autoRenewEnabledautoRenewEnabled booleanoboolean Um valor que indica se a assinatura é renovada automaticamente.A value indicating whether the subscription is renewed automatically.
parceiroidpartnerId stringstring A ID do MPN.The MPN ID. Para um revendedor direto, esse parâmetro será a ID de MPN do parceiro.For a direct reseller, this parameter will be the MPN ID of the partner. Para um revendedor indireto, esse parâmetro será a ID de MPN do revendedor indireto.For an indirect reseller, this parameter will be the MPN ID of the indirect reseller.
friendlyNamefriendlyName stringstring O nome da assinatura.The name of the subscription.
partnerNamepartnerName stringstring Nome do parceiro para o qual a assinatura foi adquiridaName of the partner for whom the subscription was purchased
providerNameproviderName stringstring Quando a transação de assinatura é para o revendedor indireto, o nome do provedor é o provedor indireto que comprou a assinatura.When subscription transaction is for the indirect reseller, provider name is the indirect provider who bought the subscription.
effectiveStartDateeffectiveStartDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a assinatura é iniciada.The date the subscription starts.
commitmentEndDatecommitmentEndDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a assinatura termina.The date the subscription ends.
currentStateEndDatecurrentStateEndDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que o status atual da assinatura será alterado.The date that the current status of the subscription will change.
trialToPaidConversionDatetrialToPaidConversionDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a assinatura é convertida de avaliação para paga.The date that the subscription converts from trial to paid. O valor padrão é nulo.The default value is null.
trialStartDatetrialStartDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que o período de avaliação da assinatura foi iniciado.The date that the trial period for the subscription started. O valor padrão é nulo.The default value is null.
trialEndDatetrialEndDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que o período de avaliação da assinatura termina.The date that the trial period for the subscription ends. O valor padrão é nulo.The default value is null.
lastUsageDatelastUsageDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a assinatura foi usada pela última vez.The date that the subscription was last used. O valor padrão é nulo.The default value is null.
deprovisionedDatedeprovisionedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a assinatura foi desprovisionada.The date that the subscription was deprovisioned. O valor padrão é nulo.The default value is null.
lastRenewalDatelastRenewalDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a assinatura foi renovada pela última vez o valor padrão é NULL.The date that the subscription was last renewed The default value is null.
licenseCountlicenseCount númeronumber O número total de licenças.The total number of licenses.
subscriptionCountsubscriptionCount númeronumber O número de assinaturas.The number of subscriptions. Observação: esse valor só será exibido na resposta de uma consulta de agregação.Note: This value will only appear in the response of an aggregation query.

Análise do SearchSearch analytics

Observação

A associação do programa CSP não é necessária para obter a análise de pesquisa.CSP program membership isn't required to get search analytics.

O cenário a seguir mostra como usar a API de análise para recuperar todas as informações de análise de pesquisa do Partner Center.The following scenario shows you how to use the Analytics API to retrieve all your Partner Center search analytics information.

Esse cenário retorna as informações de análise em uma coleção de recursos de pesquisa .This scenario returns your analytics information in a collection of Search resources.

Pesquisar recursoSearch resource

Representa todos os dados analíticos de uma pesquisa.Represents all of the analytical data for a search.

PropriedadeProperty TipoType DescriçãoDescription
companyNamecompanyName stringstring O nome da empresa de cobrança.The billing company name.
contactButtonClickedcontactButtonClicked BooleanBoolean Indica se o botão de contato foi clicado.Indicates if the contact button was clicked.
keywordCountrykeywordCountry stringstring O país especificado na pesquisa.The country specified in the search.
detailsViewdetailsViewed BooleanBoolean Indica se os detalhes da pesquisa foram exibidos.Indicates if search details were viewed.
keywordIndustryFocuskeywordIndustryFocus stringstring O setor a ser pesquisado, por exemplo, na área de saúde.The industry to search within, for example, healthcare.
mpnIdmpnId stringstring A ID de Microsoft Partner Network (MPN).The Microsoft Partner Network (MPN) ID. Para um revendedor direto, esse parâmetro será a ID de MPN do parceiro.For a direct reseller, this parameter will be the MPN ID of the partner. Para um revendedor indireto, esse parâmetro será a ID de MPN do revendedor indireto.For an indirect reseller, this parameter will be the MPN ID of the indirect reseller.
partnerMarketpartnerMarket stringstring Localidade onde o parceiro conduz os negócios.Locale where the partner conducts business.
keywordProductkeywordProduct stringstring O produto especificado na pesquisa.The product specified in the search.
referralSubmittedreferralSubmitted BooleanBoolean Indica se uma referência foi enviada.Indicates if a referral was submitted.
searchDatesearchDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format Data em que ocorreu a consulta de pesquisa.Date when the search query occurred.
keywordSearchTextkeywordSearchText stringstring O texto especificado na pesquisa.The text specified in the search.
searchResultPageViewssearchResultPageViews longlong Número de vezes que o parceiro surgiu no resultado da pesquisa.Number of times the partner came up in the search result. Parte de uma resposta somente na agregação.Part of a response only on aggregation.
contactClickscontactClicks longlong Número de vezes que o botão de contato foi clicado.Number of times the contact button was clicked. Parte de uma resposta somente na agregação.Part of a response only on aggregation.
referralCountreferralCount longlong Número de referências geradas pela pesquisa.Number of referrals generated from the search. Parte de uma resposta somente na agregação.Part of a response only on aggregation.
profileViewsprofileViews longlong Número de vezes que o perfil de parceiro foi exibido.Number of times the partner profile was viewed. Parte de uma resposta somente na agregação.Part of a response only on aggregation.

Análise de referênciasReferrals analytics

Observação

A associação do programa CSP não é necessária para obter a análise de referências.CSP program membership isn't required to get referrals analytics.

O cenário a seguir mostra como usar a API de análise para recuperar todas as informações de análise de referências do Partner Center.The following scenario shows you how to use the Analytics API to retrieve all your Partner Center referrals analytics information.

Esse cenário retorna as informações de análise em uma coleção de recursos de referências .This scenario returns your analytics information in a collection of Referrals resources.

Observação

A análise de referências não está disponível para o Partner Center operado pela 21Vianet.Referrals analytics are not available to the Partner Center operated by 21Vianet.

Recurso de referênciasReferrals resource

Representa todos os dados analíticos de uma referência.Represents all of the analytical data for a referral.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring O identificador do locatário do cliente.The customer tenant identifier.
statusstatus stringstring Indica se a referência levou a um cliente.Indicates if the referral led to a customer.
customerMarketcustomerMarket stringstring O país/região no qual o cliente faz negócios.The country/region that the customer does business in.
customerNamecustomerName stringstring O nome do cliente.The name of the customer.
customerOrgSizecustomerOrgSize stringstring Um intervalo que indica o número de funcionários na organização do cliente.A range indicating the number of employees in the customer's organization. Por exemplo, "10to50employees".For example, "10to50employees".
acceptedDateacceptedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi aceita.The date that the referral was accepted.
acknowledgedDateacknowledgedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi confirmada.The date that the referral was acknowledged.
archivedDatearchivedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi arquivada.The date that the referral was archived.
declinedDatedeclinedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi recusada.The date that the referral was declined.
expiredDateexpiredDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência expirou.The date that the referral expired.
lostDatelostDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi perdida.The date that the referral was lost.
missedDatemissedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi perdida.The date that the referral was missed.
createdDatecreatedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi criada.The date that the referral was created.
skippedDateskippedDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi ignorada.The date that the referral was skipped.
wonDatewonDate cadeia de caracteres no formato de data e hora em UTCstring in UTC date time format A data em que a referência foi ganha.The date that the referral was won.
partnerMarketpartnerMarket stringstring O país/região no qual o parceiro faz negócios.The country/region that the partner does business in.