Twórz i zarządzaj zgłoszeniami

Użyj interfejsu API przesyłania ze sklepu Microsoft Store, aby programowo wykonywać zapytania i tworzyć przesłania dla aplikacji, dodatków i pakietów dla konta Centrum Partnerów twojej organizacji lub organizacji, której jesteś częścią. Ten interfejs API jest przydatny, jeśli twoje konto zarządza wieloma aplikacjami lub dodatkami i chcesz zautomatyzować i zoptymalizować proces przesyłania dla tych zasobów. Ten interfejs API używa usługi Azure Active Directory (Azure AD) do uwierzytelniania wywołań z aplikacji lub usługi.

W poniższych krokach opisano proces od początku do końca korzystania z interfejsu API do przesyłania w Microsoft Store.

1. Upewnij się, że spełniłeś wszystkie wymagania wstępne .
2. Przed wywołaniem metody w interfejsie API przesyłania sklepu Microsoft Store uzyskaj token dostępu Azure AD. Po uzyskaniu tokenu masz 60 minut na użycie tego tokenu w wywołaniach interfejsu API przesyłania do Microsoft Store, zanim token wygaśnie. Po wygaśnięciu tokenu możesz wygenerować nowy token.
3. Wywołaj API przesyłania w Microsoft Store.

Krok 1. Pełne wymagania wstępne dotyczące korzystania z interfejsu API przesyłania do sklepu Microsoft Store

Przed rozpoczęciem pisania kodu, aby wywołać interfejs API przesyłania aplikacji do Microsoft Store, upewnij się, że spełniłeś następujące wymagania wstępne.

• Użytkownik (lub twoja organizacja) musi mieć katalog usługi Azure AD i musisz mieć uprawnienia administratora globalnego dla katalogu. Jeśli korzystasz już z platformy Microsoft 365 lub innych usług biznesowych, masz już katalog usługi Azure AD. W przeciwnym razie możesz utworzyć nową usługę Azure AD w Centrum partnerskim bez dodatkowych opłat.

• Musisz powiązać aplikację dla Azure AD z kontem Centrum partnerskiego i zdobyć identyfikator dzierżawy, identyfikator klienta oraz klucz. Te wartości są niezbędne do uzyskania tokenu dostępu Azure AD, który zostanie użyty w wywołaniach do interfejsu API Microsoft Store Submission.

• Przygotuj aplikację do użycia z interfejsem API przesyłania ze sklepu Microsoft Store:

  • Jeśli aplikacja nie istnieje jeszcze w Centrum partnerskim, musisz utworzyć aplikację, rezerwując jej nazwę w Centrum partnerskim. Nie można użyć interfejsu API przesyłania Microsoft Store do utworzenia aplikacji w Centrum partnerskim; musisz pracować w Centrum partnerskim, aby ją utworzyć, a następnie za pomocą interfejsu API można uzyskać dostęp do aplikacji i programowo tworzyć dla niej przesyłki. Można jednak użyć interfejsu API do programowego tworzenia dodatków i pakietowania lotów przed utworzeniem ich zgłoszeń.

  • Przed utworzeniem przesyłania dla danej aplikacji przy użyciu tego interfejsu API należy najpierw utworzyć jedno przesłanie dla aplikacji w Centrum partnerskim, w tym odpowiedzieć na kwestionariusz oceny wieku . Po wykonaniu tej czynności będzie można programowo utworzyć nowe przesłania dla tej aplikacji przy użyciu interfejsu API. Przed użyciem interfejsu API dla tych typów przesyłania nie trzeba tworzyć przesyłania dodatku ani przesyłania pakietu.

  • Jeśli tworzysz lub aktualizujesz zgłoszenie aplikacji i musisz dołączyć pakiet aplikacji, przygotuj pakiet aplikacji.

  • Jeśli tworzysz lub aktualizujesz zgłoszenie aplikacji i musisz uwzględnić zrzuty ekranu lub obrazy do listingu w Sklepie, przygotuj zrzuty ekranu i obrazy aplikacji.

  • Jeśli tworzysz lub aktualizujesz przesyłanie dodatku i musisz dołączyć ikonę, przygotuj ikonę.

Jak skojarzyć aplikację usługi Azure AD z kontem Centrum partnerskiego

Przed rozpoczęciem korzystania z interfejsu API przesyłania sklepu Microsoft Store należy skojarzyć aplikację usługi Azure AD z kontem Centrum partnerskiego, pobrać identyfikator dzierżawy i identyfikator klienta aplikacji i wygenerować klucz. Aplikacja Azure AD reprezentuje aplikację lub usługę, z której chcesz wywołać API przesyłania do Microsoft Store. Potrzebujesz identyfikatora dzierżawcy, identyfikatora klienta i klucza, aby uzyskać token dostępu Azure AD, który następnie przekazujesz do interfejsu API.

1. W Partner Center skojarz konto Partner Center swojej organizacji z katalogiem Azure AD Twojej organizacji.

2. Następnie, na stronie Użytkownicy w sekcji Ustawienia konta w Centrum partnerskim, dodaj aplikację Azure AD , która reprezentuje aplikację lub usługę, której użyjesz do uzyskania dostępu do przesyłek dla swojego konta w Centrum partnerskim. Upewnij się, że przypiszesz tej aplikacji rolę menedżera . Jeśli aplikacja jeszcze nie istnieje w katalogu usługi Azure AD, możesz utworzyć nową aplikację usługi Azure AD w Centrum partnerskim.

3. Wróć do strony Użytkownicy, kliknij nazwę swojej aplikacji usługi Azure AD, aby przejść do ustawień aplikacji, a następnie skopiuj wartości Identyfikatora dzierżawy oraz Identyfikatora klienta .

4. Kliknij pozycję Dodaj nowy klucz. Na poniższym ekranie skopiuj wartość klucza . Po opuszczeniu tej strony nie będzie można ponownie uzyskać dostępu do tych informacji. Aby uzyskać więcej informacji, zobacz Zarządzanie kluczami dla aplikacji usługi Azure AD.

Krok 2. Uzyskiwanie tokenu dostępu usługi Azure AD

Przed wywołaniem dowolnej metody w interfejsie API przesyłania do Microsoft Store należy najpierw uzyskać token dostępu Azure AD, który przekazywany jest do nagłówka Authorization każdej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu możesz odświeżyć token, aby móc nadal używać go w kolejnych wywołaniach interfejsu API.

Aby uzyskać token dostępu, postępuj zgodnie z instrukcjami w Service to Service Calls Using Client Credentials (Wywołania usługi do usługi przy użyciu poświadczeń klienta) i wyślij żądanie HTTP POST do punktu końcowego https://login.microsoftonline.com/<tenant_id>/oauth2/token. Oto przykładowe żądanie.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

Dla wartości tenant_id w identyfikatorze URI POST oraz parametrów client_id i client_secret podaj identyfikator dzierżawy, identyfikator klienta oraz klucz do aplikacji, które uzyskałeś z Centrum Partnerskiego w poprzedniej sekcji. Dla parametru zasobu należy określić .

Po wygaśnięciu tokenu dostępu możesz pobrać nowy, ponownie wykonując to samo wywołanie HTTP.

Przykłady demonstrujące sposób uzyskiwania tokenu dostępu przy użyciu kodu C#, Java lub Python można znaleźć w przykładach kodu interfejsu API przesyłania do Microsoft Store.