Análisis del Centro de partners: recursos
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
La API de Analytics permite acceder mediante programación a los datos que se presentan en la experiencia del usuario.
Requisitos previos
- Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Estos escenarios solo admiten la autenticación con credenciales de usuario.
Programa CSP: Análisis de uso de Azure
En el escenario siguiente se muestra cómo usar la API de Analytics para recuperar toda la información de análisis de uso de Azure del Centro de partners.
Este escenario devuelve la información de análisis en una colección de recursos de uso de Azure.
Recurso de uso de Azure
Representa todos los datos analíticos para el uso de Azure.
| Propiedad | Tipo | Descripción |
|---|---|---|
| CustomerTenantId | string | Identificador de inquilino del cliente. |
| customerName | string | Nombre del cliente. |
| subscriptionId | string | Identificador de la suscripción. |
| subscriptionName | string | Nombre de la suscripción. |
| usageDate | string | Fecha de uso. |
| resourceLocation | string | La ubicación del centro de datos, Europa occidental, por ejemplo. |
| meterCategory | string | La categoría de medidor, la administración de datos, por ejemplo. |
| meterSubcategory | string | Subcategoría de medidor, por ejemplo, con redundancia geográfica. |
| meterUnit | string | Unidad de medidor, como gigabytes o horas. |
| reservationOrderId | string | El pedido de reserva de una instancia reservada de máquina virtual de Azure. |
| reservationId | string | Instancias reservadas en un orden de RI específico. |
| serviceType | string | Indica el tipo de máquina virtual. Por ejemplo, Standard_E4s_v3. |
| quantity | long | Indica los números usados en la unidad de medidor. |
Programa CSP: análisis indirectos de revendedores
En el escenario siguiente se muestra cómo usar la API de Analytics para recuperar toda la información de análisis de revendedores indirectos del Centro de partners.
Este escenario devuelve la información de análisis en una colección de recursos de revendedores indirectos.
Recurso revendedores indirectos
Representa todos los datos analíticos para revendedores indirectos.
| Propiedad | Tipo | Descripción |
|---|---|---|
| partnerTenantId | string | Identificador de inquilino del asociado para el que desea recuperar los datos de revendedores indirectos. |
| id | string | Id. de revendedor indirecto. |
| name | string | Nombre del asociado para el que desea recuperar los datos de revendedores indirectos. |
| market | string | El mercado del asociado para el que desea recuperar los datos de revendedores indirectos. |
| firstSubscriptionCreationDate | cadena en formato de fecha y hora UTC | Fecha de creación de la primera suscripción en función de la cual desea recuperar datos de revendedores indirectos. |
| latestSubscriptionCreationDate | cadena en formato de fecha y hora UTC | Fecha de creación de la suscripción más reciente. |
| firstSubscriptionEndDate | cadena en formato de fecha y hora UTC | Primera vez que se finalizó cualquier suscripción. |
| latestSubscriptionEndDate | cadena en formato de fecha y hora UTC | Fecha más reciente en la que se finalizó cualquier suscripción. |
| firstSubscriptionSuspendedDate | cadena en formato de fecha y hora UTC | Primera vez que se suspendió cualquier suscripción. |
| latestSubscriptionSuspendedDate | cadena en formato de fecha y hora UTC | Fecha más reciente en la que se suspendió cualquier suscripción. |
| firstSubscriptionDeprovisionedDate | cadena en formato de fecha y hora UTC | La primera vez que se desaprovisionó cualquier suscripción. |
| latestSubscriptionDeprovisionedDate | cadena en formato de fecha y hora UTC | Fecha más reciente en la que se desaprovisionó cualquier suscripción. |
| subscriptionCount | doble | Recuento de suscripciones para todos los revendedores de valor agregado |
| licenseCount | doble | Recuento de licencias para todos los revendedores de valor agregado |
| indirectResellerCount | doble | Recuento de revendedores indirectos |
Programa CSP: análisis de suscripciones
Los escenarios siguientes muestran cómo usar la API de Analytics para recuperar toda la información de análisis de suscripciones del Centro de partners, filtrarla con una consulta de búsqueda o agruparla por fechas o términos.
- Obtener toda la información de análisis de las suscripciones
- Obtener la información de análisis de las suscripciones, según las consultas de búsqueda
- Obtener la información de análisis de las suscripciones, agrupada según la fecha o los términos
Todos estos escenarios devuelven la información de análisis en una colección de recursos de suscripción .
Recurso de suscripción
Representa todos los datos analíticos de una suscripción.
| Propiedad | Tipo | Descripción |
|---|---|---|
| customerTenantId | string | Cadena con formato GUID que identifica el inquilino del cliente. |
| customerName | string | El nombre del cliente. |
| customerMarket | string | País o región en el que el cliente realiza el negocio. |
| id | string | Identificador de la suscripción. |
| status | string | Estado de la suscripción: "ACTIVE", "SUSPENDED" o "DEPROVISIONED". |
| productName | string | El nombre del producto. |
| subscriptionType | string | Tipo de suscripción. Nota: Este campo distingue mayúsculas de minúsculas. Los valores admitidos son: "Office", "Azure", "Microsoft365", "Dynamics", "EMS". |
| autoRenewEnabled | boolean | Valor que indica si la suscripción se renueva automáticamente. |
| PartnerId | string | The PartnerID. Para un revendedor directo, este parámetro será el PartnerID del asociado. Para un revendedor indirecto, este parámetro será partnerID del revendedor indirecto. |
| friendlyName | string | Nombre de la suscripción. |
| partnerName | string | Nombre del asociado para el que se compró la suscripción |
| providerName | string | Cuando la transacción de suscripción es para el revendedor indirecto, el nombre del proveedor es el proveedor indirecto que compró la suscripción. |
| effectiveStartDate | cadena en formato de fecha y hora UTC | Fecha en que se inicia la suscripción. |
| commitmentEndDate | cadena en formato de fecha y hora UTC | Fecha en que finaliza la suscripción. |
| currentStateEndDate | cadena en formato de fecha y hora UTC | Fecha en que cambiará el estado actual de la suscripción. |
| trialToPaidConversionDate | cadena en formato de fecha y hora UTC | Fecha en la que la suscripción se convierte de prueba a pago. El valor predeterminado es null. |
| trialStartDate | cadena en formato de fecha y hora UTC | Fecha en que se inició el período de prueba de la suscripción. El valor predeterminado es null. |
| trialEndDate | cadena en formato de fecha y hora UTC | Fecha en que finaliza el período de prueba de la suscripción. El valor predeterminado es null. |
| lastUsageDate | cadena en formato de fecha y hora UTC | Fecha en que se usó la suscripción por última vez. El valor predeterminado es null. |
| desaprovisionedDate | cadena en formato de fecha y hora UTC | Fecha en que se desaprovisionó la suscripción. El valor predeterminado es null. |
| lastRenewalDate | cadena en formato de fecha y hora UTC | Fecha en que se renueve por última vez la suscripción. El valor predeterminado es null. |
| licenseCount | number | Número total de licencias. |
| subscriptionCount | number | Número de suscripciones. Nota: Este valor solo aparecerá en la respuesta de una consulta de agregación. |
Análisis de búsqueda
Nota:
La pertenencia al programa CSP no es necesaria para obtener análisis de búsqueda.
En el escenario siguiente se muestra cómo usar la API de Analytics para recuperar toda la información de análisis de búsqueda del Centro de partners.
Este escenario devuelve la información de análisis en una colección de recursos de búsqueda.
Buscar recurso
Representa todos los datos analíticos de una búsqueda.
| Propiedad | Tipo | Descripción |
|---|---|---|
| companyName | string | Nombre de la compañía de facturación. |
| contactButtonClicked | Booleano | Indica si se hizo clic en el botón de contacto. |
| keywordCountry | string | País o región especificado en la búsqueda. |
| detailsViewed | Booleano | Indica si se vieron los detalles de la búsqueda. |
| keywordIndustryFocus | string | El sector en el que se va a buscar, por ejemplo, la atención sanitaria. |
| PartnerId | string | The PartnerID. Para un revendedor directo, este parámetro será el PartnerID del asociado. Para un revendedor indirecto, este parámetro será partnerID del revendedor indirecto. |
| partnerMarket | string | Configuración regional en la que el asociado lleva a cabo el negocio. |
| keywordProduct | string | Producto especificado en la búsqueda. |
| referralSubmitted | Booleano | Indica si se envió una referencia. |
| searchDate | cadena en formato de fecha y hora UTC | Fecha en que se produjo la consulta de búsqueda. |
| keywordSearchText | string | Texto especificado en la búsqueda. |
| searchResultPageViews | long | Número de veces que el asociado apareció en el resultado de la búsqueda. Parte de una respuesta solo en la agregación. |
| contactClicks | long | Número de veces que se hizo clic en el botón de contacto. Parte de una respuesta solo en la agregación. |
| referralCount | long | Número de referencias generadas a partir de la búsqueda. Parte de una respuesta solo en la agregación. |
| profileViews | long | Número de veces que se ha visto el perfil de asociado. Parte de una respuesta solo en la agregación. |
Análisis de referencias
Nota:
La pertenencia al programa CSP no es necesaria para obtener análisis de referencias.
En el escenario siguiente se muestra cómo usar la API de Analytics para recuperar toda la información de análisis de referencias del Centro de partners.
Este escenario devuelve la información de análisis en una colección de recursos de referencias .
Nota:
El análisis de referencias no está disponible para el Centro de partners operado por 21Vianet.
Recurso de referencias
Representa todos los datos analíticos de una referencia.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | string | Identificador de inquilino del cliente. |
| status | string | Indica si la referencia llevó a un cliente. |
| customerMarket | string | País o región en el que el cliente realiza el negocio. |
| customerName | string | El nombre del cliente. |
| customerOrgSize | string | Intervalo que indica el número de empleados de la organización del cliente. Por ejemplo, "10to50employees". |
| acceptedDate | cadena en formato de fecha y hora UTC | Fecha en que se aceptó la referencia. |
| acknowledgedDate | cadena en formato de fecha y hora UTC | Fecha en que se reconoció la referencia. |
| archivedDate | cadena en formato de fecha y hora UTC | Fecha en que se ha archivado la referencia. |
| declinedDate | cadena en formato de fecha y hora UTC | Fecha en que se rechazó la referencia. |
| expiredDate | cadena en formato de fecha y hora UTC | Fecha en que expiró la referencia. |
| lostDate | cadena en formato de fecha y hora UTC | Fecha en que se perdió la referencia. |
| missedDate | cadena en formato de fecha y hora UTC | Fecha en la que se perdió la referencia. |
| CreatedDate | cadena en formato de fecha y hora UTC | Fecha en que se creó la referencia. |
| skippedDate | cadena en formato de fecha y hora UTC | Fecha en que se omitió la referencia. |
| wonDate | cadena en formato de fecha y hora UTC | Fecha en que se ganó la referencia. |
| partnerMarket | string | País o región en el que el asociado hace negocios. |