Compartir vía

Obtener toda la información de análisis de los revendedores indirectos

  • Artículo

Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

Cómo obtener toda la información de análisis de revendedores indirectos para sus clientes.

Requisitos previos

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parámetros de URI

Parámetro Tipo Descripción
partnerTenantId string Identificador de inquilino del asociado para el que desea recuperar los datos de revendedores indirectos.
id string Identificador de revendedor indirecto
nombre 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 la 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
superior string Número de filas de datos que se van a devolver en la solicitud. El valor máximo y el valor predeterminado si no se especifica es 10 000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo “Siguiente” que puedes usar para solicitar la siguiente página de datos.
skip int Número de filas que se omiten en la consulta. Usa este parámetro para pasar de página en conjuntos de datos grandes. Por ejemplo, top=10000 and skip=0 recupera las primeras 10 000 filas de datos, top=10000 and skip=10000 recupera las siguientes 10 000 filas de datos, etc.
filter string El parámetro filter de la solicitud contiene una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un campo y un valor asociados a los eq operadores o ne , y las instrucciones se pueden combinar mediante and o or. Puedes especificar los siguientes campos:

partnerTenantId
id
Nombre
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Ejemplo:
.../indirectresellers?filter=market eq 'US'

Ejemplo:
.../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 Especifica el intervalo de tiempo para el que se van a recuperar los datos agregados. Puede ser una de las siguientes cadenas: "day", "week" o "month". Si no se especifica, el valor predeterminado es "day".

aggregationLevelno se admite sin .aggregationLevel aggregationLevel se aplica a todos los campos de fecha presentes en aggregationLevel
orderby string Instrucción que ordena los valores de los datos en los resultados para cada instalación. La sintaxis es ...&orderby=field[order],field [order],.... El parámetro field puede ser una de las siguientes cadenas:

"partnerTenantId"
"id"
"name"
"mercado"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

El parámetro order es opcional y puede ser asc o desc; para especificar el orden ascendente o descendente de cada campo. El valor predeterminado es asc.

Ejemplo:
...&orderby=market,subscriptionCount
groupby string Instrucción que aplica la agregación de datos solo a los campos especificados. Puedes especificar los siguientes campos:

partnerTenantId
ID
Nombre
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Las filas de datos devueltas contienen los campos especificados en la groupby cláusula y los campos siguientes:

indirectResellerCount
licenseCount
subscriptionCount

El groupby parámetro se puede usar con el aggregationLevel parámetro .

Ejemplo
...&groupby=ageGroup,market&aggregationLevel=week:

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

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

Respuesta REST

Si se ejecuta correctamente, el cuerpo de la respuesta contiene una colección de recursos de revendedores indirectos.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

{
    "partnerTenantId": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE",
    "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
}

Consulte también