Partager via

Obtenir des blocs de mise à niveau pour votre application de bureau

Utilisez cet URI REST pour obtenir des informations sur les appareils Windows 10 et Windows 11 sur lesquels votre application de bureau bloque l’exécution d’une mise à niveau windows 10 ou Windows 11. Vous pouvez utiliser cet URI uniquement pour les applications de bureau que vous avez ajoutées au programme d’application de bureau Windows . Ces informations sont également disponibles dans le rapport des blocs d'application pour les applications de bureau dans le Centre de partenaires.

Pour obtenir des détails sur les blocs de périphérique pour un exécutable donné dans votre application de bureau, consultez Obtenir les détails du bloc de mise à niveau pour votre application de bureau.

Conditions préalables

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

  • Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API d’analytique du Microsoft Store.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

Requête

Syntaxe de la requête

Méthode URI de la requête
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Paramètre Catégorie Descriptif Obligatoire
applicationId ficelle ID de produit de l’application de bureau pour laquelle vous souhaitez récupérer des données de bloc. Pour obtenir l’ID de produit d’une application de bureau, ouvrez n’importe quel rapport d’analyse pour votre application de bureau dans l’Espace partenaires (par exemple, le rapport Blocs) et récupérez l’ID de produit à partir de l’URL. Oui
date de début date Date de début dans la plage de dates des données de bloc à récupérer. La valeur par défaut est de 90 jours avant la date actuelle. Non
date de fin date La date de fin dans la plage de dates du bloc de données à récupérer. La valeur par défaut est la date actuelle. Non
Haut de page Int Nombre de lignes de données à retourner dans la requête. La valeur maximale et la valeur par défaut si elle n’est pas spécifiée est 1 0000. S’il existe plus de lignes dans la requête, le corps de la réponse inclut un lien suivant que vous pouvez utiliser pour demander la page suivante de données. Non
passer Int Nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir des jeux de données volumineux. Par exemple, top=10000 et skip=0 récupère les 1 000 premières lignes de données, top=10000 et skip=10000 récupère les 1 0000 lignes de données suivantes, et ainsi de suite. Non
Filter ficelle Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un nom de champ à partir du corps de la réponse et une valeur associés aux opérateurs eq ou ne, et les instructions peuvent être combinées à l’aide et ou ou. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre . Vous pouvez spécifier les champs suivants à partir du corps de la réponse :

  • version de l'application
  • architecture
  • type de bloc
  • type d'appareil
  • nomDuFichier
  • marché
  • osRelease
  • osVersion
  • NomDuProduit
  • cibleOS
 Non
classer par ficelle Instruction qui trie les valeurs de données de résultat pour chaque bloc. La syntaxe est orderby=field [order],field [order],.... Le paramètre de champ peut être l’un des champs suivants du corps de la réponse :

  • version de l'application
  • architecture
  • type de bloc
  • date
  • type d'appareil
  • nomDuFichier
  • marché
  • osRelease
  • osVersion
  • NomDuProduit
  • cibleOS
  • nombre d'appareils

Le paramètre d’ordre est facultatif et peut être asc ou desc pour spécifier l’ordre croissant ou décroissant pour chaque champ. La valeur par défaut est asc.

Voici un exemple de chaîne orderby : orderby=date,market

 Non
grouppar ficelle Instruction qui applique l’agrégation de données uniquement aux champs spécifiés. Vous pouvez spécifier les champs suivants à partir du corps de la réponse :

  • version de l'application
  • architecture
  • type de bloc
  • type d'appareil
  • nomDuFichier
  • marché
  • osRelease
  • osVersion
  • cibleOS

Les lignes de données retournées contiennent les champs spécifiés dans le paramètre groupby , ainsi que les éléments suivants :

  • applicationId
  • date
  • NomDuProduit
  • nombre d'appareils

 Non

Exemple de requête

L’exemple suivant illustre plusieurs demandes d’obtention de données de bloc d’application de bureau. Remplacez la valeur applicationId par l’ID de produit de votre application de bureau.

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>

Réponse

Corps de réponse

Valeur Catégorie Descriptif
Valeur tableau Tableau d'objets contenant des données de bloc agrégées. Pour plus d’informations sur les données de chaque objet, consultez le tableau suivant.
@nextLink ficelle S’il existe des pages de données supplémentaires, cette chaîne contient un URI que vous pouvez utiliser pour demander la page suivante des données. Par exemple, cette valeur est retournée si le paramètre premier de la requête est défini sur 1 0000, mais qu’il existe plus de 1 0000 lignes de données de bloc pour la requête.
NombreTotal Int Nombre total de lignes dans le résultat des données de la requête.

Les éléments du tableau Valeur contiennent les valeurs suivantes.

Valeur Catégorie Descriptif
applicationId ficelle ID de produit de l’application de bureau pour laquelle vous avez récupéré des données de bloc.
date ficelle Date associée à la valeur d’accès au bloc.
Nom du produit ficelle Nom affiché de l’application de bureau dérivé des métadonnées des exécutables qui lui sont associés.
Nom de fichier ficelle Exécutable qui a été bloqué.
version de l'application ficelle Version de l’exécutable de l’application qui a été bloquée.
osVersion ficelle Une des chaînes suivantes qui spécifie la version du système d’exploitation sur laquelle l’application de bureau est en cours d’exécution :

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Inconnu
osRelease ficelle L’une des chaînes suivantes spécifie la version du système d’exploitation ou l’anneau de déploiement (comme un sous-groupe dans la version du système d’exploitation) sur lequel l’application de bureau est en cours d’exécution.

Pour Windows 11 : version 2110

Pour Windows 10 :

  • version 1507
  • version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Aperçu de la version
  • Rapide pour les initiés
  • Initié Lent

Pour Windows Server 1709 :

  • RTM

Pour Windows Server 2016 :

  • Version 1607

Pour Windows 8.1 :

  • Mise à jour 1

Pour Windows 7 :

  • Pack de Service 1

Si la version du système d’exploitation ou l’anneau de distribution est inconnu, ce champ a la valeur Inconnu.
marché ficelle Code pays ISO 3166 du marché dans lequel l’application de bureau est bloquée.
type de dispositif ficelle Une des chaînes suivantes qui spécifie le type d’appareil sur lequel l’application de bureau est bloquée :

  • PC
  • Serveur
  • Tablette
  • Inconnu
type de bloc ficelle Une des chaînes suivantes qui spécifie le type de bloc trouvé sur l’appareil :

  • Sédiments potentiels
  • Sédiment temporaire
  • Notification d'exécution

Pour plus d’informations sur ces types de blocs et ce qu’ils signifient pour les développeurs et les utilisateurs, consultez la description du rapport des blocs d’applications .
architecture ficelle Architecture de l’appareil sur lequel le bloc existe :

  • ARM64
  • X86
targetOs ficelle L’une des chaînes suivantes qui spécifie la version du système d’exploitation Windows 10 ou Windows 11 sur laquelle l’application de bureau est bloquée de s’exécuter :

  • Version 1709
  • version 1803
nombre d'appareils nombre Nombre d’appareils distincts qui ont des blocs au niveau d’agrégation spécifié.

Exemple de réponse

L’exemple suivant illustre un exemple de corps de réponse JSON pour cette requête.

{
  "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
}
  • Last updated on