Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Użyj tej metody w interfejsie API sprzętu firmy Microsoft , aby pobrać dane dla wszystkich etykiet wysyłkowych określonego przesłania produktu.
Wymagania wstępne
Jeśli jeszcze tego nie zrobiono, przed podjęciem próby użycia dowolnej z tych metod wykonaj wszystkie wymagania wstępne dla interfejsów API sprzętu firmy Microsoft. Aby można było użyć tych metod, produkt i zgłoszenie muszą już istnieć na koncie Centrum Dev. Aby utworzyć zgłoszenia produktów lub zarządzać nimi, zapoznaj się z metodami w sekcji Zarządzanie zgłoszeniami produktów.
Żądanie
Ta metoda ma następującą składnię. Zapoznaj się z poniższymi sekcjami, aby zapoznać się z przykładami użycia i opisami nagłówka i treści żądania.
| Metoda | Żądanie URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productId}/submissions/{submissionId}/shippingLabels/ |
Nagłówek żądania
| Nagłówek | Typ | Opis |
|---|---|---|
| Autoryzacja | sznurek | To jest wymagane. Token dostępu Microsoft Entra ID w postaci Bearer *<token>*. |
| akceptować | sznurek | Opcjonalny. Określa typ zawartości. Dozwolona wartość to "application/json" |
Parametry żądania
Nie należy podawać parametrów żądania dla tej metody.
Ciało żądania
Nie należy podawać treści żądania dla tej metody.
Prośba o przykłady
W poniższym przykładzie pokazano, jak pobrać informacje o wszystkich produktach zarejestrowanych na Twoim koncie.
GET https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/14461751976964157/submissions/1152921504621467613/shippingLabels/ HTTP/1.1
Authorization: Bearer <your access token>
Odpowiedź
W poniższym przykładzie przedstawiono treść odpowiedzi JSON zwróconą przez pomyślne żądanie dotyczące wszystkich etykiet wysyłkowych związanych z określonym przesłaniem produktu zarejestrowanego na koncie dewelopera. Dla zwięzłości w tym przykładzie pokazano tylko dane dla pierwszych trzech etykiet dostarczonych w odpowiedzi na żądanie. Szczegółowe informacje o wartościach w treści odpowiedzi są wyświetlane w tabeli poniżej przykładu.
{
"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"
}
]
}
Ten zasób ma następujące wartości
| Wartość | Typ | Opis |
|---|---|---|
| wartość | układ | Tablica obiektów zawierających informacje o każdej etykiecie wysyłkowej. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz Zasób etykiety wysyłkowej. |
| Odsyłacze | układ | Tablica obiektów z przydatnymi linkami dotyczącymi jednostki zawierającej. Aby uzyskać więcej szczegółów, zobacz Link object (Obiekt linku ). |
Kody błędów
Aby uzyskać informacje o kodach błędów, zobacz Kody błędów.
Zobacz też
- Przykłady API tablicy rozdzielczej sprzętu (GitHub)