Ottenere tutte le etichette di spedizione
Usare questo metodo nell'API Hardware Microsoft per recuperare i dati per tutte le etichette di spedizione di un invio specifico di un prodotto.
Prerequisiti
Se non è già stato fatto, completare tutti i prerequisiti per le API hardware Microsoft prima di provare a usare uno di questi metodi. Prima di poter usare questi metodi, il prodotto e l'invio devono esistere già nell'account dev Center. Per creare o gestire gli invii per i prodotti, vedere i metodi in Gestire gli invii di prodotti.
Richiesta
La sintassi di questo metodo è la seguente. Vedi le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del contenuto della richiesta.
| Metodo | URI richiesta |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
Intestazione della richiesta
| Intestazione | Tipo | Descrizione |
|---|---|---|
| Autorizzazione | string | Obbligatorio. Token di accesso Microsoft Entra ID nel formato Bearer *<token>*. |
| Accettare | string | Facoltativa. Specifica il tipo di contenuto. Il valore consentito è "application/json" |
Parametri della richiesta
Non fornire parametri di richiesta per questo metodo.
Testo della richiesta
Non includere il contenuto della richiesta per questo metodo.
Esempi di richiesta
Nell'esempio seguente viene illustrato come recuperare informazioni su tutti i prodotti registrati nell'account.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/ HTTP/1.1
Authorization: Bearer <your access token>
Risposta
L'esempio seguente illustra il corpo della risposta JSON restituito da una richiesta riuscita per tutte le etichette di spedizione di un invio specifico di un prodotto registrato nell'account sviluppatore. Per brevità, questo esempio mostra solo i dati per le prime tre etichette di spedizione restituite dalla richiesta. I dettagli sui valori nel corpo della risposta vengono visualizzati nella tabella che segue l'esempio.
{
"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"
}
]
}
Questa risorsa ha i valori seguenti
| Valore | Tipo | Descrizione |
|---|---|---|
| Valore | array | Matrice di oggetti che contengono informazioni su ogni etichetta di spedizione. Per altre informazioni sui dati in ogni oggetto, vedere Risorsa etichetta di spedizione. |
| collegamenti | array | Matrice di oggetti con collegamenti utili sull'entità contenitore. Per altri dettagli, vedere Link object (Oggetto Link ). |
Codici di errore
Per informazioni sui codici di errore, vedi Codici di errore.