Udostępnij przez

Uzyskaj zgłoszenie pakietu lotów

Użyj tej metody w interfejsie API przesyłania Microsoft Store, aby uzyskać dane dotyczące istniejącego zgłoszenia pakietu do testów. Aby uzyskać więcej informacji na temat procesu tworzenia przesyłania pakietu przy użyciu interfejsu API przesyłania pakietu ze sklepu Microsoft Store, zobacz Zarządzanie przesyłaniem pakietów.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

  • Jeśli jeszcze tego nie zrobiłeś(-łaś), zrealizuj wszystkie wymagania wstępne dla API przesyłania do Microsoft Store.
  • Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.
  • Utwórz przesyłanie pakietu dla aplikacji w Centrum partnerskim. Możesz to zrobić w Centrum partnerskim lub przy użyciu metody przesyłania pakietu lotu .

Żą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
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions{submissionId}

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Nazwa Typ Opis
applicationId (identyfikator aplikacji) sznurek To jest wymagane. Id sklepu aplikacji zawierającej zgłoszenie przesyłki pakietu, które chcesz pobrać. Aby uzyskać więcej informacji na temat identyfikatora sklepu, zobacz Wyświetlanie szczegółów tożsamości aplikacji.
flightId (identyfikator lotu) sznurek To jest wymagane. Identyfikator lotu pakietu, który zawiera zgłoszenie, które chcesz pobrać. Ten identyfikator jest dostępny w danych odpowiedzi na żądania utworzenia lotu pakietu i pobrania lotów pakietu dla aplikacji. W przypadku lotu utworzonego w Centrum partnerskim ten identyfikator jest również dostępny w adresie URL strony lotu w Centrum partnerskim.
ID zgłoszenia sznurek To jest wymagane. Identyfikator zgłoszenia do uzyskania. Identyfikator ten jest dostępny w danych odpowiedzi dla żądań przesłania zgłoszenia pakietu lotu . W przypadku przesłania utworzonego w Centrum partnerskim ten identyfikator jest również dostępny w adresie URL strony przesyłania w Centrum partnerskim.

Ciało żądania

Nie należy podawać treści żądania dla tej metody.

Przykład zapytania

W poniższym przykładzie pokazano, jak uzyskać zgłoszenie lotu pakietu dla aplikacji o identyfikatorze Sklepu 9WZDNCRD91MD.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>

Odpowiedź

W poniższym przykładzie pokazano treść odpowiedzi JSON dla pomyślnego wywołania tej metody. Treść odpowiedzi zawiera informacje o określonym zgłoszeniu. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz Package flight submission resource (Zasób przesyłania pakietów).

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Kody błędów

Jeśli nie można pomyślnie ukończyć żądania, odpowiedź będzie zawierać jeden z następujących kodów błędów HTTP.

Kod błędu Opis
404 Nie można odnaleźć zgłoszenia dotyczącego pakietu lotu.
409 Przesyłanie lotu pakietu nie należy do określonego lotu pakietu, lub aplikacja korzysta z funkcji Centrum partnerskiego, która nie jest obecnie obsługiwana przez interfejs API przesyłania Microsoft Store.
  • Last updated on