Obtención de una matriz de ofertas
En este artículo se explica cómo obtener una matriz de ofertas durante un mes determinado. La matriz de ofertas incluye propiedades y reglas de compra para los productos y sku. Este método admite filtros para obtener el historial por mes.
Requisitos previos
- Credenciales tal como se describe en el artículo Autenticación de la API de partners. Este escenario solo admite la autenticación de usuario de la aplicación. Todavía no se admite la aplicación. Los asociados que experimentan un error http:400 deben consultar la documentación de autenticación de la API de partners.
- Actualmente, esta API solo admite el acceso de usuario donde los asociados deben estar en uno de los siguientes roles: Global Administración, agente de Administración o Agente de ventas.
Detalles
- Current devuelve datos solo para los nuevos productos basados en licencias comerciales actualizados.
- Los precios actuales incluyen productos disponibles durante el mes actual hasta la fecha en que se llama a la API. Los meses anteriores incluyen la fecha a partir del último día del mes seleccionado.
- Este método devuelve datos como una secuencia de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip de .csv. A continuación se incluyen detalles sobre cómo solicitar archivos comprimidos.
Solicitud REST
Sintaxis de la solicitud
Método | URI de solicitud |
---|---|
GET | https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value |
Parámetros de filtro de URI
Use los siguientes parámetros de filtro.
Nombre | Type | Obligatorio | Descripción |
---|---|---|---|
Mes | string | No | Debe cumplir con YYYYYMM para la hoja de precios que se solicita. |
Encabezados de solicitud
- Consulte Encabezados REST de partners para obtener más información.
Además de los encabezados anteriores, los archivos de precios se pueden recuperar como comprimidos reduciendo el ancho de banda y los tiempos de descarga. De forma predeterminada, los archivos no están comprimidos. Para obtener versiones comprimidas de los archivos, puede incluir el valor de encabezado siguiente. Tenga en cuenta que las hojas comprimidas solo están disponibles a partir de abril de 2020, todas las hojas anteriores a abril de 2020 solo están disponibles como no comprimidas.
Encabezado | Tipo de valor | Value | Descripción |
---|---|---|---|
Accept-Encoding | string | deflate | Opcional. Si no se omite la secuencia de archivos no está comprimida. |
Ejemplo de solicitud
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
Respuesta REST
Si se ejecuta correctamente, este método devuelve una matriz de ofertas como una secuencia de archivos. La secuencia de archivos es un archivo .csv o una versión comprimida zip de .csv.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.
Ejemplo de respuesta
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries"
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============
Pasos siguientes
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