Einreichungen erstellen und verwalten

Verwenden Sie die Microsoft Store-Übermittlungs-API, um programmgesteuert Übermittlungen für Apps, Add-Ons und Paketflüge für Ihr oder das Partner Center-Konto Ihrer Organisation abzufragen und zu erstellen. Diese API ist nützlich, wenn Ihr Konto viele Apps oder Add-Ons verwaltet und Sie den Übermittlungsprozess für diese Ressourcen automatisieren und optimieren möchten. Diese API verwendet Azure Active Directory (Azure AD), um die Aufrufe von Ihrer App oder Ihrem Dienst zu authentifizieren.

Die folgenden Schritte beschreiben den Gesamtprozess der Verwendung der Einreichungs-API des Microsoft Store:

1. Vergewissern Sie sich, dass Sie alle Voraussetzungenabgeschlossen haben.
2. Bevor Sie eine Methode in der Microsoft Store-Übermittlungs-API aufrufen, ein Azure AD-Zugriffstokenabrufen. Nachdem Sie ein Token abgerufen haben, haben Sie 60 Minuten Zeit, dieses Token in Aufrufen der Microsoft Store-Übermittlungs-API zu verwenden, bevor das Token abläuft. Nach Ablauf des Tokens können Sie ein neues Token generieren.
3. Aufrufen der Microsoft Store-Übermittlungs-API.

Schritt 1: Erfüllen der Voraussetzungen für die Verwendung der Microsoft Store-Übermittlungs-API

Bevor Sie mit dem Schreiben von Code zum Aufrufen der Microsoft Store-Übermittlungs-API beginnen, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben.

• Sie (oder Ihre Organisation) müssen über ein Azure AD-Verzeichnis verfügen und die globale Administratorberechtigung für das Verzeichnis besitzen. Wenn Sie Bereits Microsoft 365 oder andere Geschäftsdienste von Microsoft verwenden, verfügen Sie bereits über das Azure AD-Verzeichnis. Andernfalls können Sie einen neuen Azure AD im Partner Center ohne zusätzliche Gebühr erstellen.

• Sie müssen eine Azure AD-Anwendung mit Ihrem Partner Center-Konto verknüpfen und Ihre Mandanten-ID, Client-ID und Ihren geheimen Schlüssel erhalten. Sie benötigen diese Werte, um ein Azure AD-Zugriffstoken zu erhalten, das Sie bei Aufrufen der Microsoft Store-Übermittlungs-API verwenden.

• Bereiten Sie Ihre App für die Verwendung mit der Microsoft Store-Übermittlungs-API vor:

  • Wenn Ihre App noch nicht im Partner Center vorhanden ist, müssen Sie Ihre App erstellen, indem Sie den Namen im Partner Centerreservieren. Sie können die Microsoft Store-Übermittlungs-API nicht zum Erstellen einer App im Partner Center verwenden. Sie müssen im Partner Center arbeiten, um es zu erstellen, und danach können Sie die API verwenden, um auf die App zuzugreifen und programmgesteuert Übermittlungen dafür zu erstellen. Sie können jedoch die API verwenden, um Add-Ons und Flugpakete programmgesteuert zu erstellen, bevor Sie Einreichungen dafür vornehmen.

  • Bevor Sie eine Übermittlung für eine bestimmte App mit dieser API erstellen können, müssen Sie zuerst eine Übermittlung für die App im Partner Centererstellen, einschließlich der Beantwortung der Altersfreigaben Fragebogens. Anschließend können Sie mithilfe der API programmgesteuert neue Übermittlungen für diese App erstellen. Sie müssen keine Add-On-Einreichung oder Flugpaket-Einreichung erstellen, bevor Sie die API für diese Arten von Einreichungen verwenden.

  • Wenn Sie eine App-Übermittlung erstellen oder aktualisieren und ein App-Paket einschließen müssen, bereiten Sie das App-Paketvor.

  • Wenn Sie eine App-Einreichung erstellen oder aktualisieren und Screenshots oder Bilder im Store-Eintrag hinzufügen müssen, bereiten Sie die App-Screenshots und -Bildervor.

  • Wenn Sie eine Add-on-Einreichung erstellen oder aktualisieren müssen und ein Symbol einschließen, bereiten Sie das Symbolvor.

Zuordnen einer Azure AD-Anwendung zu Ihrem Partner Center-Konto

Bevor Sie die Microsoft Store-Übermittlungs-API verwenden können, müssen Sie Ihrem Partner Center-Konto eine Azure AD-Anwendung zuordnen, die Mandanten-ID und die Client-ID für die Anwendung abrufen und einen Schlüssel generieren. Die Azure AD-Anwendung stellt die App oder den Dienst dar, aus der Sie die Microsoft Store-Übermittlungs-API aufrufen möchten. Sie benötigen die Mandanten-ID, die Client-ID und den Schlüssel, um ein Azure AD-Zugriffstoken abzurufen, das Sie an die API übergeben.

1. im Partner Center das Partner Center-Konto Ihrer Organisation dem Azure AD-Verzeichnis Ihrer Organisationzuordnen.

2. Fügen Sie als Nächstes auf der Seite Benutzer Seite im Abschnitt Kontoeinstellungen Partner Center die Azure AD-Anwendung hinzu, die die App oder den Dienst darstellt , die Sie für den Zugriff auf Übermittlungen für Ihr Partner Center-Konto verwenden. Stellen Sie sicher, dass Sie dieser Anwendung die Rolle Manager zuweisen. Wenn die Anwendung noch nicht in Ihrem Azure AD-Verzeichnis vorhanden ist, können Sie eine neue Azure AD-Anwendung im Partner Centererstellen.

3. Kehren Sie zur Seite Benutzer zurück, klicken Sie auf den Namen Ihrer Azure AD-Anwendung, um zu den Anwendungseinstellungen zu wechseln, und kopieren Sie die werte Mandanten-ID und Client-ID.

4. Klicken Sie auf Neuen Schlüssel hinzufügen. Notieren Sie sich auf dem folgenden Bildschirm den Wert Key. Nachdem Sie diese Seite verlassen haben, können Sie nicht mehr auf diese Informationen zugreifen. Weitere Informationen finden Sie unter Verwalten von Schlüsseln für eine Azure AD-Anwendung.

Schritt 2: Abrufen eines Azure AD-Zugriffstokens

Bevor Sie eine der Methoden in der Microsoft Store-Übermittlungs-API aufrufen, müssen Sie zuerst ein Azure AD-Zugriffstoken abrufen, das Sie an den header der Authorization jeder Methode in der API übergeben. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie das Token aktualisieren, damit Sie es weiterhin in weiteren Aufrufen der API verwenden können.

Um das Zugriffstoken abzurufen, befolgen Sie die Anweisungen in Dienstanrufe mithilfe von Clientanmeldeinformationen, um einen HTTP POST an den https://login.microsoftonline.com/<tenant_id>/oauth2/token Endpunkt zu senden. Hier ist eine Beispielanforderung.

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

Geben Sie für den tenant_id Wert im POST-URI und den Parametern client_id und client_secret die Mandanten-ID, die Client-ID und den Schlüssel für Ihre Anwendung an, die Sie im vorherigen Abschnitt aus Partner Center abgerufen haben. Für den parameter Ressource müssen Sie https://manage.devcenter.microsoft.comangeben.

Nachdem Ihr Zugriffstoken abgelaufen ist, können Sie ein neues abrufen, indem Sie denselben HTTP-Aufruf erneut ausführen.

Beispiele, wie man ein Zugriffstoken mithilfe von C#, Java oder Python-Code erhält, finden Sie in den Codebeispielen der Microsoft Store-Einreichungs-API .