Implementatiegegevens van licenties ophalen

Artikel
09/11/2024

Implementatiegegevens ophalen voor Office- en Dynamics-licenties.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met App+User-referenties.

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/analytics/commercial/deployment/license/ HTTP/1.1

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

URI-parameters

Parameter	Type	Beschrijving	Vereist
top	tekenreeks	Het aantal rijen met gegevens dat in de aanvraag moet worden geretourneerd. De maximumwaarde en de standaardwaarde als deze niet is opgegeven, is 10000. Als de query meer rijen bevat, bevat de antwoordtekst een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens op te vragen.	No
skip	int	Het aantal rijen dat in de query moet worden overgeslagen. Gebruik deze parameter om grote gegevenssets te doorlopen. Met top=10000 en skip=0 worden bijvoorbeeld de eerste 10000 rijen met gegevens opgehaald, met top=10000 en skip=10000 worden de volgende 10000 rijen met gegevens opgehaald, enzovoort.	No
filter	tekenreeks	De filterparameter van de aanvraag bevat een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veld en waarde die zijn gekoppeld aan de `eq` operatoren of `ne` , en instructies kunnen worden gecombineerd met of `andor`. Hier volgen enkele voorbeelden van filterparameters : filter=serviceCode eq 'O365' filter=serviceCode eq 'O365' of (channel eq 'Reseller') U kunt de volgende velden opgeven: serviceCode Servicenaam Kanaal customerTenantId customerName Productid Productnaam	No
groupby	tekenreeks	Een instructie waarmee gegevensaggregatie alleen wordt toegepast op de opgegeven velden. U kunt de volgende velden opgeven: serviceCode Servicenaam Kanaal customerTenantId customerName Productid Productnaam De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de parameter groupby en het volgende: licensesDeployed licenties Verkocht	No
processedDateTime	DateTime	U kunt de datum opgeven vanaf welke gebruiksgegevens zijn verwerkt. Standaard ingesteld op de laatste datum waarop de gegevens zijn verwerkt	No

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/deployment/license?filter=customerTenantId%20eq%20%27aaaabbbb-0000-cccc-1111-dddd2222eeee%27 HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-antwoord

Als dit lukt, bevat de antwoordtekst de volgende velden met gegevens over de geïmplementeerde licenties.

Veld	Type	Beschrijving
serviceCode	tekenreeks	Servicecode
Servicenaam	tekenreeks	Servicenaam
Kanaal	tekenreeks	Kanaalnaam, reseller
customerTenantId	tekenreeks	Unieke id voor de klant
customerName	tekenreeks	Klantnaam
productId	tekenreeks	Unieke id voor het product
Productnaam	tekenreeks	Productnaam
licensesDeployed	long	Aantal geïmplementeerde licenties
licenties Verkocht	long	Aantal verkochte licenties
processedDateTime	DateTime	Datum waarop de gegevens voor het laatst zijn verwerkt

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 4
Date: Wed, 24 Oct 2018 22:37:18 GMT
{
  "Value": [

{
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "crm",
      "serviceName": "Microsoft Dynamics",
      "channel": "reseller",
      "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "54B84594-9C77-4499-8D65-5E0D5F410E78",
      "productName": "DYNAMICS AX TASK",
      "licensesDeployed": 0,
      "licensesSold": 9
    },
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "D3B4FE1F-9992-4930-8ACB-CA6EC609365E",
      "productName": "DOMESTIC AND INTERNATIONAL CALLING PLAN",
      "licensesDeployed": 0,
      "licensesSold": 5
    }
],
  "@nextLink": null,
  "TotalCount": 2
}

Delen via