Notas de la versión del SDK de .NET
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):
- Plan de Azure: administración de suscripciones y recursos
- Cancelación de una suscripción de Azure: desarrollador de aplicaciones del Centro de partners
- Gastos de Azure: cancelación de un derecho de Azure: API REST (REST del Centro de partners)
- Obtención de un derecho de Azure para una suscripción: desarrollador de aplicaciones del Centro de partners
- Gastos de Azure: obtención de un derecho de Azure para una suscripción: API REST (REST del Centro de partners)
'OperationId' ahora está presente en las siguientes respuestas de API:
- Transición de una nueva suscripción comercial: desarrollador de aplicaciones de partners
- Obtiene el historial de transición de una nueva suscripción comercial con transición anterior: desarrollador de aplicaciones de partners
Nuevos mensajes de error de GDAP:
- Transición de una suscripción: desarrollador de aplicaciones asociadas
- Transición de una nueva suscripción comercial: desarrollador de aplicaciones de partners
- Obtención del estado de aprovisionamiento de suscripciones: desarrollador de aplicaciones asociadas
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:
- Programación de una migración comercial nueva
- Cancelación de una migración comercial nueva
- Actualización de una migración comercial nueva
- Obtener una migración comercial nueva
Novedades al contrato de API
API de calificaciones: contrato público actualizado con tres nuevos campos: "EducationSegment", "Website", "ValidationCode" Actualizar las calificaciones de un cliente
Estado de validación: "lastUpdateDatetime" se cambia de DateTime a String Recupera el estado de validación de un cliente.
Directiva de autoservicio: nuevo valor "AzureSavingsPlan" compatible con resource en el objeto Permission Create a self-serve policy (Creación de una directiva de autoservicio)
Migración: se introdujo el campo "customTermEndDate" Creación de una nueva migración comercial
Recurso de suscripción: nuevo atributo "BillingCycleEndDate" agregado recursos de suscripción
Se ha agregado el nuevo tipo de error "NoPromotionsAvailableEligibilityError" y se ha agregado la propiedad "AvailableSeats" a la propiedad "SeatCountPromotionEligibilityError" Verify a promotion eligibility
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 alSubscription
modelo. - Se agregó
CustomTermEndDate
la propiedad alScheduledNextTermInstructions
modelo. - Se agregó
MigratedFromSubscriptionId
la propiedad alSubscription
modelo.
- Se agregó
POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
- Se agregó
AddOnMigrations
la propiedad alNewCommerceMigration
modelo.
- Se agregó
POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
- Se agregó
AddOnMigrations
la propiedad alNewCommerceMigration
modelo.
- Se agregó
GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
- Se agregó
AddOnMigrations
la propiedad alNewCommerceMigration
modelo.
- Se agregó
POST {baseURL}/v1/customers/{customer_id}/carts
- Se han agregado nuevos
CartErrorCode
valores de enumeración - Se ha agregado un nuevo
AdditionalInformation
modelo alCartError
modelo - Se agregó
CustomTermEndDate
la propiedad alCartLineItem
modelo.
- Se han agregado nuevos
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 alCartError
modelo - Se agregó
CustomTermEndDate
la propiedad alCartLineItem
modelo.
- Se han agregado nuevos
GET/POST {baseURL}/v1/customers/{customer_id}/orders
- Se agregó
CustomTermEndDate
la propiedad alOrderLineItem
modelo.
- Se agregó
GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
- Se agregó
CustomTermEndDate
la propiedad alOrderLineItem
modelo.
- Se agregó
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
- Eliminación de la API de DAP: para quitar la propiedad establecida
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".
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 escritorioAgregue 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.
- Tipo de recurso "CustomerDirectoryRole"
- Tipos de operación "AddUserMember" y "RemoveUserMember"
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
- Cambios en el catálogo:
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:
SelfServePolicies: nueva funcionalidad agregada
Perfil de empresa de clientes
- Se agregó el valor OrganizationRegistrationNumber.
CustomerBillingProfile.DefaultAddress
- Se agregó el valor MiddleName.
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
- Se ha agregado la capacidad de los proveedores indirectos para comprobar el estado del Contrato de partners de Microsoft de revendedores indirectos.
- 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
- 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.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de