Udostępnij przez


Zatwierdzić zgłoszenie dodatku

Użyj tej metody w interfejsie API przesyłania Microsoft Store, aby zatwierdzić nowy lub zaktualizowany dodatek (znany również jako produkt w aplikacji (IAP)) przesłany do Centrum partnerskiego. Akcja zatwierdzenia powiadamia Centrum Partnerskie o przesłaniu danych zgłoszenia (w tym wszelkie powiązane ikony). 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 o tym, jak operacja zatwierdzania wpisuje się w proces przesyłania dodatku za pomocą interfejsu API przesyłania w Microsoft Store, zobacz Zarządzanie przesyłaniem dodatkó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łkę dodatku, a następnie zaktualizuj przesyłkę przy użyciu wszelkich niezbędnych zmian w danych przesyłki.

Żą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/inappproducts/{inAppProductId}/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
IdentyfikatorProduktuAplikacji sznurek To jest wymagane. Identyfikator Store dodatku, który zawiera zgłoszenie, które chcesz zatwierdzić. Identyfikator sklepu jest dostępny w Partner Center i jest zawarty w danych odpowiedzi na żądania Pobierz wszystkie dodatki oraz Utwórz dodatek.
ID zgłoszenia sznurek To jest wymagane. Identyfikator zgłoszenia, który chcesz potwierdzić. Ten identyfikator jest dostępny w danych odpowiedzi dla żądań utworzenia zgłoszenia dodatku . 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 dodatku.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/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 jego obecnym stanie lub dodatek używa funkcji Centrum Partnerów, która jest obecnie nieobsługiwaną przez interfejs API przesyłania sklepu Microsoft Store.