Obtener toda la información de análisis de los revendedores indirectosGet all indirect resellers analytics information

Se aplica aApplies To

  • Centro de partnersPartner Center
  • Centro de partners operado por 21VianetPartner Center operated by 21Vianet
  • Centro de partners para Microsoft Cloud AlemaniaPartner Center for Microsoft Cloud Germany
  • Centro de partners para Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Cómo obtener toda la información de análisis de los revendedores indirectos para los clientes.How to get all the indirect resellers analytics information for your customers.

Requisitos previosPrerequisites

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET * { BASEURL } */Partner/v1/Analytics/indirectresellers http/1.1{baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parámetros de URIURI parameters

ParámetroParameter TipoType DescripciónDescription
partnerTenantIdpartnerTenantId stringstring El identificador de inquilino del asociado para el que desea recuperar los datos de los revendedores indirectos.The Tenant ID of the partner for which you want to retrieve indirect resellers data.
idid stringstring ID. de revendedor indirectoIndirect reseller ID
namename stringstring El nombre del socio comercial para el que desea recuperar los datos de los revendedores indirectos.The Name of the partner for which you want to retrieve indirect resellers data.
marketmarket stringstring El mercado del socio comercial para el que desea recuperar los datos de los revendedores indirectos.The Market of the partner for which you want to retrieve indirect resellers data.
firstSubscriptionCreationDatefirstSubscriptionCreationDate cadena en formato de fecha y hora UTCstring in UTC date time format La fecha de creación de la primera suscripción basada en la que desea recuperar los datos de los revendedores indirectos.The creation date of the first subscription based on which you want to retrieve indirect resellers data.
latestSubscriptionCreationDatelatestSubscriptionCreationDate cadena en formato de fecha y hora UTCstring in UTC date time format La fecha de creación de la suscripción más reciente.The creation date of the latest subscription.
firstSubscriptionEndDatefirstSubscriptionEndDate cadena en formato de fecha y hora UTCstring in UTC date time format Primera vez que se ha finalizado la suscripción.First time any subscription was ended.
latestSubscriptionEndDatelatestSubscriptionEndDate cadena en formato de fecha y hora UTCstring in UTC date time format Última fecha de finalización de una suscripción.Latest date when any subscription was ended.
firstSubscriptionSuspendedDatefirstSubscriptionSuspendedDate cadena en formato de fecha y hora UTCstring in UTC date time format Primera vez que se suspendió cualquier suscripción.First time any subscription was suspended.
latestSubscriptionSuspendedDatelatestSubscriptionSuspendedDate cadena en formato de fecha y hora UTCstring in UTC date time format Última fecha en la que se suspendió una suscripción.Latest date when any subscription was suspended.
firstSubscriptionDeprovisionedDatefirstSubscriptionDeprovisionedDate cadena en formato de fecha y hora UTCstring in UTC date time format Primera vez que se desaprovisiona cualquier suscripción.First time any subscription was deprovisioned.
latestSubscriptionDeprovisionedDatelatestSubscriptionDeprovisionedDate cadena en formato de fecha y hora UTCstring in UTC date time format Última fecha en que se canceló el aprovisionamiento de cualquier suscripción.Latest date when any subscription was deprovisioned.
subscriptionCountsubscriptionCount doubledouble Recuento de suscripciones para todos los revendedores de valor agregadoSubscription count for all value added resellers
licenseCountlicenseCount doubledouble Recuento de licencias para todos los revendedores de valor agregadoLicense count for all value added resellers
indirectResellerCountindirectResellerCount doubledouble Número de distribuidores indirectosIndirect resellers count
toptop stringstring Número de filas de datos que se devuelven en la solicitud.The number of rows of data to return in the request. El valor máximo y el valor predeterminado, si no se especifican, es 10 000.The maximum value and the default value if not specified is 10000. 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.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data.
skipskip intint

Número de filas que se omiten en la consulta.The number of rows to skip in the query. Usa este parámetro para consultar grandes conjuntos de datos.Use this parameter to page through large data sets. 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.For example, top=10000 and skip=0 retrieves the first 10000 rows of data, top=10000 and skip=10000 retrieves the next 10000 rows of data, and so on.

filterfilter stringstring

El parámetro filter de la solicitud contiene una o más instrucciones que filtran las filas de la respuesta.The filter parameter of the request contains one or more statements that filter the rows in the response. Cada instrucción contiene un campo y un valor asociados a los operadores eq o ne; asimismo, puedes combinar las instrucciones mediante and u or.Each statement contains a field and value that are associated with the eq or ne operators, and statements can be combined using and or or. Puedes especificar los siguientes campos:You can specify the following fields:

  • partnerTenantIdpartnerTenantId
  • idid
  • NombreName
  • datamarketmarket
  • firstSubscriptionCreationDatefirstSubscriptionCreationDate
  • latestSubscriptionCreationDatelatestSubscriptionCreationDate
  • firstSubscriptionEndDatefirstSubscriptionEndDate
  • latestSubscriptionEndDatelatestSubscriptionEndDate
  • firstSubscriptionSuspendedDatefirstSubscriptionSuspendedDate
  • latestSubscriptionSuspendedDatelatestSubscriptionSuspendedDate
  • firstSubscriptionDeprovisionedDatefirstSubscriptionDeprovisionedDate
  • latestSubscriptionDeprovisionedDatelatestSubscriptionDeprovisionedDate

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

Ejemplo:Example:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))

aggregationLevelaggregationLevel stringstring

Especifica el intervalo de tiempo necesario para el que quieres recuperar datos agregados.Specifies the time range for which to retrieve aggregate data. Puede ser una de las siguientes cadenas: "día", "semana" o "mes".Can be one of the following strings: "day", "week", or "month". Si no se especifica, el valor predeterminado es "día".If unspecified, the default is "day".

aggregationLevelno se admite sin un aggregationLevel .aggregationLevel isn't supported without a aggregationLevel. aggregationLevelse aplica a todos los datefields presentes en elaggregationLevelaggregationLevel applies to all datefields present in the aggregationLevel

orderbyorderby stringstring

Instrucción que ordena los valores de los datos de resultado de cada instalación.A statement that orders the result data values for each install. La sintaxis es ...&orderby=field[order],field [order],....The syntax is ...&orderby=field[order],field [order],.... El parámetro field puede ser una de las siguientes cadenas:The field parameter can be one of the following strings:

  • "partnerTenantId""partnerTenantId"
  • "id""id"
  • "name""name"
  • "datamarket""market"
  • "firstSubscriptionCreationDate""firstSubscriptionCreationDate"
  • "latestSubscriptionCreationDate""latestSubscriptionCreationDate"
  • "firstSubscriptionEndDate""firstSubscriptionEndDate"
  • "latestSubscriptionEndDate""latestSubscriptionEndDate"
  • "firstSubscriptionSuspendedDate""firstSubscriptionSuspendedDate"
  • "latestSubscriptionSuspendedDate""latestSubscriptionSuspendedDate"
  • "firstSubscriptionDeprovisionedDate""firstSubscriptionDeprovisionedDate"
  • "latestSubscriptionDeprovisionedDate""latestSubscriptionDeprovisionedDate"
  • "subscriptionCount""subscriptionCount"
  • "licenseCount""licenseCount"

El parámetro Order es opcional y puede ser asc o desc ; para especificar un orden ascendente o descendente para cada campo.The order parameter is optional, and can be asc or desc; to specify ascending or descending order for each field. De manera predeterminada, es asc.The default is asc.

Ejemplo:Example:
...&orderby=market,subscriptionCount

groupbygroupby stringstring

Una instrucción que aplica la agregación de datos únicamente a los campos especificados.A statement that applies data aggregation only to the specified fields. Puedes especificar los siguientes campos:You can specify the following fields:

  • partnerTenantIdpartnerTenantId
  • idid
  • NombreName
  • datamarketmarket
  • firstSubscriptionCreationDatefirstSubscriptionCreationDate
  • latestSubscriptionCreationDatelatestSubscriptionCreationDate
  • firstSubscriptionEndDatefirstSubscriptionEndDate
  • latestSubscriptionEndDatelatestSubscriptionEndDate
  • firstSubscriptionSuspendedDatefirstSubscriptionSuspendedDate
  • latestSubscriptionSuspendedDatelatestSubscriptionSuspendedDate
  • firstSubscriptionDeprovisionedDatefirstSubscriptionDeprovisionedDate
  • latestSubscriptionDeprovisionedDatelatestSubscriptionDeprovisionedDate

Las filas de datos devueltas contienen los campos especificados en la groupby cláusula y los campos siguientes:The data rows returned contain the fields specified in the groupby clause, and the following fields:

  • indirectResellerCountindirectResellerCount
  • licenseCountlicenseCount
  • subscriptionCountsubscriptionCount

El groupby parámetro se puede utilizar con el aggregationLevel parámetro.The groupby parameter can be used with the aggregationLevel parameter.

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

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

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 RESTREST response

Si se realiza correctamente, el cuerpo de respuesta contiene una colección de recursos de revendedores indirectos .If successful, the response body contains a collection of indirect resellers resources.

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte Códigos de error.For the full list, see Error Codes.

Ejemplo de respuestaResponse example

{
    "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
}

Vea tambiénSee also