Udostępnij przez

Utwórz lot pakietowy

Użyj tej metody w interfejsie API przesyłania Microsoft Store, aby utworzyć lot pakietu dla aplikacji zarejestrowanej na koncie Centrum Partnerów.

Uwaga / Notatka

Ta metoda tworzy pakiet kontrolny bez żadnych zgłoszeń. Aby utworzyć zgłoszenie dotyczące tras lotniczych dla paczek, zobacz metody w Zarządzanie zgłoszeniami tras lotniczych paczek.

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.

Żą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

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 sklepu aplikacji, dla której chcesz utworzyć pakiet testowy. Aby uzyskać więcej informacji na temat identyfikatora sklepu, zobacz Wyświetlanie szczegółów tożsamości aplikacji.

Ciało żądania

Treść żądania ma następujące parametry.

Parametr Typ Opis Wymagane
przyjaznaNazwa sznurek Nazwa pakietu lotu określona przez dewelopera. Nie.
groupIds (identyfikatory grup) układ Tablica ciągów zawierających identyfikatory grup lotów skojarzonych z lotem pakietowym. Aby uzyskać więcej informacji na temat grup lotów, zobacz Pakiety lotów. Nie.
rangaWyższaNiż sznurek Przyjazna nazwa lotu pakietowego, który jest sklasyfikowany bezpośrednio niżej niż aktualny lot pakietowy. Jeśli ten parametr nie zostanie ustawiony, nowy lot pakietu będzie miał najwyższą rangę spośród wszystkich lotów pakietu. Aby uzyskać więcej informacji na temat klasyfikacji grup lotów, zobacz Pakiety lotów. Nie.

Przykład zapytania

W poniższym przykładzie pokazano, jak utworzyć nową wersję pakietu dla aplikacji o ID Sklepu 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

Odpowiedź

W poniższym przykładzie pokazano treść odpowiedzi JSON dla pomyślnego wywołania tej metody. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz następujące sekcje.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Ciało odpowiedzi

Wartość Typ Opis
flightId (identyfikator lotu) sznurek Identyfikator lotu pakietu. Ta wartość jest dostarczana przez Centrum partnerskie.
przyjaznaNazwa sznurek Nazwa pakietu lotu, jak określono w żądaniu.
groupIds (identyfikatory grup) układ Tablica ciągów, które zawierają identyfikatory grup lotów skojarzonych z pakietem lotów, jak podano w żądaniu. Aby uzyskać więcej informacji na temat grup lotów, zobacz Pakiety lotów.
rangaWyższaNiż sznurek Przyjazna nazwa pakietu lotu, który jest sklasyfikowany od razu poniżej aktualnego pakietu lotu, jak określono w żądaniu. Aby uzyskać więcej informacji na temat klasyfikacji grup lotów, zobacz Pakiety lotów.

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 Żądanie jest nieprawidłowe.
409 Nie można utworzyć pakietu z powodu jego bieżącego stanu lub aplikacja korzysta z funkcji Centrum partnerskiego, która jest obecnie nieobsługiwana przez interfejs API przesyłania Microsoft Store.
  • Last updated on