Udostępnij przez

Zatwierdź przesłanie pakietu

Użyj tej metody w interfejsie API przesyłania sklepu Microsoft Store, aby zatwierdzić nowy lub zaktualizowany lot pakietu do Centrum partnerskiego. Akcja zatwierdzenia powiadamia Centrum Partnerskie o przesłaniu danych zgłoszenia (w tym wszelkich powiązanych pakietów). W odpowiedzi Centrum Partnerskie zatwierdza zmiany w danych przesyłania na potrzeby przetwarzania i publikowania. Po pomyślnym zakończeniu operacji zatwierdzania zmiany w przesłaniu są wyświetlane w Partner Center.

Aby uzyskać więcej informacji na temat sposobu, w jaki operacja zatwierdzania wpisuje się w proces tworzenia przesyłania pakietu testowego za pomocą interfejsu API przesyłania Microsoft Store, zobacz Zarządzanie przesyłkami testowymi pakietu.

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 przesłanie paczki lotniczej, a następnie zaktualizuj wprowadzając wszystkie niezbędne zmiany w danych przesłania.

Żą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/{submissionId}/commit

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 aplikacji zawierającej wysyłkę paczki, którą chcesz zatwierdzić. Identyfikator sklepu dla aplikacji jest dostępny w Centrum partnerskim.
flightId (identyfikator lotu) sznurek To jest wymagane. Identyfikator pakietu lotu, który zawiera przesłanie do zatwierdzenia. Ten identyfikator jest dostępny w danych odpowiedzi dla żądań tworzenia lotów pakietów oraz uzyskiwania lotów pakietów 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 zatwierdzenia. 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 zatwierdzić zgłoszenie przelotu pakietu.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit 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. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz następujące sekcje.

{
  "status": "CommitStarted"
}

Ciało odpowiedzi

Wartość Typ Opis
stan sznurek Status zgłoszenia. Może to być jedna z następujących wartości:
  • Żaden
  • Anulowane
  • Oczekujące zatwierdzenie
  • Rozpoczęto zatwierdzanie
  • Nieudana próba zapisania
  • OczekujeNaPublikację
  • Publikowanie
  • Opublikowany
  • Publikowanie nieudane
  • Wstępne przetwarzanie
  • Przetwarzanie wstępne nie powiodło się
  • Certyfikacja
  • Certyfikacja nieudana
  • Uwolnij
  • Uruchomienie nie powiodło się

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 Parametry żądania są nieprawidłowe.
404 Nie można odnaleźć określonego przesłania.
409 Znaleziono określone zgłoszenie, ale nie można go zatwierdzić w bieżącym stanie, lub aplikacja korzysta z funkcji Centrum partnerskiego, która obecnie nie jest obsługiwana przez interfejs API przesyłania ze Sklepu Microsoft.
  • Last updated on