Share via

Cambios recientes en las API REST del Centro de partners

  • Artículo

En este artículo se resumen los cambios realizados en las API REST del Centro de partners.

Noviembre de 2022

Área de características Tipo de cambio API/objetos
Migración de NCE Los asociados ahora pueden programar migraciones mediante la herramienta UX y BAM de la API. Programar una nueva migración comercial Cancelar una nueva migración

de comercio Actualizar una nueva migración



de comercio Obtener una nueva migración

comercial Nueva herramienta de migración por lotes de experiencia comercial

Octubre de 2022

Los cambios de API admiten nuevas funcionalidades y agregan campos benefitOrderId, benefitId y benefitType a los datos de uso facturados y no facturados diariamente.

Área de características Tipo de cambio API/objetos
Mejora de la directiva de autoservicio Nueva compatibilidad con directivas de autoservicio para el plan de ahorro de Azure. Creación de una directivade autoservicio Obtención de una lista de directivasde autoservicio Obtener una directiva de autoservicio: actualización de unadirectiva de autoservicio
Datos de uso valorados diariamente facturados Agregue los campos benefitOrderId, benefitId y benefitType a la API de uso nominal diaria facturada. Obtención de los elementos de línea de consumo comercial facturados
Datos de uso no facturados diarios Agregue los campos benefitOrderId, benefitId y benefitType a la API de uso nominal diaria no facturada. Obtención de elementos de línea de consumo comercial sin facturar

Septiembre de 2022

Cambios de PI para agregar campos firstObserved y lastObserved a eventos De fraude.

Área de características Tipo de cambio API/objetos
Migración de NCE CustomTermEndDate se agrega a la API de migración Crear una migración comercial
Notificación de fraude de Azure Agregar campos firstObserved y lastObserved a eventos de fraude Obtener eventos de fraude

Julio de 2022

Los cambios de API admiten nuevas funcionalidades.

Área de características Tipo de cambio API/objetos
Cambios programados con promoción Exponga el identificador de promoción si el cambio programado se alinea con la promoción disponible. Creación de cambios programados

Junio de 2022

Los cambios de API admiten asociados con la migración de NCE.

Área de características Tipo de cambio API/objetos
Validación de la migración Nueva API para validar una suscripción para la migración a Nueva experiencia comercial Validar una suscripción para la migración
Creación de una nueva migración Nueva API para crear una migración de una suscripción a New Commerce Experience Crear una migración comercial
Obtención de una nueva migración de una suscripción de comercio Nueva API para obtener una migración de una suscripción a New Commerce Experience para comprobar el estado de la migración Obtención de una nueva migración de una suscripción de comercio

Mayo de 2022

Los cambios de API admiten asociados para supervisar DAP y quitar DAP inactivos.

Área de características Tipo de cambio API/objetos
Eliminación de DAP Quite una relación de administrador delegado (DAP) con un cliente que ya no necesite administrar. Quitar una relación DAP con un cliente
Enumerar relaciones de Administración delegadas Nueva API para devolver una lista de todos los clientes de un asociado, que también indica si los clientes tienen una relación DAP/no DAP Enumerar clientes de Administración delegados
Obtener estadísticas de Administración delegadas Devuelve información sobre el recuento de relaciones de administrador delegado (DAP) establecidas o activas asociadas a un asociado en todos sus clientes. Obtener estadísticas de Administración delegadas

Marzo de 2022

Los cambios de marzo incluyen mejoras para admitir nuevas características basadas en licencias comerciales.

Área de características Tipo de cambio API/objetos
Eliminación de DAP Quite una relación de administrador delegado (DAP) con un cliente que ya no necesite administrar. Quitar una relación DAP con un cliente
Nuevo carro comercial Se ha agregado availableQuantity para la respuesta CartLineItem. Recurso de promociones
Nueva transición comercial Se ha agregado promotionId a la respuesta de transición. Recurso de transiciones

Diciembre de 2021

Los cambios de diciembre incluyen mejoras para admitir nuevas características basadas en licencias comerciales.

Área de características Tipo de cambio API/objetos
Nuevas promociones de comercio Se ha agregado availableSeats a seatcounts. Recurso de promociones
Nuevas promociones de comercio Se ha agregado availableSeats a seatcounts. POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
Notificación de fraude de Azure Nueva API Obtener eventos de fraude
Notificación de fraude de Azure Nueva API Actualizar el estado de los eventos de fraude
Nuevas suscripciones de comercio Se ha agregado refundableQuantity a Get Subscription by ID API OBTENER suscripción por identificador

Octubre de 2021

Los cambios de octubre son admitir nuevas características basadas en licencias comerciales y los nuevos descuentos de margen de ISV para CSP.

Área de características Tipo de cambio API/objetos
Nueva administración de suscripciones comerciales Nuevo campo en el contrato público PATCH {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}
Nuevas actualizaciones comerciales y conversiones de prueba Nuevo campo en el contrato público POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
Nuevas transiciones comerciales Nuevo campo en el contrato público GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
Migración a un nuevo comercio Nueva API POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
Migración a un nuevo comercio Nueva API POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
Migración a un nuevo comercio Nueva API GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
Compra de nuevos comercios Nuevo campo en el contrato público POST {baseURL}/v1/customers/{customer-id}/orders"
Compra de nuevos comercios Nuevo campo en el contrato público POST{baseURL}/v1/customers/{customer-id}/carts
Compra de nuevos comercios Nuevo campo en el contrato público PUT{baseURL}/v1/customers/{customer-id}/carts/{cart-id}
Nuevas promociones de comercio Nueva API POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
Nuevas promociones de comercio Nueva API GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
Nuevas promociones de comercio Nueva API GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}
Nuevas promociones de comercio Nuevo recurso Recurso de promociones
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}?country={country}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}
Actualizaciones del catálogo para el nuevo comercio Nuevo campo en el contrato público Recursos del producto
Descuentos de margen de ISV para CSP Nuevo recurso Recurso margin
Descuentos de margen de ISV para CSP Nueva API GET {baseURL}/v1/margin
Descuentos de margen de ISV para CSP Nueva API GET {baseURL}/v1/margin/download
Telecomunicaciones de pago por uso en el nuevo comercio Nueva API PUT {baseURL}/customers/{customerId}/subscriptions/overage
Telecomunicaciones de pago por uso en el nuevo comercio Nueva API GET {baseURL}/customers/{customerId}/subscriptions/overage
Telecomunicaciones de pago por uso en el nuevo comercio Nuevo campo en el contrato público Adición de ConsumptionType al modelo de SKU

Julio de 2021

Los cambios de julio eran compatibles con la atestación de Windows 365 necesaria solo para algunas SKU de Windows 365.

Área de características Tipo de cambio API/objetos
Atestación de Windows 365 Nuevo campo en el contrato público Recurso de SKU
Atestación de Windows 365 Nuevo campo en el contrato público Recurso de oferta
Atestación de Windows 365 Nuevo campo en el contrato público Recurso de elemento de línea de carro
Atestación de Windows 365 Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
Atestación de Windows 365 Nuevo campo en el contrato público GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
Atestación de Windows 365 Nuevo campo en el contrato público PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id} HTTP/1.1

Diciembre de 2020

Se introdujeron dos nuevas API de calificaciones GET y POST. Las nuevas API usarán calificaciones, no cualificación. Las API estarán disponibles para las pruebas en FY21 Q2.

Área de características Tipo de cambio API/objetos
Calificación del cliente Nueva API GET {baseURL}/v1/customers/{customer-tenant-id}/qualifications
Calificación del cliente Nueva API POST {baseURL}/v1/customers/{customer_id}/qualifications?code={validationCode}

¿Qué ha cambiado?

Actualmente, la API del Centro de partners tiene calificaciones GET y PUT para comprobar la idoneidad de los clientes de Educación. No habrá ningún cambio en la API de calificación GET. Sin embargo, hemos agregado un caso de devolución a put Qualification API.

  • GET: no cambia.
  • PUT: se agregará el caso devuelto.

Estas API se retirarán a finales de febrero de 2021, para reemplazarlas por nuevas API, como se describe a continuación.

Escenarios afectados:

Idoneidad del cliente para los precios de educación en las SKU select

Descripciones detalladas

Se incorporarán dos nuevas API de calificaciones GET y POST. Las nuevas API usarán calificaciones, no cualificación. Las API estarán disponibles para las pruebas en FY21 Q2.

Obtener calificaciones

GET {customer_id}/qualifications

Ejemplo de respuesta:

{
  "Qualification": "Education",
  "VettingStatus": "Denied",
  "VettingReason": "Not an education customer",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

Campos de respuesta:

  • Valores de VettingStatus: Aprobado, Denegado, InReview, etc.

  • Valores de VettingReason:

    • No es un cliente educativo
    • Ya no es un cliente de Educación
    • No un cliente educativo: después de la revisión
    • Restringido ser un cliente educativo
    • No un dominio académico
    • No es una biblioteca apta
    • No un Museo apto

Calificaciones POST

POST {customer_id}/qualifications
    [
            "Qualification": "Education"
    ]

Ejemplo de respuesta:

{
  "Qualification": "Education",
  "VettingStatus": "InReview",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

Pasos siguientes

Referencia de API REST del Centro de partners