Udostępnij przez


Pobieranie wszystkich etykiet wysyłkowych

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)