Ottenere tutte le informazioni di analisi delle sottoscrizioni

Articolo
03/07/2025

si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Questo articolo descrive come ottenere tutte le informazioni di analisi delle sottoscrizioni per i clienti.

Prerequisiti

Credenziali come descritte nell'autenticazione del Partner Center . Questo scenario supporta solo l'autenticazione con credenziali utente.

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

Parametri URI

La tabella seguente elenca i parametri facoltativi e le relative descrizioni:

Parametro	Digitare	Descrizione
In alto	Int	Numero di righe di dati da restituire nella richiesta. Se il valore non viene specificato, il valore massimo e il valore predefinito sono `10000`. Se nella query sono presenti più righe, il corpo della risposta include un collegamento successivo che è possibile usare per richiedere la pagina successiva dei dati.
saltare	Int	Numero di righe da ignorare nella query. Usare questo parametro per scorrere set di dati di grandi dimensioni. Ad esempio, `top=10000` e `skip=0` recupera le prime 10.000 righe di dati, `top=10000` e `skip=10000` recupera le 10.000 righe di dati successive.
filtro	corda	Una o più dichiarazioni che filtrano le righe nella risposta. Ogni istruzione di filtro contiene un nome di campo dal corpo della risposta e un valore che sono associati agli operatori `eq`, `ne`o, per determinati campi, all'operatore `contains`. Le istruzioni possono essere combinate usando `and` o `or`. I valori stringa devono essere racchiusi tra virgolette singole nel filtro parametro. Vedere la sezione seguente per un elenco di campi che possono essere filtrati e gli operatori supportati con tali campi.
livello di aggregazione	corda	Specifica l'intervallo di tempo per il quale recuperare i dati aggregati. Può essere una delle stringhe seguenti: giorno, settimanao mese. Se il valore non è specificato, il valore predefinito è dateRange. Questo parametro si applica solo quando un campo data viene passato come parte del parametro groupBy .
groupBy	corda	Istruzione che applica l'aggregazione dei dati solo ai campi specificati.

Intestazioni della richiesta

Per altre informazioni, vedere intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una raccolta delle risorse Subscription.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e informazioni di debug aggiuntive. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedere codici di errore .

Esempio di risposta

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

}

Vedere anche

Analisi del Centro per i partner - Risorse

Condividi tramite