Erstellen und Verwalten von Übermittlungen

  • Artikel

Verwenden Sie die Microsoft Store-Übermittlungs-API, um programmgesteuert Übermittlungen für Apps, Add-Ons und Flight-Pakete für Ihr Partner Center-Konto oder das Partner Center-Konto Ihres organization abzufragen und zu erstellen. Diese API ist hilfreich, wenn über Ihr Konto viele Apps oder Add-Ons verwaltet werden 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.

In den folgenden Schritten wird der End-to-End-Prozess der Verwendung der Microsoft Store-Übermittlungs-API beschrieben:

  1. Stellen Sie sicher, dass Sie alle Voraussetzungen erfüllt haben.
  2. Bevor Sie eine Methode in der Microsoft Store-Übermittlungs-API aufrufen, rufen Sie ein Azure AD-Zugriffstoken ab. Nach dem Abruf eines Tokens können Sie es für einen Zeitraum von 60 Minuten in Aufrufen der Microsoft Store-Übermittlungs-API verwenden, bevor es abläuft. Nach dem Ablauf des Tokens können Sie ein neues Token generieren.
  3. Rufen Sie die Microsoft Store-Übermittlungs-API auf.

Wichtig

Wenn Sie diese API verwenden, um eine Übermittlung für eine App, ein Flight-Paket oder ein Add-On zu erstellen, müssen Sie weitere Änderungen an der Übermittlung nur mithilfe der API und nicht im Partner Center vornehmen. Wenn Sie Partner Center verwenden, um eine Übermittlung zu ändern, die Sie ursprünglich mithilfe der API erstellt haben, können Sie diese Übermittlung nicht mehr mithilfe der API ändern oder committen. In einigen Fällen kann die Übermittlung in einem Fehlerzustand verbleiben, in dem sie im Übermittlungsprozess nicht fortgesetzt werden kann. In diesem Fall müssen Sie die Übermittlung löschen und eine neue Übermittlung erstellen.

Wichtig

Sie können diese API nicht verwenden, um Übermittlungen für Volumenkäufe über die Microsoft Store für Unternehmen und Microsoft Store für Bildungseinrichtungen zu veröffentlichen oder Übermittlungen für BRANCHEN-Apps direkt in Unternehmen zu veröffentlichen. Für beide Szenarien müssen Sie die Übermittlung in Partner Center veröffentlichen verwenden.

Hinweis

Diese API kann nicht mit Apps oder Add-Ons verwendet werden, die obligatorische App-Updates und vom Store verwaltete Verbrauchs-Add-Ons verwenden. Wenn Sie die Microsoft Store-Übermittlungs-API mit einer App oder einem Add-On verwenden, das eines dieser Features verwendet, gibt die API den Fehlercode 409 zurück. In diesem Fall müssen Sie Partner Center verwenden, um die Übermittlungen für die App oder das Add-On zu verwalten.

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 Ihnen müssen die Berechtigungen globaler Administrator für das Verzeichnis gewährt worden sein. Wenn Sie Microsoft 365 oder andere Unternehmensdienste von Microsoft verwenden, verfügen Sie bereits über ein Azure AD-Verzeichnis. Andernfalls können Sie im Partner Center eine neue Azure AD-Instanz ohne zusätzliche Kosten erstellen.

  • Sie müssen Ihrem Partner Center-Konto eine Azure AD-Anwendung zuordnen und Ihre Mandanten-ID, die Client-ID und den Schlüssel abrufen. Sie benötigen diese Werte, um ein Azure AD-Zugriffstoken zu erhalten, das Sie in 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 in Partner Center vorhanden ist, müssen Sie Ihre App erstellen, indem Sie ihren Namen in Partner Center reservieren. Sie können die Microsoft Store-Übermittlungs-API nicht verwenden, um eine App im Partner Center zu erstellen. Sie müssen in Partner Center arbeiten, um sie 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 mithilfe der API Add-Ons und Flight-Pakete programmgesteuert erstellen, bevor Sie Übermittlungen für sie erstellen.

    • Bevor Sie mithilfe dieser API eine Übermittlung für eine bestimmte App erstellen können, müssen Sie zunächst eine Übermittlung für die App im Partner Center erstellen, einschließlich der Beantwortung des Fragebogens zur Altersfreigabe . Danach können Sie neue Übermittlungen für diese App mithilfe der API programmgesteuert erstellen. Sie müssen keine Add-On-Übermittlung oder Flight-Paketübermittlung vor der Verwendung der API für diese Arten von Übermittlungen erstellen.

    • Wenn Sie eine App-Übermittlung erstellen oder aktualisieren und ein App-Paket angeben müssen, bereiten Sie das App-Paket vor.

    • Wenn Sie eine App-Übermittlung erstellen oder aktualisieren und Screenshots oder Bilder für den Store-Eintrag angeben müssen, bereiten Sie die App-Screenshots und -Bilder vor.

    • Wenn Sie eine Add-On-Übermittlung erstellen oder aktualisieren und ein Symbol angeben müssen, bereiten Sie das Symbol vor.

Zuordnen einer anderen 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 client-ID für die Anwendung abrufen und einen Schlüssel generieren. Die Azure AD-Anwendung stellt die App oder den Dienst dar, von der aus 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 zu erhalten, das Sie an die API übergeben.

Hinweis

Sie müssen diese Aufgabe nur einmal ausführen. Nachdem Sie über die Mandanten-ID, die Client-ID und den Schlüssel verfügen, können Sie diese jederzeit wiederverwenden, wenn Sie ein neues Azure AD-Zugriffstoken erstellen müssen.

  1. Verknüpfen Sie in Partner Center das Partner Center-Konto Ihres Unternehmens mit dem Azure AD-Verzeichnis Ihrer Organisation.

  2. Fügen Sie als Nächstes auf der Seite Benutzer im Abschnitt Kontoeinstellungen von Partner Center die Azure AD-Anwendung hinzu, die die App oder den Dienst darstellt, mit der bzw. dem Sie auf die Übermittlungen Ihres Partner Center-Kontos zugreifen. 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 in Partner Center eine neue Azure AD-Anwendung erstellen.

  3. Kehren Sie zur Seite Benutzer zurück, klicken Sie auf den Namen Ihrer Azure AD-Anwendung, um die Anwendungseinstellungen zu öffnen, und schreiben Sie die Werte Mandanten-ID und Client-ID auf.

  4. Klicken Sie auf Neuen Schlüssel hinzufügen. Notieren Sie auf dem folgenden Bildschirm den Wert von Schlüssel. 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 zunächst ein Azure AD-Zugriffstoken abrufen, das Sie an den Autorisierungsheader jeder Methode in der API übergeben. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie es aktualisieren, um es in weiteren Aufrufen an die API zu verwenden.

Befolgen Sie zum Abrufen des Zugriffstokens die Anweisungen unter Aufrufe zwischen Diensten mithilfe von Clientanmeldeinformationen, um eine HTTP POST-Anforderung an den https://login.microsoftonline.com/<tenant_id>/oauth2/token-Endpunkt zu senden. Hier ist ein Beispiel für eine Anforderung angegeben.

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 wert tenant_id 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 resource müssen Sie https://manage.devcenter.microsoft.com angeben.

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

Beispiele zum Abrufen eines Zugriffstokens mithilfe von C#-, Java- oder Python-Code finden Sie in den Codebeispielen der Microsoft Store-Übermittlungs-API.

Schritt 3: Verwenden der Microsoft Store-Übermittlungs-API

Nachdem Sie über ein Azure AD-Zugriffstoken verfügen, können Sie Methoden in der Microsoft Store-Übermittlungs-API aufrufen. Die API enthält viele Methoden, die in Szenarien für Apps, Add-Ons und Flight-Pakete gruppiert werden. Zum Erstellen oder Aktualisieren von Übermittlungen rufen Sie in der Regel mehrere Methoden in der Microsoft Store-Übermittlungs-API in einer bestimmten Reihenfolge auf. Informationen zu jedem Szenario und zur Syntax der einzelnen Methoden finden Sie in den Artikeln in der folgenden Tabelle.

Hinweis

Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, Methoden in der Microsoft Store-Übermittlungs-API aufzurufen, bevor das Token abläuft.

Szenario Beschreibung
Apps Rufen Sie Daten für alle Apps ab, die bei Ihrem Partner Center-Konto registriert sind, und erstellen Sie Übermittlungen für Apps. Weitere Informationen zu diesen Methoden finden Sie in den folgenden Artikeln:
Add-Ons Rufen Sie Add-Ons für Ihre Apps ab, erstellen oder löschen Sie diese, und rufen Sie dann Übermittlungen für die Add-Ons ab, erstellen oder löschen Sie diese. Weitere Informationen zu diesen Methoden finden Sie in den folgenden Artikeln:
Flight-Pakete Rufen Sie Flight-Pakete für Ihre Apps ab, erstellen oder löschen Sie diese, und rufen Sie dann Übermittlungen für die Flight-Pakete ab, erstellen oder löschen Sie diese. Weitere Informationen zu diesen Methoden finden Sie in den folgenden Artikeln:

Codebeispiele

Die folgenden Artikel enthalten detaillierte Codebeispiele, die die Verwendung der Microsoft Store-Übermittlungs-API in verschiedenen Programmiersprachen veranschaulichen:

StoreBroker PowerShell-Modul

Als Alternative zum direkten Aufrufen der Microsoft Store-Übermittlungs-API stellen wir auch ein Open-Source-PowerShell-Modul bereit, das eine Befehlszeilenschnittstelle über der API implementiert. Dieses Modul heißt StoreBroker. Sie können dieses Modul verwenden, um Ihre App-, Flight- und Add-On-Übermittlungen über die Befehlszeile zu verwalten, anstatt die Microsoft Store-Übermittlungs-API direkt aufzurufen, oder Sie können einfach die Quelle durchsuchen, um weitere Beispiele für das Aufrufen dieser API anzuzeigen. Das StoreBroker-Modul wird in Microsoft aktiv als primäre Methode verwendet, um viele Erstanbieteranwendungen an den Store zu übermitteln.

Weitere Informationen finden Sie auf unserer StoreBroker-Seite auf GitHub.

Problembehandlung

Problem Lösung
Nach dem Aufrufen der Microsoft Store-Übermittlungs-API aus PowerShell sind die Antwortdaten für die API beschädigt, wenn Sie sie mithilfe des Cmdlets ConvertFrom-Json aus dem JSON-Format in ein PowerShell-Objekt konvertieren und dann mithilfe des Cmdlets ConvertTo-Json in das JSON-Format zurückkehren. Standardmäßig ist der Parameter -Depth für das Cmdlet ConvertTo-Json auf 2 Objektebenen festgelegt, was für die meisten JSON-Objekte, die von der Microsoft Store-Übermittlungs-API zurückgegeben werden, zu flach ist. Legen Sie beim Aufrufen des ConvertTo-Json-Cmdlets den Parameter -Depth auf eine größere Zahl fest, z. B. 20.

Zusätzliche Hilfe

Wenn Sie Fragen zur Microsoft Store-Übermittlungs-API haben oder Hilfe beim Verwalten Ihrer Übermittlungen mit dieser API benötigen, verwenden Sie die folgenden Ressourcen:

  • Stellen Sie Ihre Fragen in unseren Foren.
  • Besuchen Sie unsere Supportseite , und fordern Sie eine der unterstützten Supportoptionen für Partner Center an. Wenn Sie aufgefordert werden, einen Problemtyp und eine Kategorie auszuwählen, wählen Sie App submission and certification bzw. Übermitteln einer App.