Notes de publication du Kit de développement logiciel (SDK) .NET

  • Article

Les notes de publication suivantes sont disponibles pour les nouvelles versions du Kit de développement logiciel (SDK) .NET de l’Espace partenaires Microsoft. Vous trouverez des exemples du Kit de développement logiciel (SDK) .NET sur GitHub. Vous trouverez la référence de l’API .NET de l’Espace partenaires dans le navigateur d’API .NET.

Important

Depuis juin 2023, la dernière version du Kit de développement logiciel (SDK) .NET de l’Espace partenaires version 3.4.0 est désormais archivée. Vous pouvez télécharger la version du SDK à partir de GitHub, ainsi qu’un fichier lisezmoi contenant des informations utiles.

Les partenaires sont encouragés à continuer à utiliser les API REST de l’Espace partenaires.

Version 3.4.0

Microsoft Partner Center .NET SDK v3.4.0 est désormais disponible. Des exemples GitHub mis à jour sont également disponibles.

Les modifications suivantes sont incluses dans cette version :

Transaction et gestion

Les API suivantes sont mises à jour pour fournir des propriétés de date de fin de terme :

Pricing object est maintenant présent dans la réponse de l’API ci-dessous :

Promotions

Exposer des contraintes :

Version 3.3.0

Microsoft Partner Center .NET SDK v3.3.0 est désormais disponible. Des exemples GitHub mis à jour sont également disponibles.

Les modifications suivantes sont incluses dans cette version :

Transaction et gestion

Les API suivantes sont mises à jour pour activer les annulations d’abonnement Azure si un client est compromis (fraude) :

'OperationId' est maintenant présent dans les réponses d’API ci-dessous :

Nouveaux messages d’erreur GDAP :

Audit

Le nouveau type de ressource « AzureEntitlement » et « IndirectProviderIndirectResellerDap » a été ajouté pour les éléments suivants :

Version 3.2.0

Microsoft Partner Center .NET SDK v3.2.0 est désormais en disponibilité générale. Des exemples GitHub mis à jour sont également disponibles.

Les modifications suivantes sont incluses dans cette version :

Pour utiliser le Kit de développement logiciel (SDK) .NET v 3.2.0, les partenaires doivent disposer de Newtonsoft.Json 13.0.1 et versions ultérieures. Comme les versions antérieures à la version 13.0.1 ont des bogues vulnérables élevés.

Nouveaux contrats d’API

Les API suivantes sont introduites pour prendre en charge la planification de la migration de NCE :

Mises à jour au contrat d’API

Version 3.1.2

Microsoft Partner Center .NET SDK v3.1.2 est désormais disponible en général. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Mises à jour au contrat public

Ajout du AddOnMigrations champ à l’objet NewCommerceEligibility
Valider un abonnement pour la migration

Version 3.1.1

Important

La version 3.1.0 est dépréciée. Ne pas télécharger le Kit de développement logiciel (SDK) .NET v.3.1.0

Microsoft Partner Center .NET SDK v3.1.1 est désormais en disponibilité générale. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Transaction et gestion

Nouveau champ dans un contrat public

Ajouter un ID de promotion à la modification planifiée
Gérer les modifications planifiées pour les nouveaux abonnements commerciaux

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

Nouvelle prise en charge du Kit de développement logiciel (SDK) pour la valeur d’état de l’abonnement « disabled ».

Les API de l’Espace partenaires commencent à retourner de nouveaux états « désactivés » après 90 jours à partir de la version du Kit de développement logiciel (SDK) v3.1.1. Les partenaires ont 90 jours avant que l’API retourne l’état « désactivé » pour leur donner le temps de mettre à jour leurs SDK et de se conformer aux principes de gestion des modifications.

Nouvelle Mises à jour d’API

Les abonnements migrés de requête sont l’API où les partenaires peuvent interroger tous les sous-titres migrés pour obtenir des critères d’entrée donnés.

  • GET {baseURL}/v1/migrations/newcommerce

L’API Obtenir les événements de migration New Commerce est utilisée pour extraire les détails des événements de migration en fonction de l’ID d’abonnement actuel ou de l’ID de migration.

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

Version 3.0.1

Microsoft Partner Center .NET SDK v3.0.1 est désormais en disponibilité générale. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Transaction et gestion

Nouveau champ dans un contrat public

  • 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}
    • Ajout RefundableQuantity de la propriété au Subscription modèle
    • Ajout CustomTermEndDate de la propriété au ScheduledNextTermInstructions modèle
    • Ajout MigratedFromSubscriptionId de la propriété au Subscription modèle
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Ajout AddOnMigrations de la propriété au NewCommerceMigration modèle
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Ajout AddOnMigrations de la propriété au NewCommerceMigration modèle
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Ajout AddOnMigrations de la propriété au NewCommerceMigration modèle
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Ajout de nouvelles CartErrorCode valeurs d’énumération
    • Ajout d’un nouveau AdditionalInformation modèle au CartError modèle
    • Ajout CustomTermEndDate de la propriété au CartLineItem modèle
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Ajout de nouvelles CartErrorCode valeurs d’énumération
    • Ajout d’un nouveau AdditionalInformation modèle au CartError modèle
    • Ajout CustomTermEndDate de la propriété au CartLineItem modèle
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Ajout CustomTermEndDate de la propriété au OrderLineItem modèle
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Ajout CustomTermEndDate de la propriété au OrderLineItem modèle

Outil de migration par lots NCE

Pour faciliter les besoins des partenaires de migrer efficacement de grandes quantités d’abonnements, nous avons activé un outil bam (Batch Migration). L’outil BAM permet aux partenaires de migrer des abonnements vers NCE à l’aide de l’approche suivante :

  • Expérience d’application simplifiée code source ouvert sdk .NET
  • Utilise Excel pour gérer les modifications de migration
  • Outil simple prenant en charge des scénarios de migration haute qualité, reproductibles et personnalisables dans des lots

Pour obtenir des instructions détaillées, consultez New Commerce Experience Batch Migration Tool (BAM).

Sécurité

Nouvelle API

  • Correctif {baseURL}/v1/customers/{customer-tenant-id}
    • Supprimer l’API DAP : pour supprimer la propriété DAP set AllowDelegatedAccess sur false

Audit et webhook

Audit mis à jour - Ajout de nouveaux types d’opérations pour « Gérer le dépassement », « DAP Administration relation terminée par Microsoft » et « Événement de fraude Azure détecté ».

Audit des ressources

Version 3.0.0

Microsoft Partner Center .NET SDK v3.0.0 est désormais en disponibilité générale. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Mises à jour communes

Mettez à niveau System.ComponentModel.Annotation vers la dernière version 5.0 pour résoudre les problèmes de compatibilité existants.

Transaction et gestion

Nouvelle 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

Nouveau champ dans un contrat public

  • 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}

Catalogue/prix/promotion

Nouvelle 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}

Nouveau champ dans un contrat public

  • 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}

Client

Nouvelle API

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

Audit et webhook

Audit mis à jour - Ajout de nouveaux types d’opérations pour Ajouter SoftwareAttestation et Ajouter un appareil et une stratégie Mises à jour

Audit des ressources - Développeur d’applications de l’Espace partenaires | 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

Version 2.0.1

Microsoft Partner Center .NET SDK v2.0.1 est désormais en disponibilité générale. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Remarque

Certaines modifications introduites dans le cadre des nouvelles expériences commerciales (« NCE ») actuellement disponibles en fonction de l’invitation uniquement aux partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 nouvelle expérience commerciale en préversion technique. Les partenaires qui ne font pas partie de la préversion privée new commerce ne doivent pas remarquer d’impact et doivent être rétrocompatibles.

Courant

  • Modification de la référence à la bibliothèque d’authentification : la référence est modifiée de la bibliothèque d’authentification Azure Active Directory (ADAL) à la bibliothèque d’authentification Microsoft (MSAL)

    Les modifications suivantes doivent être apportées pour vous assurer que MSAL s’exécute correctement sur votre application ou l’exemple .NET :

    • Ajouter https://login.microsoftonline.com/common/oauth2/nativeclient en tant que RedirectUrl pour les applications mobiles et de bureau

    • Ajoutez un domaine à la section UserAuthentication dans votre fichier de configuration d’application.

      Le domaine est le domaine Azure Active Directory ou l’ID de locataire où l’application Azure AD a été créée

  • Codes d’erreur – Nouveau code d’erreur ajouté

    • 408 : Délai d’expiration de la demande
    • 504 : Délai d’expiration de la passerelle

Gérer la facturation

  • Éléments de ligne de facture : nouveaux attributs ajoutés aux API suivantes :

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

    Nouveaux attributs :

    • ProductQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (applicable uniquement à NCE)
    • promotionId

  • Lignes d’utilisation évaluées quotidiennement : nouveaux attributs ajoutés à l’API suivante :

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

    Nouveaux attributs :

    • hasPartnerEarnedCredit (applicable uniquement à NCE)
    • creditType (applicable uniquement à NCE)
    • rateOfCredit (applicable uniquement à NCE)

Gérer les commandes

  • Ressources d’abonnement : nouvelle propriété ajoutée.

    • CancellationAllowedUntilDate - (applicable uniquement à NCE)

  • Ressources de transition (applicable uniquement à NCE) : nouvelle propriété ajoutée

    • FromSubscriptionId

Gérer des comptes client

  • Valider une adresse : la réponse est remplacée d’une valeur booléenne à un nouveau modèle pour l’API :

    • POST /validations/address

    Nouveau modèle de réponse :

    • AddressValidationResponse

  • L’API synchrone de qualification du client est déconseillée.

Version 1.17.0

Microsoft Partner Center .NET SDK v1.17.0 est désormais une disponibilité générale. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

  • Audit mis à jour - Ajout de nouveaux types d’opérations pour savoir quand le client a approuvé et arrêté DAP

  • Audit mis à jour : ajout de nouveaux types de ressources et d’opérations pour prendre en charge le scénario de rôle d’annuaire client

  • Kit de développement logiciel (SDK) Mises à jour au compte clients - Prise en charge des API suivantes

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

  • Suite aux modifications introduites dans le cadre de New Commerce qui sont actuellement disponibles en fonction de l’invitation uniquement aux partenaires qui font partie de Microsoft 365/Microsoft Dynamics 365 new commerce experience technical preview. Les partenaires qui ne font pas partie de la préversion privée new commerce ne doivent pas remarquer d’impact et doivent être rétrocompatibles.

    • Modifications du catalogue :
      • GET /products/{product-id}/skus/{sku-id}
    • Acheter et gérer :
      • 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

Version 1.16.3

Microsoft Partner Center .NET SDK v1.16.3 est désormais disponible en général. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Version 1.16.2

Microsoft Partner Center .NET SDK v1.16.2 est désormais disponible en général. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

  • Mise à jour des types d’opération pris en charge pour l’enregistrement d’audit. Les nouveaux ajouts sont les suivants :

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

  • La création d’une demande de service est maintenant déconseillée.

  • Les rubriques de support sont désormais déconseillées.

Version 1.16.1

Microsoft Partner Center .NET SDK v1.16.1 est désormais en disponibilité générale. Des exemples GitHub mis à jour sont également disponibles. Les modifications suivantes sont incluses dans cette version :

Nous avons migré le SDK Microsoft Partner Center existant de .NET Framework vers la plateforme .NET Standard 2.0. Cette migration rend le SDK compatible avec les applications existantes à l’aide de .NET Framework 4.6.1 et versions ultérieures. Le SDK prend en charge .NET Core 2.0 et versions ultérieures. Vérifiez la prise en charge de l’implémentation .NET avant de la porter vers des applications existantes.

Version 1.15.3

Microsoft Partner Center .NET SDK v1.15.3 est désormais une disponibilité générale. Les API REST mises à jour et les exemples GitHub sont également disponibles. Les modifications suivantes sont incluses dans cette version :

  • Contrat partenaire
  • Produits
    • Les deux interfaces suivantes ont été incorrectement placées sous l’espace de noms Microsoft.Store.PartnerCenter.Products. À présent, ils se trouvent sous l’espace de noms Microsoft.Store.PartnerCenter.Customers.Products.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope