모든 배송 레이블 가져오기
Microsoft Hardware API에서 이 메서드를 사용하여 특정 제품 제출의 모든 배송 레이블에 대한 데이터를 검색합니다.
사전 요구 사항
아직 수행하지 않은 경우 이러한 메서드를 사용하기 전에 Microsoft 하드웨어 API에 대한 모든 필수 구성 요소를 완료합니다. 이러한 방법을 사용하려면 먼저 제품 및 제출이 개발자 센터 계정에 이미 있어야 합니다. 제품에 대한 제출을 만들거나 관리하려면 제품 제출 관리의 방법을 참조하세요.
요청
이 메서드에는 다음 구문이 있습니다. 헤더 및 요청 본문의 사용 예제와 설명은 다음 섹션을 참조하세요.
| 방법 | 요청 URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
요청 헤더
| 헤더 | 형식 | Description |
|---|---|---|
| 권한 부여 | 문자열 | 필수 사항입니다. 전달자 *<토큰*형식의 Microsoft Entra ID 액세스 토큰>입니다. |
| accept | 문자열 | (선택 사항) 콘텐츠 형식을 지정합니다. 허용되는 값은 "application/json"입니다. |
요청 매개 변수
이 메서드에 대한 요청 매개 변수를 제공하지 마세요.
요청 본문
이 메서드에 대한 요청 본문을 제공하지 않습니다.
요청 예제
다음 예제에서는 계정에 등록된 모든 제품에 대한 정보를 검색하는 방법을 보여 줍니다.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/ HTTP/1.1
Authorization: Bearer <your access token>
응답
다음 예제에서는 개발자 계정에 등록된 제품의 특정 제출에 대한 모든 배송 레이블에 대한 성공적인 요청에 의해 반환된 JSON 응답 본문을 보여 줍니다. 간단히 하기 위해 이 예제에서는 요청에서 반환된 처음 세 개의 배송 레이블에 대한 데이터만 보여 줍니다. 응답 본문의 값에 대한 세부 정보는 예제 다음 표에 표시됩니다.
{
"value": [
{
"id": 1152921504606980300,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"publishingSpecifications": {
"goLiveDate": "2018-04-04T16:11:27.2965057+00:00",
"visibleToAccounts": [],
"isAutoInstallDuringOSUpgrade": true,
"isAutoInstallOnApplicableSystems": true,
"isDisclosureRestricted": false,
"publishToWindows10s": false,
"additionalInfoForMsApproval": {
"microsoftContact": "abc@mcirosoft.com",
"validationsPerformed": "Validation 1",
"affectedOems": [
"OEM1",
"OEM2"
],
"isRebootRequired": false,
"isCoEngineered": true,
"isForUnreleasedHardware": true,
"hasUiSoftware": false,
"businessJustification": "This is a business justification"
}
},
"workflowStatus": {
"currentStep": "microsoftApproval",
"state": "started",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606980231",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606980231",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "Publish to Windows Update with promotions",
"destination": "windowsUpdate"
},
{
"id": 1152921504606978500,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"recipientSpecifications": {
"receiverPublisherId": "27691110",
"enforceChidTargeting": false
},
"workflowStatus": {
"currentStep": "finalizeSharing",
"state": "completed",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978460",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978460",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "Share submission with another Partner",
"destination": "anotherPartner"
},
{
"id": 1152921504606978500,
"productId": 14461751976964156,
"submissionId": 1152921504621467600,
"publishingSpecifications": {
"goLiveDate": "2018-04-03T04:50:52.2293001+00:00",
"visibleToAccounts": [],
"isAutoInstallDuringOSUpgrade": false,
"isAutoInstallOnApplicableSystems": false,
"isDisclosureRestricted": false,
"publishToWindows10s": false
},
"workflowStatus": {
"currentStep": "finalizePublishing",
"state": "completed",
"messages": []
},
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978538",
"rel": "self",
"method": "GET"
},
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978538",
"rel": "update_shippinglabel",
"method": "PATCH"
}
],
"name": "Publish to Windows Update without promotions",
"destination": "windowsUpdate"
}
],
"links": [
{
"href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products?pageSize=50",
"rel": "self",
"method": "GET"
}
]
}
이 리소스의 값은 다음과 같습니다.
| 값 | 형식 | Description |
|---|---|---|
| 값 | array | 각 배송 레이블에 대한 정보를 포함하는 개체의 배열입니다. 각 개체의 데이터에 대한 자세한 내용은 레이블 리소스 전달을 참조하세요. |
| 링크 | array | 포함된 엔터티에 대한 유용한 링크가 있는 개체의 배열입니다. 자세한 내용은 Link 개체 를 참조하세요. |
오류 코드
오류 코드에 대한 자세한 내용은 오류 코드를 참조하세요.