Alle analysegegevens van abonnementen 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.

Vereisten

• Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt alleen verificatie met gebruikersreferenties.

REST-aanvraag

Aanvraagsyntaxis

Wijze	Aanvraag-URI
GET	{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

URI-parameters

De volgende tabel bevat optionele parameters en de bijbehorende beschrijvingen:

Parameter	Type	Omschrijving
top	geheel getal (int)	Het aantal rijen met gegevens dat moet worden geretourneerd in de aanvraag. Als de waarde niet is opgegeven, zijn 10000de maximumwaarde en de standaardwaarde. 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.
skip	geheel getal (int)	Het aantal rijen dat moet worden overgeslagen in de query. Gebruik deze parameter om door grote gegevenssets te bladeren. Haalt bijvoorbeeld top=10000skip=0 de eerste 10.000 rijen met gegevens top=10000 op en skip=10000 haalt de volgende 10.000 rijen met gegevens op.
filter	tekenreeks	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 eqoperator , neof voor bepaalde velden contains . Instructies kunnen worden gecombineerd met and of or. Tekenreekswaarden moeten tussen enkele aanhalingstekens in de filterparameter staan. Zie de volgende sectie voor een lijst met velden die kunnen worden gefilterd en de operators die worden ondersteund met deze velden.
aggregationLevel	tekenreeks	Hiermee geeft u het tijdsbereik op waarvoor geaggregeerde gegevens moeten worden opgehaald. Dit kan een van de volgende tekenreeksen zijn: dag, week of maand. Als de waarde niet is opgegeven, is de standaardwaarde dateRange. Deze parameter is alleen van toepassing wanneer een datumveld wordt doorgegeven als onderdeel van de groupBy-parameter .
groupBy	tekenreeks	Een instructie die alleen gegevensaggregatie toepast op de opgegeven velden.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST-antwoord

Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling abonnementsbronnen.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat er succes- of foutopsporingsinformatie is en extra informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

{
    "customerTenantId": "76906668-27FC-4F5B-A35C-75A9823E13AF",
    "customerName": "TESTORG65656565",
    "customerMarket": "US",
    "id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
    "status": "ACTIVE",
    "productName": "OFFICE 365 BUSINESS PREMIUM",
    "subscriptionType": "Office",
    "autoRenewEnabled": true,
    "partnerId": "3B33E682-00C3-41EE-9DD2-A548ADF56438",
    "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"

}

Zie ook

• Partnercentrum-analyse - Resources