Freigeben über

Abrufen aller Informationen zur Abonnementanalyse

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

In diesem Artikel wird beschrieben, wie Sie alle Abonnementanalyseinformationen für Ihre Kunden abrufen.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit Benutzeranmeldeinformationen.

REST-Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

URI-Parameter

In der folgenden Tabelle sind optionale Parameter und deren Beschreibungen aufgeführt:

Parameter Type Beschreibung
Oben int Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Wenn der Wert nicht angegeben ist, sind 10000der Maximalwert und der Standardwert . Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern.
skip int Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. Ruft beispielsweise top=10000skip=0 die ersten 10.000 Datenzeilen top=10000 ab und skip=10000 ruft die nächsten 10.000 Datenzeilen ab.
filter Zeichenfolge Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Filter-Anweisung enthält einen Feldnamen aus dem Antworttext und einen Wert, der contains dem eqOperator zugeordnet ist, neoder für bestimmte Felder. Anweisungen können mithilfe and oder or. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filterparameter umgeben sein. Im folgenden Abschnitt finden Sie eine Liste der Felder, die gefiltert werden können, und die Operatoren, die mit diesen Feldern unterstützt werden.
aggregationLevel Zeichenfolge Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Dies kann eine der folgenden Zeichenfolgen sein: Tag, Woche oder Monat. Wenn der Wert nicht angegeben ist, ist "dateRange" der Standardwert. Dieser Parameter gilt nur, wenn ein Datumsfeld als Teil des groupBy-Parameters übergeben wird.
Groupby Zeichenfolge Eine Anweisung, die datenaggregation nur auf die angegebenen Felder anwendet.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Beispiel für eine Anfrage

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

REST-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext eine Sammlung von Abonnementressourcen.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und weitere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

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

}

Siehe auch