Obter todas as informações de análise de referênciasGet all referrals analytics information

Aplica-se aApplies To

  • Partner CenterPartner Center
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Como obter todas as informações de análise de referências para seus clientes.How to get all the referrals analytics information for your customers.

Pré-requisitosPrerequisites

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET * { BASEURL } */Partner/v1/Analytics/referrals http/1.1{baseURL}/partner/v1/analytics/referrals HTTP/1.1

Parâmetros do URIURI parameters

ParâmetroParameter TypeType DescriçãoDescription
filtrofilter stringstring Retorna os dados que correspondem à condição de filtro.Returns data matching the filter condition.
Exemplo:Example:
.../referrals?filter=field eq 'value'
groupbygroupby stringstring Dá suporte a termos e datas.Supports both terms and dates. Lógica de circuito curto para limitar o número de buckets.Short circuit logic to limit the number of buckets.
Exemplo:Example:
.../referrals?groupby=termField1,dateField1,termField2
aggregationLevelaggregationLevel stringstring O parâmetro aggregationLevel requer um GroupBy.The aggregationLevel parameter requires a groupby. O parâmetro aggregationLevel se aplica a todos os campos de data presentes no GroupBy.The aggregationLevel parameter applies to all date fields present in the groupby.
Exemplo:Example:
.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day
toptop stringstring O limite de página é 10000.The page limit is 10000. Usa qualquer valor menor que 10000.Takes any value less than 10000.
Exemplo:Example:
.../referrals?top=100
skipskip stringstring Número de linhas a serem ignoradas.Number of rows to skip.
Exemplo:Example:
.../referrals?top=100&skip=100

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

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

Resposta RESTREST response

Se for bem-sucedido, o corpo da resposta conterá uma coleção de recursos de referências .If successful, the response body contains a collection of Referrals resources.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de Erro.For the full list, see Error Codes.

Exemplo de respostaResponse example

{
  "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 tambémSee also