Получить все этикетки для доставки
Используйте этот метод в API оборудования Майкрософт для получения данных обо всех этикетках доставки определенной отправки продукта.
Предварительные требования
Если вы еще не сделали этого, выполните все предварительные требования для API оборудования Майкрософт, прежде чем пытаться использовать любой из этих методов. Прежде чем использовать эти методы, продукт и отправка должны уже существовать в вашей учетной записи Центра разработки. Сведения о создании отправок для продуктов и управлении ими см. в статье Управление отправками продуктов.
Запрос
У этого метода следующий синтаксис. Примеры использования и описание текста заголовка и запроса приведены в следующих разделах.
| Метод | Универсальный код ресурса (URI) запроса |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
Заголовок запроса
| Заголовок | Тип | Описание |
|---|---|---|
| Авторизация | строка | Обязательный. Маркер доступа идентификатора Microsoft Entra в формате Bearer *<token>*. |
| 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"
}
]
}
Этот ресурс имеет следующие значения:
| Значение | Тип | Описание |
|---|---|---|
| value | array | Массив объектов , содержащих сведения о каждой этикетке доставки. Дополнительные сведения о данных в каждом объекте см. в разделе Ресурс метки доставки. |
| ссылки | array | Массив объектов с полезными ссылками на содержащую сущность. Дополнительные сведения см. в разделе Объект Link . |
Коды ошибок
Дополнительные сведения о кодах ошибок см. в разделе Коды ошибок.