Compartilhar via

Obter todas as informações de análise de referências

  • Artigo

Aplica-se a: Partner Center | Partner Center para o Microsoft Cloud for US Government

Como obter todas as informações analíticas de referências para seus clientes.

Pré-requisitos

Solicitação REST

Sintaxe da solicitação

Método URI da solicitação
GET {baseURL}/partner/v1/analytics/referrals HTTP/1.1

Parâmetros do URI

Parâmetro Tipo Descrição
filtro string Retorna dados que correspondem à condição do filtro.
Exemplo:
.../referrals?filter=field eq 'value'
groupby string Suporta termos e datas. Lógica de curto-circuito para limitar o número de buckets.
Exemplo:
.../referrals?groupby=termField1,dateField1,termField2
aggregationLevel string O parâmetro aggregationLevel requer um groupby. O parâmetro aggregationLevel se aplica a todos os campos de data presentes no groupby.
Exemplo:
.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day
top string O limite de páginas é 10000. Assume qualquer valor menor que 10000.
Exemplo:
.../referrals?top=100
skip string Número de linhas a serem ignoradas.
Exemplo:
.../referrals?top=100&skip=100

Cabeçalhos da solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

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 REST

Se for bem-sucedido, o corpo da resposta conterá uma coleção de recursos de referências .

Códigos de êxito e de erro de resposta

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

Exemplo de resposta

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

Confira também