Ottenere tutte le informazioni di analisi dei rivenditori indiretti
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 come descritto in autenticazione del Partner Center. Questo scenario supporta solo l'autenticazione con credenziali utente.
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
- Analisi del Centro per i partner - Risorse