Obtener datos de las etiquetas de envío

Para ver una introducción a las API de hardware de Microsoft, incluidos los requisitos previos para usar las API, consulte Administrar envíos de hardware mediante API.

Utilice los siguientes métodos en las API de hardware de Microsoft para obtener datos de las etiquetas de envío de productos de hardware registrados en su cuenta de Hardware Dev Center.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/

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 gestionar presentaciones de productos, consulte los métodos en "Administrar presentaciones de productos".

Descripción	Método	URI
Obtener datos para todas las etiquetas de envío de un envío	GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/`
Obtener datos para una etiqueta de envío específica de un envío	GET	`https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/{shippingLabelId}`

Prerequisites

Si aún no lo ha hecho, complete todos los Prerequisites para las API de hardware de Microsoft antes de intentar usar cualquiera de estos métodos.

Recursos de datos

Los métodos de API de panel de hardware Microsoft para obtener datos de etiquetas de envío usan los siguientes recursos de datos JSON.

Recurso de etiqueta de envío

Este recurso representa una etiqueta de envío creada para la presentación de su producto registrado en su cuenta.

{
  "id": 1152921504606978422,
  "productId": 14461751976964157,
  "submissionId": 1152921504621467613,
  "publishingSpecifications": {
    "goLiveDate": "2018-04-12T05:28:32.721Z",
    "visibleToAccounts": [
      27691110, 27691111
    ],
    "isAutoInstallDuringOSUpgrade": true,
    "isAutoInstallOnApplicableSystems": true,
    "isDisclosureRestricted": false,
    "publishToWindows10s": false,
    "additionalInfoForMsApproval": {
      "microsoftContact": "abc@microsoft.com",
      "validationsPerformed": "Validation 1",
      "affectedOems": [
        "OEM1", "OEM2"
      ],
      "isRebootRequired": false,
      "isCoEngineered": true,
      "isForUnreleasedHardware": true,
      "hasUiSoftware": false,
      "businessJustification": "This is a business justification"
    }
  },
  "recipientSpecifications": {
    "receiverPublisherId": "27691110",
    "enforceChidTargeting": true,
    "blockDuaCreation": false
  },
  "targeting": {
    "hardwareIds": [
      {
        "bundleId": "amd64",
        "infId": "foo.inf",
        "operatingSystemCode": "WINDOWS_v100_SERVER_X64_RS5_FULL",
        "pnpString": "hid\\vid_dummy256f&pid_dummyc62f",
        "distributionState": "pendingAdd"
      }
    ],
    "chids": [
      {
        "chid": "346511cf-ccee-5c6d-8ee9-3c70fc7aae83",
        "distributionState": "pendingAdd"
      }
    ],
    "restrictedToAudiences": [
      "00000000-0000-0000-0000-000000000000",
      "00000000-0000-0000-0000-000000000001"
      ],
    "inServicePublishInfo": {
      "flooring": "RS1",
      "ceiling": "RS3"
    },
    "coEngDriverPublishInfo": {
      "flooringBuildNumber": 17135,
      "ceilingBuildNumber": 17139
    }  
  },
  "workflowStatus": {
    "currentStep": "finalizePublishing",
    "state": "completed",
    "messages": [],
    "errorReport": ""
  },
  "links": [
    {
      "href": "https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/1152921504606978422",
      "rel": "self",
      "method": "GET"
    }
  ],
  "name": "Shipping Label Name",
  "destination": "windowsUpdate"
}

Este recurso tiene los siguientes valores:

Value	Tipo	Descripción
id	long	Identificador de la etiqueta de envío
productId	long	Identificador de producto privado al que está asociada esta etiqueta de envío
Id de envío	long	Identificador de envío al que está asociada esta etiqueta de envío
publishingSpecifications	object	Consulte el objeto de especificaciones de publicación para obtener más detalles.
especificaciones del destinatario	matriz de objetos	Consulte el objeto de especificaciones del destinatario para obtener más detalles.
focalización	object	Consulte el objeto de destino para obtener más detalles.
workflowStatus	object	Este objeto muestra el estado del flujo de trabajo para esta etiqueta de envío. Consulte el objeto de estado del flujo de trabajo de etiqueta de envío para obtener más detalles.
Enlaces	matriz de objetos	Para obtener más información, consulta link object ( Objeto de vínculo).
nombre	string	Nombre de la etiqueta de envío
destino	string	Indica el destino de la etiqueta de envío. Los valores posibles son (descripción entre paréntesis): anotherPartner (esta etiqueta de envío es para compartir el envío con otro asociado) windowsUpdate (este etiqueta de envío es para publicar en Windows Update) notSet

Objeto de especificaciones de publicación

Este objeto representa las especificaciones de cómo se publicará un objeto en Windows Update. Este objeto estará disponible o necesario solo cuando el destino de la etiqueta de envío sea windowsUpdate.

{
  "goLiveDate": "2018-04-12T05:28:32.721Z",
  "visibleToAccounts": [
    27691110,
    27691111
  ],
  "isAutoInstallDuringOSUpgrade": true,
  "isAutoInstallOnApplicableSystems": true,
  "isDisclosureRestricted": false,
  "publishToWindows10s": false,
  "additionalInfoForMsApproval": {
    "microsoftContact": "abc@microsoft.com",
    "validationsPerformed": "Validation 1",
    "affectedOems": [
      "OEM1",
      "OEM2"
    ],
    "isRebootRequired": false,
    "isCoEngineered": true,
    "isForUnreleasedHardware": true,
    "hasUiSoftware": false,
    "businessJustification": "This is a business justification"
  }
}