Hämta all analysinformation för prenumerationer

Artikel
03/07/2025

gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Den här artikeln beskriver hur du hämtar all prenumerationsanalysinformation för dina kunder.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partner Center-autentisering. Det här scenariot stöder endast autentisering med användarautentiseringsuppgifter.

REST-begäran

Syntax för begäran

Metod	Begäran-URI
GET	{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

URI parametrar

I följande tabell visas valfria parametrar och deras beskrivningar:

Parameter	Typ	Beskrivning
topp	Int	Antalet rader med data som ska returneras i begäran. Om värdet inte anges är det högsta värdet och standardvärdet `10000`. Om det finns fler rader i frågan innehåller svarstexten en nästa länk som du kan använda för att begära nästa sida med data.
hoppa över	Int	Antalet rader som ska hoppa över i frågan. Använd den här parametern för att bläddra igenom stora datamängder. Till exempel hämtar `top=10000` och `skip=0` de första 10 000 raderna med data, `top=10000` och `skip=10000` hämtar de kommande 10 000 dataraderna.
filter	sträng	En eller flera instruktioner som filtrerar raderna i svaret. Varje filtersats innehåller ett fältnamn från svarstexten och ett värde som är associerat med `eq`, `ne`eller för vissa fält, `contains` operatorn. Uttalanden kan kombineras med `and` eller `or`. Strängvärden måste omges av enkla citattecken i -filtret parametern. I följande avsnitt finns en lista över fält som kan filtreras och de operatorer som stöds med dessa fält.
aggregationsnivå	sträng	Anger det tidsintervall för vilket aggregerade data ska hämtas. Kan vara någon av följande strängar: dag, veckaeller månad. Om värdet inte anges är standardvärdet dateRange. Den här parametern gäller endast när ett datumfält skickas som en del av parametern groupBy.
groupBy	sträng	En instruktion som endast tillämpar dataaggregering på de angivna fälten.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begäranens innehåll

Ingen.

Exempel på begäran

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

REST-svar

Om det lyckas innehåller svarstexten en samling Prenumeration resurser.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och extra felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och fler parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

{
    "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"

}

Se även

Partner Center Analytics – Resurser

Dela via