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 la solicitud
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parámetros del identificador 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 Id. de revendedor indirecto
name string Nombre del asociado para el que desea recuperar los datos de revendedores indirectos.
market string El mercado del partner 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 La 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 double Recuento de suscripciones para todos los revendedores de valor agregado
licenseCount double Recuento de licencias para todos los revendedores de valor agregado.
indirectResellerCount double Recuento de revendedores indirectos
top string Número de filas de datos que se devuelven en la solicitud. El valor máximo y el valor predeterminado, si no se especifican, es 10 000. Si hay más filas en la consulta, el cuerpo de la respuesta incluye un vínculo 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 consultar grandes conjuntos de datos. Por ejemplo, top=10000 and skip=0 recupera las primeras 10000 filas de datos, top=10000 and skip=10000 recupera las siguientes 10000 filas de datos, etc.
filter string El parámetro filter de la solicitud contiene una o más instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un campo y un valor que están 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
Mercado
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 necesario para el que quieres recuperar 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 datos de resultado 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 un orden ascendente o descendente para cada campo. El valor predeterminado es asc.

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

partnerTenantId
id
Nombre
Mercado
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 si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. 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