Condividi tramite

Ottenere tutte le informazioni di analisi dei rivenditori indiretti

  • Articolo

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

Richiesta REST

Sintassi della richiesta

Metodo URI della richiesta
OTTIENI {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parametri URI

Parametro Tipo Descrizione
partnerTenantId corda ID tenant del partner per cui si desidera recuperare i dati dei rivenditori indiretti.
id corda ID del rivenditore indiretto
nome corda Nome del partner per il quale si desidera recuperare i dati dei rivenditori indiretti.
mercato corda Mercato del partner per cui si desidera recuperare i dati dei rivenditori indiretti.
dataPrimaCreazioneAbbonamento stringa nel formato di data e ora UTC Data di creazione della prima sottoscrizione in base alla quale si desidera recuperare i dati dei rivenditori indiretti.
dataCreazioneUltimaSottoscrizione stringa nel formato di data e ora UTC Data di creazione della sottoscrizione più recente.
dataFinePrimaSottoscrizione stringa nel formato di data e ora UTC La prima volta che è stata terminata una sottoscrizione.
dataFineAbbonamentoPiùRecente stringa nel formato di data e ora UTC Data più recente di fine di una sottoscrizione.
dataPrimaSospensioneAbbonamento stringa in data e ora UTC Prima volta che una sottoscrizione è stata sospesa.
dataUltimaSospensioneAbbonamento stringa nel formato di data e ora UTC Data più recente in cui è stata sospesa una sottoscrizione.
dataDisattivazionePrimaSottoscrizione stringa nel formato di data e ora UTC La prima volta che è stata disattivata una qualsiasi sottoscrizione.
DataUltimaSottoscrizioneDisattivata stringa nel formato di data e ora UTC Ultima data in cui una sottoscrizione è stata disattivata.
conteggio degli abbonamenti doppio Conteggio delle sottoscrizioni per tutti i rivenditori con valore aggiunto
licenseCount doppio Numero di licenze per tutti i rivenditori con valore aggiunto.
conteggioRivenditoriIndiretti doppio Conteggio rivenditori indiretti
In alto corda 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 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 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.
filtro corda Il filtro parametro della richiesta contiene una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un campo e un valore associati agli operatori eq o ne e le istruzioni possono essere combinate usando and o or. È possibile specificare i campi seguenti:

partnerTenantId
ID
Nome
mercato
firstSubscriptionCreationDate
dataUltimaCreazioneAbbonamento
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
dataDiSospensioneDellAbbonamentoPiùRecente
firstSubscriptionDeprovisionedDate
dataDiDeprovisionamentoDellaSottoscrizionePiùRecente

Esempio di :
.../indirectresellers?filter=market eq 'US'

Esempio di :
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
livello di aggregazione corda 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 aggregationLevel. aggregationLevel si applica a tutti i campi data presenti nel aggregationLevel
orderby corda L'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"
nome
mercato
"dataDiCreazionePrimaSottoscrizione"
dataCreazioneUltimaSottoscrizione
dataFinePrimaSottoscrizione
dataFineUltimaSottoscrizione
primaDataSospensioneAbbonamento
dataUltimaSospensioneAbbonamento
dataDisattivazionePrimaSottoscrizione
"dataUltimaSottoscrizioneDeprovisionata"
conteggio iscrizioni
conteggioLicenze

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 di :
...&orderby=market,subscriptionCount
groupby corda Istruzione che applica l'aggregazione dei dati solo ai campi specificati. È possibile specificare i campi seguenti:

partnerTenantId
ID
Nome
mercato
primaDataCreazioneAbbonamento
dataUltimaCreazioneAbbonamento
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
dataDiSospensioneDellAbbonamentoPiùRecente
firstSubscriptionDeprovisionedDate
dataUltimaDisattivazioneAbbonamento

Le righe di dati restituite contengono i campi specificati nella clausola groupby e i campi seguenti:

indirectResellerCount
conteggioLicenze
conteggioAbbonamenti

Il parametro groupby può essere usato con il parametro aggregationLevel.

Esempio di :
...&groupby=ageGroup,market&aggregationLevel=week

Intestazioni della richiesta

Per ulteriori informazioni, consultare le intestazioni REST di Partner Center.

Corpo 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 esito positivo 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, vedere codici di errore .

Esempio di risposta

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

Vedere anche