제품 매트릭스 가져오기
이 문서에서는 지정된 월에 대한 제품 매트릭스를 가져오는 방법을 설명합니다. 제품 매트릭스에는 제품 및 sku에 대한 속성 및 구매 규칙이 포함됩니다. 이 메서드는 월별 기록을 가져오는 필터를 지원합니다.
필수 조건
- 자격 증명은 파트너 API 인증에 설명되어 있습니다. 이 시나리오에서는 애플리케이션 사용자 인증만 지원합니다. 애플리케이션 전용은 아직 지원되지 않습니다. http 오류:400이 발생하는 파트너는 파트너 API 인증 설명서를 참조해야 합니다.
- 이 API는 현재 파트너가 관리 에이전트 또는 판매 에이전트 역할 중 하나에 있어야 하는 사용자 액세스만 지원합니다.
세부 정보
- 현재는 업데이트된 새 상거래 라이선스 기반 제품에 대해서만 데이터를 반환합니다.
- 현재 가격에는 API가 호출된 날짜까지 현재 월 동안 사용할 수 있는 제품이 포함됩니다. 이전 달에는 선택한 달의 마지막 날짜를 기준으로 한 날짜가 포함됩니다.
- 이 메서드는 데이터를 파일 스트림으로 반환합니다. 파일 스트림은 .csv 파일 또는 압축된 .csv 버전입니다. 압축된 파일을 요청하는 방법에 대한 세부 정보는 다음과 같습니다.
REST 요청
요청 구문
| 메서드 | 요청 URI |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value |
URI 필터 매개 변수
다음 필터 매개 변수를 사용합니다.
| 속성 | Type | 필수 | 설명 |
|---|---|---|---|
| Month | string | 아니요 | 요청되는 가격표에 대해 YYYYMM을 준수해야 합니다. |
요청 헤더
- 자세한 내용은 파트너 REST 헤더를 참조하세요.
이러한 헤더 외에도 가격 책정 파일을 압축된 것으로 검색하여 대역폭 및 다운로드 시간을 줄일 수 있습니다. 기본적으로 파일은 압축되지 않습니다. 압축된 버전의 파일을 얻으려면 다음 헤더 값을 포함할 수 있습니다. 압축 시트는 2020년 4월부터만 사용할 수 있으며, 2020년 4월 이전의 모든 시트는 압축되지 않은 것으로만 사용할 수 있습니다.
| 헤더 | 값 유형 | 값 | 설명 |
|---|---|---|---|
| Accept-Encoding | string | 폐 | 선택 사항. 생략하면 파일 스트림이 압축되지 않습니다. |
요청 예제
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
REST 응답
성공하면 이 메서드는 제품 행렬을 파일 스트림으로 반환합니다. 파일 스트림은 .csv 파일 또는 압축된 .csv 버전입니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.
응답 예제
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries"
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============