모든 추천 분석 정보 가져오기
에 적용: 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터
고객에 대한 모든 추천 분석 정보를 가져오는 방법입니다.
필수 구성 요소
- 파트너 센터 인증에 설명된 대로 자격 증명. 이 시나리오에서는 사용자 자격 증명으로만 인증을 지원합니다.
REST 요청
요청 구문
메서드 | 요청 URI |
---|---|
가져오기 | {baseURL}/partner/v1/analytics/referrals HTTP/1.1 |
URI 매개 변수
매개 변수 | 유형 | 묘사 |
---|---|---|
필터 | 문자열 | 필터 조건과 일치하는 데이터를 반환합니다. 예: .../referrals?filter=field eq 'value' |
그룹바이 | 문자열 | 사용 약관과 날짜를 모두 지원합니다. 버킷 수를 제한하기 위한 쇼트 서킷 논리입니다. 예: .../referrals?groupby=termField1,dateField1,termField2 |
집계 수준 | 문자열 |
aggregationLevel 매개 변수에는 groupby필요합니다.
aggregationLevel 매개 변수는 groupby에 포함된 모든 날짜 필드에 적용됩니다. 예시: .../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day |
맨 위로 | 문자열 | 페이지 제한은 10000입니다. 10000보다 작은 값을 사용합니다. 예제: .../referrals?top=100 |
건너뛰다 | 문자열 | 건너뛸 행 수입니다. 예: .../referrals?top=100&skip=100 |
요청 헤더
요청 본문
없음.
요청 예제
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
REST 응답
성공하면 응답 본문에는 추천 리소스 모음이 포함됩니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽습니다. 전체 목록은 오류 코드참조하세요.
응답 예제
{
"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"
}