Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gebruik deze REST-URI om informatie te krijgen over Windows 10- en Windows 11-apparaten waarop uw bureaubladtoepassing een Upgrade van Windows 10 of Windows 11 blokkeert. U kunt deze URI alleen gebruiken voor bureaubladtoepassingen die u hebt toegevoegd aan het Windows-bureaubladtoepassingsprogramma. Deze informatie is ook beschikbaar in het Toepassingsblokkeringenrapport voor bureaubladtoepassingen in Partner Center.
Zie Details van upgradeblok ophalen voor uw bureaubladtoepassingvoor meer informatie over apparaatblokken voor een specifiek uitvoerbaar bestand in uw bureaubladtoepassing.
Vereiste voorwaarden
Als u deze methode wilt gebruiken, moet u eerst het volgende doen:
- Als u dit nog niet hebt gedaan, moet u alle vereisten voor de Microsoft Store Analytics-API voltooien.
- Haal een Azure AD-toegangstoken op dat moet worden gebruikt in de aanvraagheader voor deze methode. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u een nieuw token verkrijgen.
Aanvraag
Aanvraagsyntaxis
| Methode | URI-aanvraag |
|---|---|
| TOEVOEGEN | https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits |
Header van het verzoek
| Koptekst | Typologie | Beschrijving |
|---|---|---|
| Autorisatie | touw | Verplicht. Het Azure AD-toegangstoken in de vorm van Bearer<token>. |
Aanvraagparameters
| Kenmerk | Typologie | Beschrijving | Verplicht |
|---|---|---|---|
| applicationId | touw | De product-id van de bureaubladtoepassing waarvoor u blokgegevens wilt ophalen. Als u de product-id van een bureaubladtoepassing wilt ophalen, opent u een analytics-rapport voor uw bureaubladtoepassing in Partner Center (zoals het Blocks-rapport) en haalt u de product-id op uit de URL. | Ja |
| begindatum | datum | De begindatum in het datumbereik van blokgegevens die moeten worden opgehaald. De standaardwaarde is 90 dagen vóór de huidige datum. | Nee. |
| einddatum | datum | De einddatum in het datumbereik van blokgegevens die moeten worden opgehaald. De standaardwaarde is de huidige datum. | Nee. |
| Bovenaan | int (integer) | Het aantal rijen met gegevens dat moet worden geretourneerd in de aanvraag. De maximumwaarde en de standaardwaarde als deze niet zijn opgegeven, is 10000. Als er meer rijen in de query staan, bevat de hoofdtekst van het antwoord een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens aan te vragen. | Nee. |
| overslaan | int (integer) | Het aantal rijen dat moet worden overgeslagen in de query. Gebruik deze parameter om door grote gegevenssets te bladeren. Met top=10000 en skip=0 worden bijvoorbeeld de eerste 10000 rijen met gegevens opgehaald, top=10000 en skip=10000 worden de volgende 10000 rijen met gegevens opgehaald, enzovoort. | Nee. |
| filter | touw | Een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veldnaam uit de antwoordtekst en waarde die zijn gekoppeld aan de operatoren eq of ne en instructies kunnen worden gecombineerd met behulp van en of of. Tekenreekswaarden moeten tussen enkele aanhalingstekens staan in parameter van het filter. U kunt de volgende velden opgeven in de hoofdtekst van het antwoord:
|
Nee. |
| volgorde | touw | Een statement die de resultaatgegevenswaarden voor elk blok rangschikt. De syntaxis is orderby=field [order],field [order],.... De parameter voor het veld kan een van de volgende velden uit de responsebody zijn:
De orderparameter is optioneel en kan asc of desc zijn om oplopende of aflopende volgorde voor elk veld op te geven. De standaardwaarde is asc. Hier is een voorbeeld van een orderby reeks: orderby=date,market |
Nee. |
| groeperen met groupby | touw | Een instructie die alleen gegevensaggregatie toepast op de opgegeven velden. U kunt de volgende velden opgeven in de hoofdtekst van het antwoord:
De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby-parameter en het volgende:
|
Nee. |
Vraag om voorbeeld
In het volgende voorbeeld ziet u verschillende aanvragen voor het ophalen van blokgegevens van bureaubladtoepassingen. Vervang de applicationId-waarde door de product-id voor uw bureaubladtoepassing.
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>
Reactie
Antwoordlichaam
| Waarde | Typologie | Beschrijving |
|---|---|---|
| Waarde | gegevensreeks | Een matrix met objecten die statistische blokgegevens bevatten. Zie de volgende tabel voor meer informatie over de gegevens in elk object. |
| @nextLink | touw | Als er extra pagina's met gegevens zijn, bevat deze tekenreeks een URI die u kunt gebruiken om de volgende pagina met gegevens aan te vragen. Deze waarde wordt bijvoorbeeld geretourneerd als de bovenste parameter van de aanvraag is ingesteld op 10000, maar er meer dan 10000 rijen blokgegevens voor de query zijn. |
| Totaalaantal | int (integer) | Het totale aantal rijen in het gegevensresultaat voor de query. |
Elementen in de matrix Waarde bevatten de volgende waarden.
| Waarde | Typologie | Beschrijving |
|---|---|---|
| applicationId | touw | De product-id van de bureaubladtoepassing waarvoor u blokgegevens hebt opgehaald. |
| datum | touw | De datum die is gekoppeld aan de bloktrefferwaarde. |
| productnaam | touw | De weergavenaam van de bureaubladtoepassing die is afgeleid van de metagegevens van de bijbehorende uitvoerbare bestanden. |
| bestandsnaam | touw | Het uitvoerbare bestand dat is geblokkeerd. |
| applicatieversie | touw | De versie van het uitvoerbare toepassingsbestand dat is geblokkeerd. |
| osVersie | touw | Een van de volgende tekenreeksen waarmee de versie van het besturingssysteem wordt opgegeven waarop de bureaubladtoepassing momenteel wordt uitgevoerd:
|
| osRelease | touw | Een van de volgende tekenreeksen die de release van het besturingssysteem of de flighting-ring (als subpopulatie binnen de versie van het besturingssysteem) aangeeft waarop de bureaubladtoepassing momenteel wordt uitgevoerd. Voor Windows 11: versie 2110 Voor Windows 10:
Voor Windows Server 1709:
Voor Windows Server 2016:
Voor Windows 8.1:
Voor Windows 7:
Als de release- of flightingring van het besturingssysteem onbekend is, heeft dit veld de waarde Onbekend. |
| markt | touw | De ISO 3166-landcode van de markt waarin de bureaubladtoepassing wordt geblokkeerd. |
| apparaatstype | touw | Een van de volgende tekenreeksen waarmee het type apparaat wordt opgegeven waarop de bureaubladtoepassing wordt geblokkeerd:
|
| blockType | touw | Een van de volgende tekenreeksen waarmee het type blok wordt opgegeven dat op het apparaat is gevonden:
|
| architectuur | touw | De architectuur van het apparaat waarop het blok bestaat:
|
| targetOs | touw | Een van de volgende tekenreeksen die de Windows 10- of Windows 11-besturingssysteemrelease aangeeft waarop de bureaubladtoepassing wordt geblokkeerd:
|
| aantal apparaten | nummer | Het aantal afzonderlijke apparaten met blokken op het opgegeven aggregatieniveau. |
Voorbeeld van antwoord
In het volgende voorbeeld ziet u een voorbeeld van een JSON-antwoordtekst voor deze aanvraag.
{
"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
}