Obtener toda la información de análisis de las referencias

Artículo
07/04/2024

Se aplica a: Centro de partners | Centro de partners para Microsoft Cloud for US Government

Cómo obtener toda la información de análisis de referencias 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/referrals HTTP/1.1

Parámetros de URI

Parámetro	Tipo	Descripción
filter	string	Devuelve datos que coinciden con la condición de filtro. Ejemplo: `.../referrals?filter=field eq 'value'`
groupby	string	Admite tanto los términos como las fechas. Lógica de cortocircuito para limitar el número de cubos. Ejemplo: `.../referrals?groupby=termField1,dateField1,termField2`
aggregationLevel	string	El parámetro aggregationLevel requiere un groupby. El parámetro aggregationLevel se aplica a todos los campos de fecha presentes en groupby. Ejemplo: `.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day`
superior	string	El límite de página es 10000. Toma cualquier valor menor que 10000. Ejemplo: `.../referrals?top=100`
skip	string	Número de filas que se van a omitir. Ejemplo: `.../referrals?top=100&skip=100`

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/referrals 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 referencias .

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

{
  "id": "112310",
  "status": "Accepted",
  "customerMarket": "US",
  "customerName": "Best Customer Ever",
  "customerOrgSize": "10to50employees",
  "acceptedDate": "2018-02-07T23:43:19",
  "acknowledgedDate": "2018-02-07T23:40:50",
  "archivedDate": null,
  "declinedDate": null,
  "expiredDate": null,
  "lostDate": null,
  "missedDate": null,
  "createdDate": "2018-02-04T23:08:59",
  "skippedDate": null,
  "wonDate": null,
  "partnerMarket": "US"
}

Consulte también

Análisis del Centro de partners: recursos

Compartir vía