Obtener bloques de actualización de la aplicación de escritorio
Usa este URI rest para obtener información sobre los dispositivos Windows 10 y Windows 11 en los que la aplicación de escritorio está bloqueando la ejecución de una actualización de Windows 10 o Windows 11. Puedes usar este URI solo para aplicaciones de escritorio que hayas agregado al programa Aplicación de escritorio de Windows. Esta información también está disponible en el informe Bloques de aplicaciones para aplicaciones de escritorio en el Centro de partners.
Para obtener detalles sobre los bloques de dispositivos para un archivo ejecutable específico en la aplicación de escritorio, consulte Obtención de los detalles del bloque de actualización de la aplicación de escritorio.
Requisitos previos
Para usar este método, primero debes hacer lo siguiente:
- Si aún no lo has hecho, completa todos los requisitos previos de la API de análisis de Microsoft Store.
- Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
Solicitar
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits |
Encabezado de solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| Autorización | string | Necesario. Token de acceso de Azure AD con el formato Token<de portador>. |
Parámetros de solicitud
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| applicationId | string | Identificador de producto de la aplicación de escritorio para la que desea recuperar datos de bloque. Para obtener el identificador de producto de una aplicación de escritorio, abra cualquier informe de análisis de la aplicación de escritorio en el Centro de partners (como el informe Bloques) y recupere el identificador de producto de la dirección URL. | Sí |
| startDate | date | Fecha de inicio en el intervalo de fechas de los datos de bloque que se van a recuperar. El valor predeterminado es 90 días antes de la fecha actual. | No |
| endDate | date | Fecha de finalización del intervalo de fechas de los datos de bloque que se van a recuperar. La fecha actual es el valor predeterminado. | No |
| superior | int | Número de filas de datos que se van a devolver en la solicitud. Si no se especifica, el valor predeterminado y el valor máximo es 10000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo “Siguiente” que puedes usar para solicitar la siguiente página de datos. | No |
| skip | int | Número de filas que se omiten en la consulta. Usa este parámetro para pasar de página en conjuntos de datos grandes. Por ejemplo, top=10000 y skip=0 recupera las primeras 10000 filas de datos, top=10000 y skip=10000 recupera las siguientes 10000 filas de datos, etc. | No |
| filter | string | Una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un nombre de campo del cuerpo de la respuesta y el valor que están asociados a los operadores eq o ne, y las instrucciones se pueden combinar mediante y u o. Los valores de cadena deben estar entre comillas simples en el parámetro de filtro. Puedes especificar los campos siguientes desde el cuerpo de la respuesta:
|
No |
| orderby | string | Instrucción que ordena los valores de datos de resultados para cada bloque. La sintaxis es orderby=field [order],field [order],.... El parámetro field puede ser uno de los campos siguientes del cuerpo de la respuesta:
El parámetro order es opcional y puede ser asc o desc para especificar el orden ascendente o descendente de cada campo. El valor predeterminado es asc. Este es un ejemplo de cadena orderby: orderby=date,market |
No |
| groupby | string | Instrucción que aplica la agregación de datos solo a los campos especificados. Puedes especificar los campos siguientes desde el cuerpo de la respuesta:
Las filas de datos devueltas contendrán los campos especificados en el parámetro groupby, además de los siguientes:
|
No |
Ejemplo de solicitud
En el ejemplo siguiente se muestran varias solicitudes para obtener datos de bloqueo de aplicaciones de escritorio. Reemplace el valor applicationId por el identificador del producto de su aplicación de escritorio.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&skip=0 HTTP/1.1
Authorization: Bearer <your access token>
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>
Respuesta
Cuerpo de la respuesta
| Valor | Tipo | Descripción |
|---|---|---|
| Valor | array | Matriz de objetos que contienen datos de bloque agregados. Para obtener más información sobre los datos de cada objeto, consulta la siguiente tabla. |
| @nextLink | string | Si hay páginas adicionales de datos, esta cadena contiene un URI que se puede usar para solicitar la siguiente página de datos. Por ejemplo, este valor se devuelve si el parámetro superior de la solicitud se establece en 10000, pero hay más de 10000 filas de datos de bloque para la consulta. |
| TotalCount | int | Número total de filas que figura en el resultado de datos de la consulta. |
Los elementos de la matriz Value contienen los valores siguientes.
| Valor | Tipo | Descripción |
|---|---|---|
| applicationId | string | Identificador de producto de la aplicación de escritorio para la que recuperó datos de bloque. |
| date | string | Fecha asociada al valor de aciertos del bloque. |
| productName | string | Nombre para mostrar de la aplicación de escritorio como se deriva de los metadatos de los ejecutables asociados. |
| fileName | string | Archivo ejecutable que se bloqueó. |
| applicationVersion | string | Versión del ejecutable de la aplicación que se bloqueó. |
| osVersion | string | Una de las siguientes cadenas que especifica la versión del sistema operativo en la que se ejecuta actualmente la aplicación de escritorio:
|
| osRelease | string | Una de las siguientes cadenas que especifica la versión del sistema operativo o el anillo de distribución piloto (como subpoblación dentro de la versión del sistema operativo) en la que se está ejecutando la aplicación de escritorio. Para Windows 11: versión 2110 Para Windows 10:
Para Windows Server 1709:
Para Windows Server 2016:
Para Windows 8.1:
Para Windows 7:
Si se desconoce la versión del sistema operativo o el anillo de distribución de paquestes piloto, este campo tiene el valor Desconocido. |
| market | string | Código de país ISO 3166 del mercado en el que se bloquea la aplicación de escritorio. |
| deviceType | string | Una de las siguientes cadenas que especifica el tipo de dispositivo en el que se bloquea la aplicación de escritorio:
|
| blockType | string | Una de las siguientes cadenas que especifica el tipo de bloque que se encuentra en el dispositivo:
|
| Arquitectura | string | La arquitectura del dispositivo en el que existe el bloque:
|
| targetOs | string | Una de las siguientes cadenas que especifica la versión del sistema operativo Windows 10 o Windows 11 en la que se bloquea la ejecución de la aplicación de escritorio:
|
| deviceCount | number | Número de dispositivos distintos que tienen bloques en el nivel de agregación especificado. |
Ejemplo de respuesta
En el ejemplo siguiente se muestra un ejemplo de cuerpo de respuesta en formato JSON para esta solicitud.
{
"Value": [
{
"applicationId": "10238467886765136388",
"date": "2018-06-03",
"productName": "Contoso Demo",
"fileName": "contosodemo.exe",
"applicationVersion": "2.2.2.0",
"osVersion": "Windows 8.1",
"osRelease": "Update 1",
"market": "ZA",
"deviceType": "All",
"blockType": "Runtime Notification",
"architecture": "X86",
"targetOs": "RS4",
"deviceCount": 120
}
],
"@nextLink": "desktop/blockhits?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
"TotalCount": 23012
}
Temas relacionados
- Programa de aplicaciones de escritorio de Windows
- Get upgrade block details for your desktop application (Obtener detalles de bloques de actualización para la aplicación de escritorio)