Freigeben über

Erstellen und Verwalten von Übermittlungen

  • Artikel

Verwenden Sie die Microsoft Store-Übermittlungs-API , um Übermittlungen für Apps, Add-Ons und Flight-Pakete für Das Partner Center-Konto Ihrer Organisation programmgesteuert 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) zum Autorisieren der Aufrufe von Ihrer App oder Ihrem Dienst.

Die folgenden Schritte beschreiben den End-to-End-Prozess der Verwendung der Microsoft Store-Übermittlungs-API:

  1. Stellen Sie sicher, dass Sie alle Voraussetzungen erfüllt haben.
  2. Rufen Sie vor dem Aufrufen einer Methode in der Microsoft Store-Übermittlungs-API 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 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, stellen Sie sicher, dass Sie weitere Änderungen an der Übermittlung nur mithilfe der API vornehmen, anstatt in Partner Center. 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 übernehmen. In einigen Fällen kann die Übermittlung in einem Fehlerzustand verbleiben, in dem sie nicht im Übermittlungsprozess 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 für Unternehmen zu veröffentlichen. Für beide Szenarien müssen Sie die Übermittlung im Partner Center veröffentlichen.

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, die eines dieser Features verwendet, gibt die API einen Fehlercode von 409 zurück. In diesem Fall müssen Sie das 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 ohne zusätzliche Kosten eine neue Azure AD-Instanz in Partner Center 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 im Partner Center vorhanden ist, müssen Sie im Partner Center Ihre App durch Reservieren eines Namens erstellen. Sie können die Microsoft Store-Übermittlungs-API nicht zum Erstellen einer App im Partner Center verwenden. Sie müssen für die Erstellung im Partner Center arbeiten und können danach über die API auf die App zugreifen und programmgesteuert Übermittlungen dafür erstellen. Sie können jedoch die API verwenden, um Add-Ons und Flight-Pakete programmgesteuert zu erstellen, bevor Sie Übermittlungen für diese erstellen.

    • 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 Center erstellen, einschließlich der Beantwortung des Fragebogens für Altersfreigaben . Anschließend können Sie über die API programmgesteuert neue Übermittlungen für diese App erstellen. Sie müssen keine Add-On-Übermittlung oder Flight-Paketübermittlung erstellen, bevor Sie die API für diese Arten von Übermittlungen verwenden.

    • Wenn Sie eine App-Übermittlung erstellen oder aktualisieren und ein App-Paket einschließen 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 aufnehmen müssen, müssen Sie die Screenshots und Bilder für die App vorbereiten.

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

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, von der bzw. dem 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 Ihrer Organisation 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 zuerst 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. Nach dem Ablauf können Sie das Token aktualisieren, damit Sie es in weiteren Aufrufen der API weiterhin verwenden können.

Um das Zugriffstoken zu erhalten, folgen Sie den Anweisungen in Aufrufe von Dienst zu Dienst mit Anmeldeinformationen des Clients, 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

Für den Wert Mandant_id im POST-URI und die Parameter Client_id und Client_secret geben Sie die ID des Mandanten, die ID des Clients und den Schlüssel für Ihre Anwendung an, den Sie im vorherigen Abschnitt vom Partner Center erhalten haben. Für den Parameter resource müssen Sie https://manage.devcenter.microsoft.com angeben.

Nachdem Ihr Zugriffstoken abgelaufen ist, 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 sind. 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 den einzelnen Szenarien und der Syntax der einzelnen Methoden finden Sie in den Artikeln der folgenden Tabelle.

Hinweis

Nachdem Sie ein Zugriffstoken abgerufen haben, haben Sie 60 Minuten Zeit, um 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 für Ihr 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 sie, und rufen Sie dann Übermittlungen für die Add-Ons ab, erstellen oder löschen Sie sie. 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 sie, und rufen Sie dann Übermittlungen für das Flight-Paket ab, erstellen oder löschen Sie sie. Weitere Informationen zu diesen Methoden finden Sie in den folgenden Artikeln:

Codebeispiele

Die folgenden Artikel enthalten detaillierte Codebeispiele, die veranschaulichen, wie sie die Microsoft Store-Übermittlungs-API in verschiedenen Programmiersprachen verwenden:

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 die API implementiert. Dieses Modul wird als StoreBroker bezeichnet. 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 den Aufruf dieser API anzuzeigen. Das StoreBroker-Modul wird in Microsoft aktiv als primäre Art und Weise verwendet, wie viele Erstanbieteranwendungen an den Store übermittelt werden.

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

Problembehandlung

Problem Lösung
Nachdem Sie die Microsoft Store-Übermittlungs-API aus PowerShell aufgerufen haben, sind die Antwortdaten für die API beschädigt, wenn Sie sie aus dem JSON-Format mithilfe des Cmdlets ConvertFrom-Json in ein PowerShell-Objekt konvertieren und dann mithilfe des Cmdlets ConvertTo-Json wieder in das JSON-Format zurück. Standardmäßig wird 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. Wenn Sie das Cmdlet ConvertTo-Json aufrufen, legen Sie den Parameter "-Depth " auf eine größere Zahl fest, z. B. 20.

Weitere Hilfe

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

  • Stellen Sie 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 die App-Übermittlung und -Zertifizierung bzw . die Übermittlung einer App aus.