Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: Centro de Parceiros | Nuvem Microsoft para o Governo dos EUA
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. 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/referrals HTTP/1.1 |
Parâmetros de URI
| Parâmetro | Tipo | Descrição |
|---|---|---|
| filtrar | string | Retorna dados correspondentes à 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 caçambas. Exemplo: .../referrals?groupby=termField1,dateField1,termField2 |
| nível de agregação | string | O parâmetro nível de agregação requer um agrupamento. O parâmetro nível de agregação aplica-se a todos os campos de data presentes no groupby. Exemplo: .../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day |
| Início | cadeia de caracteres | O limite de páginas é 10000. Leva qualquer valor inferior a 10000. Exemplo: .../referrals?top=100 |
| pular | string | Número de linhas a ignorar. Exemplo: .../referrals?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/referrals HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
Resposta REST
Se bem-sucedido, o corpo da resposta contém uma coleção de recursos de referências .
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 adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte 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"
}