Obtener toda la información de análisis de las búsquedas
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 búsqueda 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/search HTTP/1.1 |
Parámetros de URI
| Parámetro | Tipo | Description |
|---|---|---|
filter |
string | Devuelve datos que coinciden con la condición de filtro. Ejemplo: .../search?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: .../search?groupby=termField1,dateField1,termField2 |
| aggregationLevel | string | El parámetro aggregationLevel requiere un groupby. El aggregationLevel parámetro se aplica a todos los campos de fecha presentes en .groupby Ejemplo: .../search?groupby=termField1,dateField1,termField2&aggregationLevel=day |
top |
string | El límite de página es 10000. Toma cualquier valor menor que 10000. Ejemplo: .../search?top=100 |
skip |
string | Número de filas que se van a omitir. Ejemplo: .../search?top=100&skip=100 |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de solicitud
Ninguno.
Ejemplo de solicitud
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/search 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 búsqueda .
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional 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
{
"companyName": "my company",
"contactButtonClicked": false,
"keywordCountry": null,
"detailsViewed": true,
"keywordIndustryFocus": null,
"mpnId": 2604568,
"partnerMarket": "CN",
"keywordProduct": null,
"referralSubmitted": false,
"searchDate": "2018-05-30",
"keywordSearchText": " my company"
}