Udostępnij przez

Stwórz zgłoszenie pakietu lotu

Użyj tej metody w interfejsie API przesyłania w Microsoft Store, aby utworzyć nowe zgłoszenie pakietu etapowego dla aplikacji. Po pomyślnym utworzeniu nowego przesłania przy użyciu tej metody zaktualizuj przesłanie , aby wprowadzić wszelkie niezbędne zmiany w danych przesyłania, a następnie zatwierdzić przesłanie na potrzeby pozyskiwania i publikowania.

Aby uzyskać więcej informacji o tym, jak ta metoda pasuje do procesu tworzenia przesyłania pakietu przy użyciu interfejsu API przesyłania pakietu ze sklepu Microsoft Store, zobacz Zarządzanie przesyłaniem pakietów.

Uwaga / Notatka

Ta metoda tworzy zgłoszenie dla istniejącego pakietu lotu. Aby utworzyć pakiet lotu, użyj metody tworzenia pakietu lotu.

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 pakiet testowy dla aplikacji. Możesz to zrobić w Centrum partnerskim lub używając metody tworzenia lotu pakietu.

Żą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
Bez znajomości kontekstu, w którym "POST" jest używany, nie mogę zaproponować dokładnego tłumaczenia. Jeżeli dotyczy HTTP, pozostaw jako "POST". https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions

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. Identyfikator Store ID aplikacji, dla której chcesz utworzyć zgłoszenie pakietu do lotu. Aby uzyskać więcej informacji na temat identyfikatora sklepu, zobacz Wyświetlanie szczegółów tożsamości aplikacji.
flightId sznurek To jest wymagane. Identyfikator pakietu, dla którego chcesz dodać zgłoszenie. Ten identyfikator jest dostępny w danych odpowiedzi dla żądań tworzenia lotu pakietu i pobierania lotów pakietu dla aplikacji.

Ciało żądania

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

Przykład zapytania

W poniższym przykładzie pokazano, jak utworzyć nowe zgłoszenie lotu pakietu dla aplikacji, która ma identyfikator Sklepu 9WZDNCRD91MD.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions 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 nowym 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
400 Nie można utworzyć zgłoszenia pakietu lotu, ponieważ żądanie jest nieprawidłowe.
409 Nie można utworzyć przesłania pakietu z powodu bieżącego stanu aplikacji lub aplikacja korzysta z funkcji Centrum partnerskiego, która nie jest obecnie obsługiwana przez interfejs API przesyłania ze Sklepu Microsoft.
  • Last updated on