Notas de versão do SDK do .NET

  • Artigo

As seguintes notas de versão estão disponíveis para novas versões do Microsoft Partner Center .NET SDK. 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 .NET.

Importante

A partir de junho de 2023, a versão 3.4.0 mais recente do SDK do .NET do Partner Center foi arquivada. Você pode baixar a versão do SDK do GitHub, juntamente com um arquivo readme 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. Exemplos atualizados do GitHub também estão disponíveis.

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

Transacionar e gerenciar

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

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. Exemplos atualizados do GitHub também estão disponíveis.

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

Transacionar e gerenciar

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

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

Novas mensagens de erro GDAP:

Auditar

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. Exemplos atualizados do GitHub também 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 altamente vulneráveis.

Novos contratos de APIs

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

Atualizações do contrato da API

Versão 3.1.2

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

Atualização do contrato público

Adicionado o AddOnMigrations campo ao NewCommerceEligibility objeto
Validar uma subscrição 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. Exemplos atualizados do GitHub também estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Transacionar e gerenciar

Novo domínio 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 SDK para o valor de status da assinatura 'desativado'.

As APIs do Partner Center começarão a retornar novos estados 'desativados' após 90 dias a partir do lançamento do SDK v3.1.1. Os parceiros têm 90 dias antes que a API retorne o estado "desativado" 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 de eventos de migração Get New Commerce é usada para buscar os detalhes dos eventos de migração com base na ID de assinatura ou 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. Exemplos atualizados do GitHub também estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Transacionar e gerenciar

Novo domínio 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
    • Novos valores de enum adicionados CartErrorCode
    • Adicionado novo AdditionalInformation modelo ao CartError modelo
    • Propriedade adicionada CustomTermEndDateCartLineItem ao modelo
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Novos valores de enum adicionados CartErrorCode
    • 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 de aplicativo de exemplo do SDK .NET de código aberto simplificada
  • 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 DAP API – Para remover DAP set AllowDelegatedAccess propriedade para false

Auditoria e webhook

Auditoria atualizada - Adicionados novos tipos de operação para "Gerenciar excedente", "Relação de administrador de DAP encerrada pela Microsoft" e "Evento de fraude do Azure detetado".

Recursos de auditoria

Versão 3.0.0

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

Atualizações comuns

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

Transacionar 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 domínio 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 domínio 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}

Cliente

Nova API

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

Auditoria e webhook

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

Recursos de auditoria - Desenvolvedor de aplicativos do Partner Center | Documentos Microsoft

  • 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. Exemplos atualizados do GitHub também estão disponíveis. As seguintes alterações estão incluídas nesta versão:

Nota

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 pré-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 da Biblioteca de Autenticação do Ative Directory do Azure (ADAL) para a 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 aplicações móveis e de ambiente de trabalho

    • Adicione Domínio à seção UserAuthentication no arquivo de configuração do aplicativo.

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

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

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

Gerir faturação

  • Itens de linha da 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:

    • productQualificadores
    • assinaturaStartDate
    • assinaturaData de Fim
    • referenceId
    • creditReasonCode (aplicável apenas às DNO)
    • promotionId

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

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

    Novos atributos:

    • hasPartnerEarnedCredit (aplicável apenas a NCE)
    • tipo de crédito (aplicável apenas às DNO)
    • taxOfCredit (aplicável apenas às DNO)

Gerir encomendas

  • Recursos de assinatura – Nova propriedade adicionada.

    • CancellationAllowedUntilDate - (Apenas aplicável a NCE)

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

    • FromSubscriptionId

Gerir 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:

    • EndereçoValidationResponse

  • 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. Exemplos atualizados do GitHub também 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 recursos e operações para dar suporte ao cenário de função de diretório de clientes

    • 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}/qualificações
    • POST /clientes/{customer_id}/qualifications?code={validationCode}

  • Seguindo 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}/assinaturas
      • 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. Exemplos atualizados do GitHub também 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. Exemplos atualizados do GitHub também estão disponíveis. As seguintes alterações estão incluídas nesta versão:

  • Atualize os tipos de operação suportados para o Registro de Auditoria. Os recém-adicionados são:

    • CreateSelfServePolicy
    • UpdateSelfServePolicy
    • DeleteSelfServePolicy
    • RemovePartnerRelationship
    • ExcluirDicaCliente
    • CreateRelatedReferral
    • UpdateRelatedReferral

  • A criação de solicitações 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. Exemplos atualizados do GitHub também 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 que usam o .NET Framework 4.6.1 e superior. O SDK suporta .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:

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