Analisi del Centro per i partner - Risorse
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
L'API Di analisi consente di accedere a livello di codice ai dati presentati nell'esperienza utente.
Prerequisiti
- Credenziali descritte in Autenticazione del Centro per i partner. Questi scenari supportano l'autenticazione solo con credenziali utente.
Programma CSP: Analisi dell'utilizzo di Azure
Lo scenario seguente illustra come usare l'API di analisi per recuperare tutte le informazioni sull'analisi dell'utilizzo di Azure nel Centro per i partner.
Questo scenario restituisce le informazioni di analisi in una raccolta di risorse di utilizzo di Azure.
Risorsa di utilizzo di Azure
Rappresenta tutti i dati analitici per l'utilizzo di Azure.
| Proprietà | Type | Descrizione |
|---|---|---|
| CustomerTenantId | string | Identificatore del tenant del cliente. |
| customerName | string | Nome del cliente. |
| subscriptionId | string | L'identificatore della sottoscrizione. |
| subscriptionName | string | Nome della sottoscrizione. |
| usageDate | string | Data di utilizzo. |
| resourceLocation | string | La posizione del data center, ad esempio Europa occidentale. |
| meterCategory | string | Categoria del contatore, gestione dei dati, ad esempio. |
| meterSubcategory | string | Sottocategoria del contatore, ad esempio con ridondanza geografica. |
| meterUnit | string | Unità contatore, ad esempio gigabyte o ore. |
| reservationOrderId | string | Ordine di prenotazione per un'istanza riservata di macchina virtuale di Azure. |
| reservationId | string | Istanze riservate in base a un ordine di istanze riservate specifico. |
| serviceType | string | Indica il tipo di macchina virtuale. Ad esempio, Standard_E4s_v3. |
| quantity | long | Indica i numeri utilizzati nell'unità contatore. |
Programma CSP: analisi dei rivenditori indiretti
Lo scenario seguente illustra come usare l'API di analisi per recuperare tutte le informazioni di analisi dei rivenditori indiretti del Centro per i partner.
Questo scenario restituisce le informazioni di analisi in una raccolta di risorse di rivenditori indiretti .
Risorsa rivenditori indiretti
Rappresenta tutti i dati analitici per i rivenditori indiretti.
| Proprietà | Type | 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 formato data e 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 |
Programma CSP: analisi delle sottoscrizioni
Gli scenari seguenti illustrano come usare l'API Di analisi per recuperare tutte le informazioni di analisi delle sottoscrizioni del Centro per i partner, filtrarla con una query di ricerca o raggrupparla in base a date o termini.
- Ottenere tutte le informazioni sull'analisi delle sottoscrizioni
- Ottenere informazioni sull'analisi delle sottoscrizioni filtrate in base a una query di ricerca
- Ottenere informazioni sull'analisi delle sottoscrizioni raggruppate in base alle date o ai termini
Tutti questi scenari restituiscono le informazioni di analisi in una raccolta di risorse di sottoscrizione .
Risorsa di sottoscrizione
Rappresenta tutti i dati analitici per una sottoscrizione.
| Proprietà | Type | Descrizione |
|---|---|---|
| customerTenantId | string | Stringa in formato GUID che identifica il tenant del cliente. |
| customerName | string | Il nome del cliente. |
| customerMarket | string | Paese/area geografica in cui il cliente fa affari. |
| ID | string | L'identificatore della sottoscrizione. |
| stato | string | Stato della sottoscrizione: "ACTIVE", "SUSPENDED" o "DEPROVISIONED". |
| productName | string | Nome del prodotto. |
| subscriptionType | string | Tipo di sottoscrizione. Nota: questo campo fa distinzione tra maiuscole e minuscole. I valori supportati sono: "Office", "Azure", "Microsoft365", "Dynamics", "EMS". |
| autoRenewEnabled | boolean | Valore che indica se la sottoscrizione viene rinnovata automaticamente. |
| partnerId | string | Id partner. Per un rivenditore diretto, questo parametro sarà il PartnerID del partner. Per un rivenditore indiretto, questo parametro sarà il PartnerID del rivenditore indiretto. |
| friendlyName | string | Nome della sottoscrizione. |
| partnerName | string | Nome del partner per il quale è stata acquistata la sottoscrizione |
| Providername | string | Quando la transazione di sottoscrizione è per il rivenditore indiretto, il nome del provider è il provider indiretto che ha acquistato la sottoscrizione. |
| effectiveStartDate | stringa in formato data e ora UTC | Data di inizio della sottoscrizione. |
| commitmentEndDate | stringa in formato data e ora UTC | Data di fine della sottoscrizione. |
| currentStateEndDate | stringa in formato data e ora UTC | Data di modifica dello stato corrente della sottoscrizione. |
| trialToPaidConversionDate | stringa in formato data e ora UTC | Data in cui la sottoscrizione viene convertita da versione di valutazione a pagamento. Il valore predefinito è null. |
| trialStartDate | stringa in formato data e ora UTC | Data di inizio del periodo di valutazione per la sottoscrizione. Il valore predefinito è null. |
| trialEndDate | stringa in formato data e ora UTC | Data di fine del periodo di valutazione per la sottoscrizione. Il valore predefinito è null. |
| lastUsageDate | stringa in formato data e ora UTC | Data dell'ultima utilizzo della sottoscrizione. Il valore predefinito è null. |
| deprovisionedDate | stringa in formato data e ora UTC | Data di deprovisioning della sottoscrizione. Il valore predefinito è null. |
| lastRenewalDate | stringa in formato data e ora UTC | Data dell'ultimo rinnovo della sottoscrizione. Il valore predefinito è null. |
| licenseCount | number | Numero totale di licenze. |
| subscriptionCount | number | Numero di sottoscrizioni. Nota: questo valore verrà visualizzato solo nella risposta di una query di aggregazione. |
Analisi di ricerca
Nota
L'appartenenza al programma CSP non è necessaria per ottenere l'analisi della ricerca.
Lo scenario seguente illustra come usare l'API Di analisi per recuperare tutte le informazioni di analisi di ricerca del Centro per i partner.
Questo scenario restituisce le informazioni di analisi in una raccolta di risorse di ricerca.
Cerca risorse
Rappresenta tutti i dati analitici per una ricerca.
| Proprietà | Type | Descrizione |
|---|---|---|
| companyName | string | Nome della società di fatturazione. |
| contactButtonClicked | Booleano | Indica se è stato fatto clic sul pulsante contatto. |
| keywordCountry | string | Paese/area geografica specificata nella ricerca. |
| detailsViewed | Booleano | Indica se i dettagli della ricerca sono stati visualizzati. |
| keywordIndustryFocus | string | Il settore in cui cercare, ad esempio, il settore sanitario. |
| partnerId | string | Id partner. Per un rivenditore diretto, questo parametro sarà il PartnerID del partner. Per un rivenditore indiretto, questo parametro sarà il PartnerID del rivenditore indiretto. |
| partnerMarket | string | Impostazioni locali in cui il partner svolge attività aziendali. |
| keywordProduct | string | Prodotto specificato nella ricerca. |
| referralSubmitted | Booleano | Indica se è stata inviata una segnalazione. |
| searchDate | stringa in formato data e ora UTC | Data in cui si è verificata la query di ricerca. |
| keywordSearchText | string | Testo specificato nella ricerca. |
| searchResultPageViews | long | Numero di volte in cui il partner è arrivato nel risultato della ricerca. Parte di una risposta solo sull'aggregazione. |
| contactClicks | long | Numero di volte in cui è stato fatto clic sul pulsante contatto. Parte di una risposta solo sull'aggregazione. |
| referralCount | long | Numero di segnalazioni generate dalla ricerca. Parte di una risposta solo sull'aggregazione. |
| profileViews | long | Numero di volte in cui il profilo partner è stato visualizzato. Parte di una risposta solo sull'aggregazione. |
Analisi dei riferimenti
Nota
L'appartenenza al programma CSP non è necessaria per ottenere l'analisi delle segnalazioni.
Lo scenario seguente illustra come usare l'API di analisi per recuperare tutte le informazioni di analisi delle segnalazioni del Centro per i partner.
Questo scenario restituisce le informazioni di analisi in una raccolta di risorse segnalazioni .
Nota
L'analisi delle segnalazioni non è disponibile per il Centro per i partner gestito da 21Vianet.
Risorsa segnalazioni
Rappresenta tutti i dati analitici per una segnalazione.
| Proprietà | Type | Descrizione |
|---|---|---|
| ID | string | Identificatore del tenant del cliente. |
| stato | string | Indica se la segnalazione ha portato a un cliente. |
| customerMarket | string | Paese/area geografica in cui il cliente fa affari. |
| customerName | string | Il nome del cliente. |
| customerOrgSize | string | Intervallo che indica il numero di dipendenti nell'organizzazione del cliente. Ad esempio, "10to50employees". |
| acceptedDate | stringa in formato data e ora UTC | Data di accettazione della segnalazione. |
| acknowledgementDate | stringa in formato data e ora UTC | Data in cui è stata riconosciuta la segnalazione. |
| archivedDate | stringa in formato data e ora UTC | Data di archiviazione della segnalazione. |
| rifiutatoDate | stringa in formato data e ora UTC | Data in cui la segnalazione è stata rifiutata. |
| expiredDate | stringa in formato data e ora UTC | Data in cui è scaduta la segnalazione. |
| lostDate | stringa in formato data e ora UTC | Data in cui è stata persa la segnalazione. |
| missedDate | stringa in formato data e ora UTC | Data in cui la segnalazione non è riuscita. |
| createdDate | stringa in formato data e ora UTC | Data di creazione della segnalazione. |
| skippedDate | stringa in formato data e ora UTC | Data in cui è stata ignorata la segnalazione. |
| wonDate | stringa in formato data e ora UTC | Data in cui è stata vinta la segnalazione. |
| partnerMarket | string | Paese/area geografica in cui il partner fa affari. |