Notas de la versión del SDK de .NET

  • Article

Las notas de la versión siguientes están disponibles para las nuevas versiones del SDK de .NET del Centro de partners de Microsoft. Puede encontrar ejemplos del SDK de .NET en GitHub. Puede encontrar la referencia de api de .NET del Centro de partners en el explorador de API de .NET.

Importante

A partir de junio de 2023, la versión 3.4.0 más reciente del SDK de .NET del Centro de partners ahora está archivada. Puede descargar esta versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

Se recomienda a los partners seguir usando las API REST del Centro de partners.

Versión 3.4.0

El SDK de .NET del Centro de partners de Microsoft v3.4.0 ya está disponible. También hay disponibles muestras de GitHub actualizadas.

Esta versión incluye los cambios siguientes:

Transacción y administración

Las SIGUIENTES API se actualizan para proporcionar propiedades de fecha y hora de finalización del término:

Pricing object ahora está presente en la siguiente respuesta de API:

Promociones

Exponer restricciones:

Versión 3.3.0

El SDK de .NET del Centro de partners de Microsoft v3.3.0 ya está disponible. También hay disponibles muestras de GitHub actualizadas.

Esta versión incluye los cambios siguientes:

Transacción y administración

Las SIGUIENTES API se actualizan para habilitar las cancelaciones de suscripciones de Azure si un cliente está en peligro (fraude):

'OperationId' ahora está presente en las siguientes respuestas de API:

Nuevos mensajes de error de GDAP:

Auditoría

Se ha agregado el nuevo tipo de recurso "AzureEntitlement" y "IndirectProviderIndirectResellerDap" para lo siguiente:

Versión 3.2.0

El SDK de .NET del Centro de partners de Microsoft v3.2.0 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas.

Esta versión incluye los cambios siguientes:

Para usar el SDK de .NET v 3.2.0, los asociados deben tener Newtonsoft.Json 13.0.1 y versiones posteriores. Como las versiones anteriores a v13.0.1 tienen errores vulnerables elevados.

Nuevos contratos de API

Las SIGUIENTES API se presentan para admitir la programación de migración de NCE:

Novedades al contrato de API

Versión 3.1.2

El SDK de .NET del Centro de partners de Microsoft v3.1.2 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Novedades al contrato público

Se agregó el AddOnMigrations campo al NewCommerceEligibility objeto .
Validar una suscripción para la migración

Versión 3.1.1

Importante

La versión 3.1.0 está en desuso. No descargue el SDK de .NET v.3.1.0

El SDK de .NET del Centro de partners de Microsoft v3.1.1 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Transacción y administración

Nuevo campo en el contrato público

Adición del identificador de promoción al cambio programado
Administración de cambios programados para nuevas suscripciones comerciales

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

Nueva compatibilidad del SDK con el valor de estado de la suscripción "disabled".

Las API del Centro de partners comenzarán a devolver nuevos estados "deshabilitados" después de 90 días desde la versión del SDK v3.1.1. Los partners tienen 90 días antes de que la API devuelva el estado "deshabilitado" para darles tiempo para actualizar sus SDK y cumplir con los principios de administración de cambios.

Nueva Novedades de API

Las suscripciones migradas de consultas son la API donde los asociados pueden consultar todos los subs migrados para un criterio de entrada determinado.

  • GET {baseURL}/v1/migrations/newcommerce

Get New Commerce migration events API (Obtener eventos de migración de New Commerce) se usa para capturar los detalles de los eventos de migración en función del identificador de suscripción actual o del identificador de migración.

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

Versión 3.0.1

El SDK de .NET del Centro de partners de Microsoft v3.0.1 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Transacción y administración

Nuevo campo en el contrato público

  • 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}
    • Se agregó RefundableQuantity la propiedad al Subscription modelo.
    • Se agregó CustomTermEndDate la propiedad al ScheduledNextTermInstructions modelo.
    • Se agregó MigratedFromSubscriptionId la propiedad al Subscription modelo.
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Se agregó AddOnMigrations la propiedad al NewCommerceMigration modelo.
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Se agregó AddOnMigrations la propiedad al NewCommerceMigration modelo.
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Se agregó AddOnMigrations la propiedad al NewCommerceMigration modelo.
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Se han agregado nuevos CartErrorCode valores de enumeración
    • Se ha agregado un nuevo AdditionalInformation modelo al CartError modelo
    • Se agregó CustomTermEndDate la propiedad al CartLineItem modelo.
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Se han agregado nuevos CartErrorCode valores de enumeración
    • Se ha agregado un nuevo AdditionalInformation modelo al CartError modelo
    • Se agregó CustomTermEndDate la propiedad al CartLineItem modelo.
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Se agregó CustomTermEndDate la propiedad al OrderLineItem modelo.
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Se agregó CustomTermEndDate la propiedad al OrderLineItem modelo.

Herramienta de migración por lotes de NCE

Para facilitar las necesidades de asociados de migrar de forma eficaz grandes cantidades de suscripciones, hemos habilitado una herramienta de migración por lotes (BAM). La herramienta BAM permite a los asociados migrar suscripciones a NCE mediante el siguiente enfoque:

  • Experiencia de aplicación de ejemplo de SDK de .NET optimizada código abierto
  • Usa Excel para administrar las modificaciones de migración
  • Herramienta sencilla que admite escenarios de migración de alta calidad, repetibles y personalizables en lotes

Para obtener instrucciones detalladas, consulte New Commerce Experience Batch Migration Tool (BAM).

Seguridad

Nueva API

  • Revisión {baseURL}/v1/customers/{customer-tenant-id}
    • Eliminación de la API de DAP: para quitar la propiedad establecida AllowDelegatedAccess de DAP en false

Auditoría y webhook

Auditoría actualizada: se han agregado nuevos tipos de operación para "Administrar uso por encima del límite", "DAP Administración relación terminada por Microsoft" y "Evento de fraude de Azure detectado".

Auditoría de recursos

Versión 3.0.0

El SDK de .NET del Centro de partners de Microsoft v3.0.0 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Actualizaciones comunes

Actualice System.ComponentModel.Annotations a la versión 5.0 más reciente para resolver los problemas de compatibilidad existentes.

Transacción y administración

Nueva 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

Nuevo campo en el contrato público

  • 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, precio y promoción

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

Nuevo campo en el contrato público

  • 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

Nueva API

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

Auditoría y webhook

Auditoría actualizada: se han agregado nuevos tipos de operación para Add SoftwareAttestation y Add Device and Policy Novedades

Recursos de auditoría: desarrollador de aplicaciones del Centro de partners | 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

Versión 2.0.1

El SDK de .NET del Centro de partners de Microsoft v2.0.1 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Nota:

Algunos de los cambios introducidos como parte de Nuevas experiencias comerciales ("NCE") que están disponibles actualmente en función de la invitación solo a los partners que forman parte de la nueva experiencia comercial de Microsoft 365/Microsoft Dynamics 365 technical Preview. Los partners que no forman parte de la versión preliminar privada de New commerce no deben tener en cuenta los impactos y deben ser compatibles con versiones anteriores.

Común

  • Cambio en la referencia a la biblioteca de autenticación: la referencia se cambia de la biblioteca de autenticación de Azure Active Directory (ADAL) a la biblioteca de autenticación de Microsoft (MSAL)

    Se deben realizar los siguientes cambios para asegurarse de que MSAL se ejecuta correctamente en la aplicación o en el ejemplo de .NET:

    • Agregar https://login.microsoftonline.com/common/oauth2/nativeclient como RedirectUrl para aplicaciones móviles y de escritorio

    • Agregue dominio a la sección UserAuthentication en el archivo de configuración de la aplicación.

      El dominio es el dominio de Azure Active Directory o el identificador de inquilino donde se creó la aplicación de Azure AD.

  • Códigos de error: nuevo código de error agregado

    • 408: Tiempo de espera de solicitud
    • 504: tiempo de espera de puerta de enlace

Administración de facturas

  • Elementos de línea de factura: nuevos atributos agregados a las siguientes API:

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

    Nuevos atributos:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (solo aplicable a NCE)
    • promotionId

  • Uso de elementos de línea clasificados diariamente: nuevos atributos agregados a la SIGUIENTE API:

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

    Nuevos atributos:

    • hasPartnerEarnedCredit (solo aplicable a NCE)
    • creditType (solo aplicable a NCE)
    • rateOfCredit (solo aplicable a NCE)

Administrar pedidos

  • Recursos de suscripción: nueva propiedad agregada.

    • CancellationAllowedUntilDate: (solo aplicable a NCE)

  • Recursos de transición (solo aplicables a NCE): nueva propiedad agregada

    • FromSubscriptionId

Administra las cuentas de cliente

  • Validar una dirección: la respuesta cambia de un valor booleano a un nuevo modelo para la API:

    • POST /validations/address

    Nuevo modelo de respuesta:

    • AddressValidationResponse

  • La API sincrónica de calificación del cliente está en desuso.

Versión 1.17.0

El SDK de .NET del Centro de partners de Microsoft v1.17.0 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

  • Auditoría actualizada: se han agregado nuevos tipos de operación para saber cuándo el cliente ha aprobado y terminado DAP.

  • Auditoría actualizada: se han agregado nuevos tipos de recursos y operaciones para admitir el escenario de rol de directorio de clientes.

  • SDK Novedades a la cuenta de clientes: compatibilidad con las siguientes API

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

  • Los siguientes cambios introducidos como parte de New Commerce que están disponibles actualmente en función de la invitación solo a los partners que forman parte de la nueva experiencia comercial de Microsoft 365/Microsoft Dynamics 365 technical preview. Los partners que no forman parte de la versión preliminar privada de New commerce no deben observar impactos y deben ser compatibles con versiones anteriores.

    • Cambios en el catálogo:
      • GET /products/{product-id}/skus/{sku-id}
    • Comprar y administrar:
      • 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

Versión 1.16.3

El SDK de .NET del Centro de partners de Microsoft v1.16.3 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Versión 1.16.2

El SDK de .NET del Centro de partners de Microsoft v1.16.2 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

  • actualización de los tipos de operación compatibles con el registro de auditoría. Las recién agregadas son:

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

  • La creación de solicitudes de servicio está en desuso.

  • Los temas de soporte técnico están en desuso.

Versión 1.16.1

El SDK de .NET del Centro de partners de Microsoft v1.16.1 ahora está disponible con carácter general. También hay disponibles muestras de GitHub actualizadas. Esta versión incluye los cambios siguientes:

Hemos migrado el SDK del Centro de partners de Microsoft existente de .NET Framework a la plataforma de .NET Standard 2.0. Esta migración hará que el SDK sea compatible con las aplicaciones existentes mediante .NET Framework 4.6.1 y versiones posteriores. El SDK admite .NET Core 2.0 y versiones posteriores. Compruebe la compatibilidad con la implementación de .NET antes de migrarla a las aplicaciones existentes.

Versión 1.15.3

El SDK de .NET del Centro de partners de Microsoft v1.15.3 ahora está disponible con carácter general. También están disponibles las API REST actualizadas y los ejemplos de GitHub. Esta versión incluye los cambios siguientes:

  • Contrato de asociado
  • Productos
    • Las dos interfaces siguientes se colocaron incorrectamente en el espacio de nombres Microsoft.Store.PartnerCenter.Products. Ahora, se encuentran en el espacio de nombres Microsoft.Store.PartnerCenter.Customers.Products.
      • ICustomerProductByReservationScope
      • ICustomerSkuByReservationScope