Obter todas as informações de análise de referências
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
- Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação somente com credenciais de usuário.
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"
}