Obtener todas las etiquetas de envío
Use este método en la API de hardware de Microsoft para recuperar datos de todas las etiquetas de envío de un envío específico de un producto.
Requisitos previos
Si aún no lo ha hecho, complete todos los requisitos previos para las API de hardware de Microsoft antes de intentar usar cualquiera de estos métodos. Para poder usar estos métodos, el producto y el envío ya deben existir en su cuenta del Centro de desarrollo. Para crear o administrar envíos para productos, consulte los métodos de Administrar envíos de productos.
Solicitud
Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.
| Método | URI de solicitud |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
Encabezado de solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| Authorization | string | Necesario. Token de acceso de id. de Microsoft Entra en el formulario Bearer *<token>*. |
| accept | string | Opcional. Especifica el tipo de contenido. El valor permitido es "application/json" |
Parámetros de solicitud
No proporcione parámetros de solicitud para este método.
Cuerpo de la solicitud
No incluyas un cuerpo de la solicitud para este método.
Ejemplos de solicitud
En el ejemplo siguiente se muestra cómo recuperar información sobre todos los productos registrados en su cuenta.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/ HTTP/1.1
Authorization: Bearer <your access token>
Response
En el ejemplo siguiente se muestra el cuerpo de respuesta JSON devuelto por una solicitud correcta para todas las etiquetas de envío de un envío específico de un producto registrado en la cuenta de desarrollador. Por motivos de brevedad, en este ejemplo solo se muestran los datos de las tres primeras etiquetas de envío devueltas por la solicitud. Los detalles sobre los valores del cuerpo de la respuesta aparecen en la tabla siguiente al ejemplo.
{
"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"
}
]
}
Este recurso tiene los siguientes valores:
| Valor | Tipo | Descripción |
|---|---|---|
| value | array | Matriz de objetos que contienen información sobre cada etiqueta de envío. Para obtener más información sobre los datos de cada objeto, consulte Recurso de etiqueta de envío. |
| vínculos | array | Matriz de objetos con vínculos útiles sobre la entidad contenedora. Para obtener más información, consulte Link object (Objeto Link ). |
Códigos de error
Para obtener información, sobre los códigos de error, consulte Códigos de error.