Obtenha todas as informações de análise de pesquisa

Artigo
03/07/2025

Aplica-se a: Centro de Parceiros | Centro de Parceiros operado pela 21Vianet | Centro de Parceiros para a Nuvem Microsoft para o Governo dos EUA

Como obter todas as informações de análise de pesquisa para seus clientes.

Pré-requisitos

Credenciais de autenticação conforme descrito em Partner Center. Este cenário suporta autenticação apenas com credenciais de Utilizador.

Pedido REST

Sintaxe da solicitação

Método	Solicitar URI
OBTER	{baseURL}/partner/v1/analytics/search HTTP/1.1

Parâmetros de URI

Parâmetro	Tipo	Descrição
`filter`	string	Retorna dados correspondentes à condição do filtro. Exemplo: `.../search?filter=field eq 'value'`
`groupby`	string	Suporta ambos termos e datas. Lógica de curto-circuito para limitar o número de caçambas. Exemplo: `.../search?groupby=termField1,dateField1,termField2`
nível de agregação	string	O parâmetro agregaçãoLevel requer um `groupby`. O parâmetro `aggregationLevel` aplica-se a todos os campos de data presentes no `groupby`. Exemplo: `.../search?groupby=termField1,dateField1,termField2&aggregationLevel=day`
`top`	string	O limite de páginas é 10000. Leva qualquer valor inferior a 10000. Exemplo: `.../search?top=100`
`skip`	string	Número de linhas a ignorar. Exemplo: `.../search?top=100&skip=100`

Cabeçalhos de solicitação

Para obter mais informações, consulte cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhuma.

Exemplo de solicitação

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

Resposta REST

Se for bem-sucedida, o corpo da resposta conterá uma coleção de recursos de Pesquisa.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações de depuração extras. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e outros parâmetros. Para obter a lista completa, consulte Códigos de erro.

Exemplo de resposta

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

Ver também

Partner Center Analytics - Recursos

Partilhar via