Abrufen aller Versandetiketten
Verwenden Sie diese Methode in der Microsoft-Hardware-API , um Daten für alle Versandetiketten einer bestimmten Übermittlung eines Produkts abzurufen.
Voraussetzungen
Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft-Hardware-APIs erfüllen, bevor Sie versuchen, eine dieser Methoden zu verwenden. Bevor Sie diese Methoden verwenden können, müssen das Produkt und die Übermittlung bereits in Ihrem Dev Center-Konto vorhanden sein. Informationen zum Erstellen oder Verwalten von Übermittlungen für Produkte finden Sie unter Verwalten von Produktübermittlungen.
Anforderung
Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.
| Methode | Anforderungs-URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
Anforderungsheader
| Header | type | BESCHREIBUNG |
|---|---|---|
| Authorization | Zeichenfolge | Erforderlich. Die Microsoft Entra ID-Zugriffstoken im Format Bearer *<token>*. |
| accept (Akzeptieren) | Zeichenfolge | Optional. Gibt den Typ des Inhalts an. Zulässiger Wert ist "application/json" |
Anforderungsparameter
Geben Sie keine Anforderungsparameter für diese Methode an.
Anforderungstext
Stellen Sie keinen Anforderungstext für diese Methode bereit.
Anforderungsbeispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie Informationen zu allen Produkten abrufen, die in Ihrem Konto registriert sind.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/ HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Im folgenden Beispiel wird der JSON-Antworttext veranschaulicht, der von einer erfolgreichen Anforderung für alle Versandetiketten einer bestimmten Übermittlung eines Produkts zurückgegeben wird, das bei Ihrem Entwicklerkonto registriert ist. Aus Gründen der Kürze zeigt dieses Beispiel nur die Daten für die ersten drei Versandetiketten, die von der Anforderung zurückgegeben werden. Details zu den Werten im Antworttext werden in der Tabelle nach dem Beispiel angezeigt.
{
"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"
}
]
}
Diese Ressource weist die folgenden Werte auf:
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| value | array | Ein Array von -Objekten, die Informationen zu den einzelnen Versandetiketten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unter Versandbezeichnungsressource. |
| Verknüpfungen | array | Ein Array von -Objekten mit hilfreichen Links zur enthaltenden Entität. Weitere Informationen finden Sie unter Link-Objekt . |
Fehlercodes
Informationen zu Fehlercodes finden Sie unter Fehlercodes.