Ottenere tutte le informazioni sull'analisi dei rivenditori indiretti

Articolo
05/29/2024

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

Come ottenere tutte le informazioni di analisi dei rivenditori indiretti per i clienti.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta solo l'autenticazione con credenziali utente.

Richiesta REST

Sintassi della richiesta

metodo	URI della richiesta
GET	{baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parametri URI

Parametro	Tipo	Descrizione
partnerTenantId	string	ID tenant del partner per cui si desidera recuperare i dati dei rivenditori indiretti.
id	string	ID rivenditore indiretto
name	string	Nome del partner per il quale si desidera recuperare i dati dei rivenditori indiretti.
market	string	Mercato del partner per cui si desidera recuperare i dati dei rivenditori indiretti.
firstSubscriptionCreationDate	stringa in formato data e ora UTC	Data di creazione della prima sottoscrizione in base alla quale si desidera recuperare i dati dei rivenditori indiretti.
latestSubscriptionCreationDate	stringa in formato data e ora UTC	Data di creazione della sottoscrizione più recente.
firstSubscriptionEndDate	stringa in formato data e ora UTC	La prima volta che è stata terminata una sottoscrizione.
latestSubscriptionEndDate	stringa in formato data e ora UTC	Data più recente di fine di una sottoscrizione.
firstSubscriptionSuspendedDate	stringa in ora UTC	Prima volta che una sottoscrizione è stata sospesa.
latestSubscriptionSuspendedDate	stringa in formato data e ora UTC	Data più recente in cui è stata sospesa una sottoscrizione.
firstSubscriptionDeprovisionedDate	stringa in formato data e ora UTC	La prima volta che è stato eseguito il deprovisioning di una sottoscrizione.
latestSubscriptionDeprovisionedDate	stringa in formato data e ora UTC	Data più recente in cui è stato eseguito il deprovisioning di una sottoscrizione.
subscriptionCount	double	Conteggio delle sottoscrizioni per tutti i rivenditori con valore aggiunto
licenseCount	double	Numero di licenze per tutti i rivenditori con valore aggiunto.
indirectResellerCount	double	Conteggio rivenditori indiretti
migliori	string	Il numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito se non specificato è 10.000. Se nella query sono presenti più righe, il corpo della risposta includerà un collegamento che consente di richiedere la pagina successiva dei dati.
skip	int	Numero di righe da ignorare nella query. Usare questo parametro per scorrere i set di dati di grandi dimensioni. Ad esempio, `top=10000 and skip=0` recupera le prime 10.000 righe di dati, `top=10000 and skip=10000` recupera le 10.000 righe di dati successive e così via.
filter	string	Il parametro filter della richiesta contiene una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un campo e un valore associati agli `eq` operatori o `ne` e le istruzioni possono essere combinate usando `and` o `or`. È possibile specificare i campi seguenti: partnerTenantId id Nome market firstSubscriptionCreationDate latestSubscriptionCreationDate firstSubscriptionEndDate latestSubscriptionEndDate firstSubscriptionSuspendedDate latestSubscriptionSuspendedDate firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate Esempio: `.../indirectresellers?filter=market eq 'US'` Esempio: `.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))`
aggregationLevel	string	Specifica l'intervallo di tempo per il quale recuperare i dati aggregati. Può essere una delle stringhe seguenti: "day", "week" o "month". Se non specificato, il valore predefinito è "day". `aggregationLevel` non è supportato senza un oggetto `aggregationLevel`. `aggregationLevel` si applica a tutti i campi di data presenti nell'oggetto `aggregationLevel`
orderby	string	Istruzione che ordina i valori dei dati dei risultati per ogni installazione. La sintassi è `...&orderby=field[order],field [order],...`. Il parametro field può essere una delle stringhe seguenti: "partnerTenantId" "id" "name" "market" "firstSubscriptionCreationDate" "latestSubscriptionCreationDate" "firstSubscriptionEndDate" "latestSubscriptionEndDate" "firstSubscriptionSuspendedDate" "latestSubscriptionSuspendedDate" "firstSubscriptionDeprovisionedDate" "latestSubscriptionDeprovisionedDate" "subscriptionCount" "licenseCount" Il parametro order è facoltativo e può essere `asc` o `desc`; per specificare l'ordine crescente o decrescente per ogni campo. Il valore predefinito è `asc`. Esempio: `...&orderby=market,subscriptionCount`
groupby	string	Istruzione che applica l'aggregazione dei dati solo ai campi specificati. È possibile specificare i campi seguenti: partnerTenantId ID Nome market firstSubscriptionCreationDate latestSubscriptionCreationDate firstSubscriptionEndDate latestSubscriptionEndDate firstSubscriptionSuspendedDate latestSubscriptionSuspendedDate firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate Le righe di dati restituite contengono i campi specificati nella `groupby` clausola e i campi seguenti: indirectResellerCount licenseCount subscriptionCount Il `groupby` parametro può essere usato con il `aggregationLevel` parametro . Esempio: `...&groupby=ageGroup,market&aggregationLevel=week`

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/indirectresellers HTTP 1.1
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 di risorse di rivenditori indiretti .

Codici di errore e di esito della risposta

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

Risposta di esempio

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "1111111",
    "name": "RESELLER NAME",
    "market": "US",
    "firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "firstSubscriptionEndDate": "2018-11-07T00:00:00",
    "latestSubscriptionEndDate": "2018-11-07T00:00:00",
    "firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
    "latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
    "subscriptionCount": 10,
    "licenseCount": 20
}

Vedi anche

Analisi del Centro per i partner - Risorse

Condividi tramite