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

Artículo
05/29/2024

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

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario solo admite la autenticación con credenciales de usuario.

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". `aggregationLevel`no 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": "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
}

Consulte también

Análisis del Centro de partners: recursos

Compartir a través de