Notas de versão do SDK do .NET

  • Artigo

As notas de versão a seguir estão disponíveis para novas versões do SDK do Microsoft Partner Center .NET. Você pode encontrar exemplos do SDK do .NET no GitHub. Você pode encontrar a referência da API .NET do Partner Center no Navegador da API do .NET.

Importante

A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do Partner Center .NET foi arquivada. Você pode baixar a versão do SDK no GitHub, juntamente com um arquivo leiame que contém informações úteis.

Os parceiros são incentivados a continuar a usar as APIs REST do Partner Center.

Versão 3.4.0

Microsoft Partner Center .NET SDK v3.4.0 já está disponível. As amostras do GitHub também já estão disponíveis.

As seguintes alterações estão incluídas nesta versão:

Fazer transações e gerenciar

As APIs a seguir são atualizadas para fornecer propriedades de data e hora de término do termo:

Pricing object agora está presente na resposta da API abaixo:

Promoções

Expor restrições:

Versão 3.3.0

Microsoft Partner Center .NET SDK v3.3.0 já está disponível. As amostras do GitHub também já estão disponíveis.

As seguintes alterações estão incluídas nesta versão:

Fazer transações e gerenciar

As seguintes APIs são atualizadas para habilitar cancelamentos de assinatura do Azure se um cliente for comprometido (fraude):

'OperationId' agora está presente nas respostas de API abaixo:

Novas mensagens de erro GDAP:

Auditoria

O novo tipo de recurso 'AzureEntitlement' e 'IndirectProviderIndirectResellerDap' foi adicionado para o seguinte:

Versão 3.2.0

Microsoft Partner Center .NET SDK v3.2.0 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis.

As seguintes alterações estão incluídas nesta versão:

Para usar o .NET SDK v 3.2.0, os parceiros precisam ter Newtonsoft.Json 13.0.1 e superior. Como as versões anteriores à v13.0.1 têm bugs de alta vulnerabilidade.

Novos contratos de APIs

As seguintes APIs são introduzidas para dar suporte ao agendamento de migração NCE:

Atualizações no contrato de API

Versão 3.1.2

Microsoft Partner Center .NET SDK v3.1.2 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Actualização do contrato público

Adicionado o AddOnMigrations campo ao NewCommerceEligibility objeto
Validar uma assinatura para migração

Versão 3.1.1

Importante

A versão 3.1.0 foi preterida. Não baixe o .NET SDK v.3.1.0

Microsoft Partner Center .NET SDK v3.1.1 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Fazer transações e gerenciar

Novo campo dos contratos públicos

Adicionar ID de promoção à alteração agendada
Gerenciar alterações agendadas para novas assinaturas de comércio

  • Patch {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}

Novo suporte do SDK para o valor de status da assinatura 'desabilitado'.

As APIs do Partner Center começarão a retornar novos estados 'desabilitados' após 90 dias da versão do SDK v3.1.1. Os parceiros têm 90 dias antes que a API retorne o estado "desabilitado" para dar tempo de atualizar seus SDKs e cumprir os princípios de gerenciamento de alterações.

Novas atualizações de API

Consultar assinaturas migradas é a API onde os parceiros podem consultar todos os subs migrados para um determinado critério de entrada.

  • GET {baseURL}/v1/migrations/newcommerce

A API Get New Commerce migration events é usada para buscar os detalhes dos eventos de migração com base na ID de assinatura ou na ID de migração atual.

  • GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events

Versão 3.0.1

Microsoft Partner Center .NET SDK v3.0.1 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Fazer transações e gerenciar

Novo campo dos contratos públicos

  • POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
  • GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
  • GET/PATCH {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}
    • Propriedade adicionada RefundableQuantitySubscription ao modelo
    • Propriedade adicionada CustomTermEndDateScheduledNextTermInstructions ao modelo
    • Propriedade adicionada MigratedFromSubscriptionIdSubscription ao modelo
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Propriedade adicionada AddOnMigrationsNewCommerceMigration ao modelo
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Propriedade adicionada AddOnMigrationsNewCommerceMigration ao modelo
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Propriedade adicionada AddOnMigrationsNewCommerceMigration ao modelo
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Adicionados novos CartErrorCode valores de enum
    • Adicionado novo AdditionalInformation modelo ao CartError modelo
    • Propriedade adicionada CustomTermEndDateCartLineItem ao modelo
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Adicionados novos CartErrorCode valores de enum
    • Adicionado novo AdditionalInformation modelo ao CartError modelo
    • Propriedade adicionada CustomTermEndDateCartLineItem ao modelo
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Propriedade adicionada CustomTermEndDateOrderLineItem ao modelo
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Propriedade adicionada CustomTermEndDateOrderLineItem ao modelo

Ferramenta de migração em lote NCE

Para facilitar as necessidades dos parceiros de migrar com eficiência grandes quantidades de assinaturas, habilitamos uma ferramenta de migração em lote (BAM). A ferramenta BAM permite que os parceiros migrem assinaturas para o NCE usando a seguinte abordagem:

  • Experiência simplificada de aplicativo de exemplo do SDK do .NET de código aberto
  • Usa o Excel para gerenciar edições de migração
  • Ferramenta simples que suporta cenários de migração de alta qualidade, repetíveis e personalizáveis em lotes

Para obter instruções detalhadas, consulte New Commerce Experience Batch Migration Tool (BAM).

Segurança

Nova API

  • Patch {baseURL}/v1/customers/{customer-tenant-id}
    • Remover API DAP – Para remover a propriedade DAP set AllowDelegatedAccess como false

Auditoria e webhook

Auditoria atualizada - Adicionados novos tipos de operação para "Gerenciar excesso", "Relacionamento de administrador do DAP encerrado pela Microsoft" e "Evento de fraude do Azure detectado".

Recursos de auditoria

Versão 3.0.0

Microsoft Partner Center .NET SDK v3.0.0 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Atualizações comuns

Atualize o System.ComponentModel.Annotations para a versão 5.0 mais recente para resolver os problemas de compatibilidade existentes.

Fazer transações e gerenciar

Nova API

  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
  • GET {baseURL}/customers/{customerId}/subscriptions/overage

Novo campo dos contratos públicos

  • PATCH {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}
  • POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
  • GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
  • POST/PUT {baseURL}/v1/customers/{customer-tenant-id}/cart
  • POST {baseURL}/v1/customers/{customer-tenant-id}/orders
  • PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id}

Catálogo/preço/promoção

Nova API

  • POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
  • GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
  • GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}

Novo campo dos contratos públicos

  • GET {baseURL}/v1/offers/{offer-id}?country={country-code}
  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
  • GET {baseURL}/v1/products/{product-id}?country={country}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}

Customer

Nova API

  • GET {baseURL}/v1/customers/{customer-id}/validationStatus?type=account

Auditoria e webhook

Auditoria Atualizada - Adicionados novos tipos de operação para Adicionar SoftwareAtestado e Adicionar Atualizações de Dispositivo e Política

Recursos de auditoria – desenvolvedor de aplicativos do Partner Center | Microsoft Docs

  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
  • GET {baseURL}/v1/products/{product-id}?country={country}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}
  • PUT {baseURL}/customers/{customerId}/subscriptions/overage
  • GET {baseURL}/customers/{customerId}/subscriptions/overage

Versão 2.0.1

Microsoft Partner Center .NET SDK v2.0.1 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Observação

Algumas das alterações introduzidas como parte das Novas Experiências de Comércio ("NCE") que estão atualmente disponíveis com base no convite apenas para parceiros que fazem parte da visualização técnica da nova experiência de comércio do Microsoft 365/Microsoft Dynamics 365. Os parceiros que não fazem parte da visualização privada do Novo Comércio não devem notar impactos e devem ser compatíveis com versões anteriores.

Comum

  • Alteração na referência à biblioteca de autenticação – A referência é alterada de Biblioteca de Autenticação do Active Directory do Azure (ADAL) para Biblioteca de Autenticação da Microsoft (MSAL)

    As seguintes alterações devem ser feitas para garantir que o MSAL seja executado corretamente em seu aplicativo ou exemplo .NET:

    • Adicionar https://login.microsoftonline.com/common/oauth2/nativeclient como RedirectUrl para aplicativos móveis e de desktop

    • Adicione Domain à seção UserAuthentication no arquivo de configuração do aplicativo.

      Domínio é o domínio do Active Directory do Azure ou a ID do locatário onde o aplicativo do Azure AD foi criado

  • Códigos de erro – Novo código de erro adicionado

    • 408: Tempo limite da solicitação
    • 504: Tempo limite do gateway

Gerenciar a cobrança

  • Itens de linha de fatura - novos atributos adicionados às seguintes APIs:

    • GET /invoices/{invoice-id}/lineitems?provider={provider}&invoicelineitemtype=billinglineitems
    • GET /invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=billinglineitems

    Novos atributos:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (Aplicável apenas a NCE)
    • promotionId

  • Itens de linha de uso avaliado diário – novos atributos adicionados à seguinte API:

    • GET /invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems

    Novos atributos:

    • hasPartnerEarnedCredit (Aplicável apenas a NCE)
    • creditType (Aplicável apenas a NCE)
    • taxOfCredit (Aplicável apenas a NCE)

Gerenciar ordens

  • Recursos de assinatura – Nova propriedade adicionada.

    • CancelamentoPermitidoUntilDate - (Aplicável somente a NCE)

  • Recursos de transição (aplicável somente ao NCE) – Nova propriedade adicionada

    • FromSubscriptionId

Gerenciar contas de clientes

  • Validar um endereço – A resposta é alterada de um Booleano para um novo modelo para API:

    • POST /validations/address

    Novo modelo de resposta:

    • AddressValidationResponse

  • A API síncrona de qualificação do cliente foi preterida.

Versão 1.17.0

Microsoft Partner Center .NET SDK v1.17.0 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

  • Auditoria atualizada - Adicionados novos tipos de operação para saber quando o cliente aprovou e encerrou o DAP

  • Auditoria atualizada – Adicionados novos tipos de recurso e operação para dar suporte ao cenário de função de diretório do cliente

    • Tipo de recurso "CustomerDirectoryRole"
    • Tipos de operação "AddUserMember" e "RemoveUserMember"

  • Atualizações do SDK para a conta de clientes - Suporte para as seguintes APIs

    • GET /customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus
    • GET /customers/{customer-tenant-id}/qualifications
    • POST /customers/{customer_id}/qualifications?code={validationCode}

  • Após as alterações introduzidas como parte do New Commerce que estão atualmente disponíveis com base no convite apenas para parceiros que fazem parte da visualização técnica da nova experiência de comércio do Microsoft 365/Microsoft Dynamics 365. Os parceiros que não fazem parte da visualização privada do Novo Comércio não devem notar impactos e devem ser compatíveis com versões anteriores.

    • Alterações no catálogo:
      • GET /products/{product-id}/skus/{sku-id}
    • Compre e gerencie:
      • GET /customers/{customerId}/subscriptions
      • GET /customers/{customerId}/subscriptions/{subscriptionId}
      • PATCH /customers/{customerId}/subscriptions/{subscriptionId}
      • GET /customers/{customerId}/subscriptions/{subscriptionId}/transitioneligibilities
      • GET /customers/{customerId}/subscriptions/{subscriptionId}/transitions
      • POST /customers/{customerId}/subscriptions/{subscriptionId}/transitions

Versão 1.16.3

Microsoft Partner Center .NET SDK v1.16.3 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Versão 1.16.2

Microsoft Partner Center .NET SDK v1.16.2 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

  • Atualização dos tipos de operações compatíveis com o Registro de Auditoria. Os recém-adicionados são:

    • CreateSelfServePolicy
    • UpdateSelfServePolicy
    • DeleteSelfServePolicy
    • RemovePartnerRelationship
    • DeleteTipCustomer
    • CreateRelatedReferral
    • UpdateRelatedReferral

  • A criação de solicitação de serviço foi preterida

  • Os tópicos de suporte foram preteridos

Versão 1.16.1

Microsoft Partner Center .NET SDK v1.16.1 agora é disponibilidade geral. As amostras do GitHub também já estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Migramos o SDK existente do Microsoft Partner Center do .NET Framework para a plataforma .NET Standard 2.0. Essa migração tornará o SDK compatível com aplicativos existentes usando o .NET Framework 4.6.1 e superior. O SDK oferece suporte ao .NET Core 2.0 e superior. Verifique o suporte à implementação do .NET antes de portá-lo para aplicativos existentes.

Versão 1.15.3

Microsoft Partner Center .NET SDK v1.15.3 agora é disponibilidade geral. APIs REST atualizadas e exemplos do GitHub também estão disponíveis. As seguintes alterações estão incluídas nesta versão:

  • Acordo de Parceria
  • Produtos
    • As duas interfaces a seguir foram colocadas incorretamente no namespace Microsoft.Store.PartnerCenter.Products. Agora, eles estão localizados no namespace Microsoft.Store.PartnerCenter.Customers.Products.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope