Recuperare i dettagli dei blocchi di aggiornamento per l'applicazione desktopGet upgrade block details for your desktop application

Usare questo URI REST per ottenere i dettagli per i dispositivi Windows 10 in cui un file eseguibile specifico nell'applicazione desktop sta bloccando l'esecuzione di un aggiornamento di Windows 10.Use this REST URI to get details for Windows 10 devices on which a specific executable in your desktop application is blocking a Windows 10 upgrade from running. È possibile utilizzare questo URI solo per le applicazioni desktop aggiunte al programma applicazione desktop di Windows.You can use this URI only for desktop applications that you have added to the Windows Desktop Application program. Queste informazioni sono disponibili anche nel report blocchi applicazione per le applicazioni desktop nel centro per i partner.This information is also available in the Application blocks report for desktop applications in Partner Center.

Questo URI è simile per ottenere i blocchi di aggiornamento per l'applicazione desktop, ma restituisce informazioni sul blocco del dispositivo per un file eseguibile specifico nell'applicazione desktop.This URI is similar to Get upgrade blocks for your desktop application, but it returns device block info for a specific executable in your desktop application.

PrerequisitiPrerequisites

Per usare questo metodo, devi prima eseguire le operazioni seguenti:To use this method, you need to first do the following:

  • Se non è già stato fatto, completare tutti i prerequisiti per l'API di analisi del Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Ottieni un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo.Obtain an Azure AD access token to use in the request header for this method. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza.After you obtain an access token, you have 60 minutes to use it before it expires. Dopo la scadenza del token, puoi ottenerne uno nuovo.After the token expires, you can obtain a new one.

RichiestaRequest

Sintassi della richiestaRequest syntax

MetodoMethod URI richiestaRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails

Intestazione della richiestaRequest header

IntestazioneHeader TipoType DescrizioneDescription
AutorizzazioneAuthorization stringstring Obbligatorio.Required. Il token di accesso Azure ad nel token di connessione del modulo < token > .The Azure AD access token in the form Bearer <token>.

Parametri della richiestaRequest parameters

ParametroParameter TipoType DescrizioneDescription ObbligatorioRequired
applicationIdapplicationId stringstring ID prodotto dell'applicazione desktop per cui si desidera recuperare i dati del blocco.The product ID of the desktop application for which you want to retrieve block data. Per ottenere l'ID prodotto di un'applicazione desktop, aprire un report di analisi per l'applicazione desktop in centro per i partner (ad esempio il report blocchi) e recuperare l'ID prodotto dall'URL.To get the product ID of a desktop application, open any analytics report for your desktop application in Partner Center (such as the Blocks report) and retrieve the product ID from the URL. Yes
fileNamefileName stringstring Nome del file eseguibile bloccatoThe name of the blocked executable
startDatestartDate Datadate Data di inizio nell'intervallo di date dei dati del blocco da recuperare.The start date in the date range of block data to retrieve. Il valore predefinito è 90 giorni prima della data corrente.The default is 90 days prior to the current date. NoNo
endDateendDate Datadate Data di fine nell'intervallo di date dei dati del blocco da recuperare.The end date in the date range of block data to retrieve. L'impostazione predefinita è la data corrente.The default is the current date. NoNo
toptop INTint Numero di righe di dati da restituire nella richiesta.The number of rows of data to return in the request. Il valore massimo e il valore predefinito se non specificato è 10000.The maximum value and the default value if not specified is 10000. Se nella query sono presenti più righe, il corpo della risposta include un link successivo che puoi usare per richiedere la pagina successiva dei dati.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data. NoNo
skipskip INTint Numero di righe da ignorare nella query.The number of rows to skip in the query. Usa questo parametro per scorrere set di dati di grandi dimensioni.Use this parameter to page through large data sets. Ad esempio, top=10000 e skip=0 recupera le prime 10000 righe di dati, top=10000 e skip=10000 recupera le 10000 righe successive e così via.For example, top=10000 and skip=0 retrieves the first 10000 rows of data, top=10000 and skip=10000 retrieves the next 10000 rows of data, and so on. NoNo
filterfilter stringstring Una o più istruzioni per filtrare le righe nella risposta.One or more statements that filter the rows in the response. Ogni istruzione contiene un nome di campo dal corpo della risposta e il valore associati agli operatori EQ o ne e le istruzioni possono essere combinate tramite and o or.Each statement contains a field name from the response body and value that are associated with the eq or ne operators, and statements can be combined using and or or. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter.String values must be surrounded by single quotes in the filter parameter. È possibile specificare i campi seguenti dal corpo della risposta:You can specify the following fields from the response body:

  • applicationVersionapplicationVersion
  • architetturaarchitecture
  • blockTypeblockType
  • deviceTypedeviceType
  • mercatomarket
  • osReleaseosRelease
  • osVersionosVersion
  • productNameproductName
  • TargetOStargetOs
NoNo
orderbyorderby stringstring Istruzione che ordina i valori dei dati dei risultati per ogni blocco.A statement that orders the result data values for each block. La sintassi è OrderBy = Field [Order], Field [Order],.... Il parametro Field può essere uno dei campi seguenti del corpo della risposta:The syntax is orderby=field [order],field [order],.... The field parameter can be one of the following fields from the response body:

  • applicationVersionapplicationVersion
  • architetturaarchitecture
  • blockTypeblockType
  • datedate
  • deviceTypedeviceType
  • mercatomarket
  • osReleaseosRelease
  • osVersionosVersion
  • productNameproductName
  • TargetOStargetOs
  • deviceCountdeviceCount

Il parametro order è facoltativo e può essere asc o desc per specificare l’ordine crescente o decrescente per ogni campo.The order parameter is optional, and can be asc or desc to specify ascending or descending order for each field. Il valore predefinito è ASC.The default is asc.

Di seguito è riportato un esempio di stringa OrderBy : OrderBy = date, MarketHere is an example orderby string: orderby=date,market

NoNo
groupbygroupby stringstring Istruzione che applica l'aggregazione dei dati solo ai campi specificati.A statement that applies data aggregation only to the specified fields. È possibile specificare i campi seguenti dal corpo della risposta:You can specify the following fields from the response body:

  • applicationVersionapplicationVersion
  • architetturaarchitecture
  • blockTypeblockType
  • deviceTypedeviceType
  • mercatomarket
  • osReleaseosRelease
  • osVersionosVersion
  • TargetOStargetOs

Le righe di dati restituite conterranno i campi specificati nel parametro groupby, oltre ai seguenti:The returned data rows will contain the fields specified in the groupby parameter as well as the following:

  • applicationIdapplicationId
  • datedate
  • productNameproductName
  • deviceCountdeviceCount

NoNo

Esempio di richiestaRequest example

Nell'esempio seguente vengono illustrate diverse richieste di recupero dei dati del blocco di applicazioni desktop.The following example demonstrates several requests for getting desktop application block data. Sostituire il valore di ApplicationID con l'ID prodotto per l'applicazione desktop.Replace the applicationId value with the Product ID for your desktop application.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&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/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

RispostaResponse

Corpo della rispostaResponse body

ValoreValue TipoType DescrizioneDescription
ValoreValue arrayarray Matrice di oggetti che contengono dati di blocco aggregati.An array of objects that contain aggregate block data. Per ulteriori informazioni sui dati in ogni oggetto, vedere la tabella seguente.For more information about the data in each object, see the following table.
@nextLink stringstring In presenza di altre pagine di dati, questa stringa contiene un URI che puoi usare per richiedere la pagina successiva dei dati.If there are additional pages of data, this string contains a URI that you can use to request the next page of data. Questo valore, ad esempio, viene restituito se il parametro Top della richiesta è impostato su 10000 ma sono presenti più di 10000 righe di dati del blocco per la query.For example, this value is returned if the top parameter of the request is set to 10000 but there are more than 10000 rows of block data for the query.
TotalCountTotalCount INTint Numero totale di righe nei dati risultanti dalla query.The total number of rows in the data result for the query.

Gli elementi nella matrice Value contengono i valori seguenti.Elements in the Value array contain the following values.

ValoreValue TipoType DescrizioneDescription
applicationIdapplicationId stringstring ID prodotto dell'applicazione desktop per cui sono stati recuperati i dati del blocco.The product ID of the desktop application for which you retrieved block data.
Datadate stringstring La data associata al valore del blocco riscontri.The date associated with the block hits value.
productNameproductName stringstring Nome visualizzato dell'applicazione desktop derivato dai metadati degli eseguibili associati.The display name of the desktop application as derived from the metadata of its associated executable(s).
fileNamefileName stringstring Eseguibile bloccato.The executable that was blocked.
applicationVersionapplicationVersion stringstring Versione dell'eseguibile dell'applicazione bloccata.The version of the application executable that was blocked.
osVersionosVersion stringstring Una delle stringhe seguenti che specifica la versione del sistema operativo in cui è attualmente in esecuzione l'applicazione desktop:One of the following strings that specifies the OS version on which the desktop application is currently running:

  • Windows 7Windows 7
  • Windows 8.1Windows 8.1
  • Windows 10Windows 10
  • Windows Server 2016Windows Server 2016
  • Windows Server 1709Windows Server 1709
  • UnknownUnknown
osReleaseosRelease stringstring Una delle stringhe seguenti che specifica la versione del sistema operativo o l'anello di volo (come sottopopolazione nella versione del sistema operativo) in cui l'applicazione desktop è attualmente in esecuzione.One of the following strings that specifies the OS release or flighting ring (as a subpopulation within OS version) on which the desktop application is currently running.

Per Windows 10:For Windows 10:

  • Versione 1507Version 1507
  • Versione 1511Version 1511
  • Versione 1607Version 1607
  • Versione 1703Version 1703
  • Versione 1709Version 1709
  • Anteprima versioneRelease Preview
  • Insider veloceInsider Fast
  • Insider lentoInsider Slow

Per Windows Server 1709:For Windows Server 1709:

  • RTMRTM

Per Windows Server 2016:For Windows Server 2016:

  • Versione 1607Version 1607

Per Windows 8.1:For Windows 8.1:

  • Update 1Update 1

Per Windows 7:For Windows 7:

  • Service Pack 1Service Pack 1

Se la versione del sistema operativo o l'anello di volo è sconosciuto, questo campo presenta il valore Unknown.If the OS release or flighting ring is unknown, this field has the value Unknown.

marketmarket stringstring Il codice paese ISO 3166 del mercato in cui l'applicazione desktop è bloccata.The ISO 3166 country code of the market in which the desktop application is blocked.
deviceTypedeviceType stringstring Una delle stringhe seguenti che specifica il tipo di dispositivo in cui è bloccata l'applicazione desktop:One of the following strings that specifies the type of device on which the desktop application is blocked:

  • PCPC
  • ServerServer
  • TabletTablet
  • UnknownUnknown
blockTypeblockType stringstring Una delle stringhe seguenti che specifica il tipo di blocco trovato nel dispositivo:One of the following strings that specifies the type of block found on the device:

  • Sedi potenzialiPotential Sediment
  • Sedimentazione temporaneaTemporary Sediment
  • Notifica di runtimeRuntime Notification

Per ulteriori informazioni su questi tipi di blocchi e sul relativo significato per gli sviluppatori e gli utenti, vedere la descrizione del report blocchi applicazione.For more information about these block types and what they mean to developers and users, see the description of the Application blocks report.

architetturaarchitecture stringstring L'architettura del dispositivo in cui è presente il blocco:The architecture of the device on which the block exists:

  • ARM64ARM64
  • X86X86
TargetOStargetOs stringstring Una delle stringhe seguenti che specifica la versione del sistema operativo Windows 10 in cui è bloccata l'esecuzione dell'applicazione desktop:One of the following strings that specifies the Windows 10 OS release on which the desktop application is blocked from running:

  • Versione 1709Version 1709
  • Versione 1803Version 1803
deviceCountdeviceCount d'acquistonumber Numero di dispositivi distinti che contengono blocchi al livello di aggregazione specificato.The number of distinct devices that have blocks at the specified aggregation level.

Esempio di rispostaResponse example

L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.The following example demonstrates an example JSON response body for this request.

{
  "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/blockdetails?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}