Alle abonnementsanalysegegevens ophalen
van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid
In dit artikel wordt beschreven hoe u alle abonnementsanalysegegevens voor uw klanten kunt ophalen.
- Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt alleen verificatie met gebruikersreferenties.
| Methode | Aanvraag-URI |
|---|---|
| GET | {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1 |
De volgende tabel bevat optionele parameters en de bijbehorende beschrijvingen:
| Parameter | Type | Beschrijving |
|---|---|---|
| Boven | Int | Het aantal rijen met gegevens dat moet worden geretourneerd in de aanvraag. Als de waarde niet is opgegeven, worden de maximumwaarde en de standaardwaarde 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. |
| overslaan | Int | 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 10.000 rijen met gegevens opgehaald, top=10000 en skip=10000 de volgende 10.000 rijen met gegevens opgehaald. |
| filter | snaar | Een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke filterinstructie bevat een veldnaam uit de hoofdtekst van het antwoord en een waarde die is gekoppeld aan de eq, neof voor bepaalde velden, de operator contains. Verklaringen kunnen worden gecombineerd met behulp van and of or. Tekenreekswaarden moeten worden omgeven door enkele aanhalingstekens in de parameter filter. Zie de volgende sectie voor een lijst met velden die kunnen worden gefilterd en de operators die worden ondersteund met deze velden. |
| aggregatieniveau | snaar | Hiermee geeft u het tijdsbereik op waarvoor geaggregeerde gegevens moeten worden opgehaald. Kan een van de volgende tekenreeksen zijn: dag, weekof maand. Als de waarde niet is opgegeven, wordt de standaardwaarde dateRange. Deze parameter is alleen van toepassing wanneer een datumveld wordt doorgegeven als onderdeel van de parameter groupBy. |
| groupBy | snaar | Een instructie die alleen gegevensaggregatie toepast op de opgegeven velden. |
Zie Partnercentrum REST-headersvoor meer informatie.
Geen.
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling Resources voor abonnement.
Elk antwoord wordt geleverd met een HTTP-statuscode die succes of falen aangeeft, en extra informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodesvoor de volledige lijst.
{
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"customerName": "TESTORG65656565",
"customerMarket": "US",
"id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
"status": "ACTIVE",
"productName": "OFFICE 365 BUSINESS PREMIUM",
"subscriptionType": "Office",
"autoRenewEnabled": true,
"partnerId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"friendlyName": "FULL OFFICE SUITE",
"partnerName": "Partner Name",
"providerName": "Provider Name",
"creationDate": "2016-02-04T19:29:38.037",
"effectiveStartDate": "2016-02-04T00:00:00",
"commitmentEndDate": "2019-02-10T00:00:00",
"currentStateEndDate": "2019-02-10T00:00:00",
"trialToPaidConversionDate": null,
"trialStartDate": null,
"trialEndDate": null,
"lastUsageDate": null,
"deprovisionedDate": null,
"lastRenewalDate": "2018-02-10T02:39:57.729",
"licenseCount": 2,
"churnRisk": "High",
"billingCycleName": "MONTHLY"
}