Freigeben über


Übersicht über die Übermittlungs-API für private Angebote

Private Angebote ermöglichen es Herausgebern und Kunden, Transaktionen für ein einzelnes Produkt oder für mehrere Produkte im Azure Marketplace mit zeitgebundenen Preisen und angepassten Bedingungen zu tätigen. Die APIs für private Angebote ermöglichen Es Herausgebern, private Angebote für Kunden und/oder CSP-Partner programmgesteuert zu erstellen und zu verwalten. Diese API verwendet Die Microsoft Entra-ID, um die Aufrufe von Ihrer App oder Ihrem Dienst zu authentifizieren.

Im Partner Center stehen drei Haupttypen privater Angebote zur Verfügung und werden von der API für die Übermittlung privater Angebote unterstützt:

  • ISV zum privaten Kundenangebot – auch als privates Kundenangebot im Partner Center bezeichnet. Dies ist ein benutzerdefinierter Deal zwischen einem ISV und einem bestimmten Kunden mit angepassten Bedingungen und Preisen für ein bestimmtes Produkt in Azure Marketplace. Erfahren Sie mehr über ISV zum Kunden-Privatangebot.
  • ISV zu CSP-Partner privates Angebot – auch als privates CSP-Partnerangebot im Partner Center bezeichnet. Diese Art von privatem Angebot ermöglicht es ISV, zeitgebundene Marge anzugeben, um einen Großhandelspreis für ihren CSP-Partner zu erstellen. Erfahren Sie mehr über ISV zu CSP-Partner-Private-Angebot.
  • Privates Angebot mit mehreren Teilnehmern (MPO) – Ein von einem ISV gemeinsam konfigurierter benutzerdefinierter Deal und ein bevorzugter Kanalpartner eines bestimmten Kunden mit angepassten Bedingungen und Preisen für bestimmte Produkte in Azure Marketplace. Der ISV definiert den ermäßigten Großhandelspreis, der dem Partner zur Verfügung gestellt wird, der Kanalpartner kann dann Markup über den Großhandelspreis hinzufügen, um zum Endkundenpreis zu gelangen und dem Kunden das Angebot zur Annahme und zum Kauf zu präsentieren. Die Annahme und der Kauf des MPO folgt demselben Fluss wie ISV zu Kunden-Privatangeboten. Erfahren Sie mehr über das private Angebot mit mehreren Teilnehmern.

Terminologie

  • MPO-Absender – MPO ist eine Zusammenarbeit zwischen ISV und Kanalpartner auf demselben benutzerdefinierten Deal für einen bestimmten Kunden, die zuerst das MPO erstellt, wird als "Absender " des Angebots bezeichnet, in der Regel der ISV der Produkte, die im MPO enthalten sind. Es kann nur ein Absender für ein bestimmtes MPO vorhanden sein.
  • MPO-Verkäufer – Der Kanalpartner, der das Angebot mit dem Endkundenpreis vorbereitet und dem Kunden das Angebot präsentiert, ist der Verkäufer des MPO. Es kann nur ein Verkäufer für ein bestimmtes MPO vorhanden sein.
  • Produkt: Eine einzelne Einheit, die ein Angebot in Azure Marketplace darstellt. Pro Auflistungsseite gibt es ein Produkt.
  • Plan: Eine einzelne Version eines bestimmten Produkts. Es kann mehrere Pläne für ein bestimmtes Produkt geben, die verschiedene Preise oder Bedingungen darstellen.
  • Auftrag: Eine Aufgabe, die beim Senden einer Anforderung in dieser API erstellt wird. Wenn Sie diese API zum Verwalten privater Angebote und privater Angebote mit mehreren Teilnehmern verwenden, wird ein Auftrag erstellt, um die Anforderung abzuschließen. Sobald der Auftrag abgeschlossen ist, erhalten Sie weitere Informationen über das relevante private Angebot (Mehrparteien).

Unterstützte Szenarios

Vorbereiten der Verwendung dieser API

Bevor Sie Code zum Aufrufen der API für private Angebote schreiben, müssen Sie sicherstellen, dass die folgenden Voraussetzungen erfüllt sind. Die gleichen Voraussetzungen gelten für alle Veröffentlichungspartner.

Schritt 1: Erfüllen der Voraussetzungen für die Verwendung der Microsoft Product Ingestion-API (einmalig)

Sie oder Ihre Organisation müssen über eine Microsoft Entra-Verzeichnis- und globale Administratorberechtigung verfügen. Wenn Sie Microsoft 365 oder andere Geschäftsdienste bereits von Microsoft verwenden, verfügen Sie bereits über das Microsoft Entra-Verzeichnis. Wenn nicht, können Sie eine neue Microsoft Entra-ID im Partner Center kostenlos erstellen.

Sie müssen ihrer Partner Center-Konto eine Microsoft Entra-ID-Anwendung zuordnen und Ihre Mandanten-ID, Client-ID und Ihren Schlüssel abrufen. Sie benötigen diese Werte, um das Microsoft Entra-Zugriffstoken abzurufen, das Sie in Aufrufen der privaten Angebots-API verwenden.

Schritt 2: Abrufen eines Microsoft Entra-Zugriffstokens (jedes Mal)

Bevor Sie eine der Methoden in der Microsoft Store-Übermittlungs-API aufrufen, benötigen Sie ein Microsoft Entra-Zugriffstoken, um den Autorisierungsheader jeder Methode in der API zu übergeben. Sie haben 60 Minuten Zeit, ein Token zu verwenden, bevor es abläuft. Nach Ablauf eines Tokens können Sie es aktualisieren, damit es in weiteren Aufrufen der API verwendet werden kann.

Folgen Sie zum Abrufen des Zugriffstokens den Anweisungen unter Dienst-zu-Dienst-Aufrufe mit Clientanmeldeinformationen, um eine HTTP POST-Anforderung an den Endpunkt https://login.microsoftonline.com/<tenant_id>/oauth2/token zu senden. Hier sehen Sie 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://graph.microsoft.com/

Geben Sie für den Wert „tenant_id“ im POST-URI sowie für die Parameter „client_id“ und „client_secret“ die Mandanten-ID, die Client-ID und den Schlüssel für die Anwendung an, die Sie im vorherigen Abschnitt aus Partner Center abgerufen haben. Für den Ressourcenparameter müssen Sie angeben https://graph.microsoft.com/.

Ermitteln der IDs von Produkten, Plänen und privaten Angeboten

ID Wo finde ich sie?
client_id Siehe Zuordnen einer Microsoft Entra-Anwendung zu Ihrem Partner Center-Konto.
tenant_id Siehe Zuordnen einer Microsoft Entra-Anwendung zu Ihrem Partner Center-Konto.
client_secret Siehe Zuordnen einer Microsoft Entra-Anwendung zu Ihrem Partner Center-Konto.
productId Weitere Informationen finden Sie unter Abrufen von Produkten in diesem Artikel.
planId Siehe Abrufen von Plänen für ein bestimmtes Produkt in diesem Artikel.
privateofferId Weitere Informationen finden Sie unter Abrufen privater Angebote in diesem Artikel.

Abrufen von Produkten

Ein privates Angebot basiert auf einem vorhandenen Produkt in Ihrem Partner Center-Konto. Verwenden Sie den folgenden API-Aufruf, um eine Liste der Ihrem Partner Center-Konto zugeordneten Produkte anzuzeigen:

GET https://graph.microsoft.com/rp/product-ingestion/product?$version=2022-07-01

Die Antwort wird im folgenden Beispielformat angezeigt:

{
  "value": [
    {
      "$schema": "https://schema.mp.microsoft.com/schema/product/2022-07-01",
      "id": "string",
      "identity": {
        "externalId": "string"
      },
      "type": "enum",
      "alias": "string"
    }
  ],
  "@nextLink": "opaque_uri"
}

Abrufen von Plänen für ein bestimmtes Produkt

Für Produkte, die mehr als einen Plan enthalten, können Sie ein privates Angebot basierend auf einem bestimmten Plan erstellen. Wenn ja, benötigen Sie die ID dieses Plans. Rufen Sie mithilfe des folgenden API-Aufrufs eine Liste der Pläne (z. B. Varianten oder SKUs) für das Produkt ab:

GET https://graph.microsoft.com/rp/product-ingestion/plan?product=<product-id>&$version=2022-07-01

Die Antwort wird im folgenden Beispielformat angezeigt:

{
  "value": [
    {
      "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-07-01",
      "product": "string",
      "id": "string",
      "identity": {
        "externalId": "string"
      },
      "alias": "string"
    }
  ]
}

Abrufen von privaten Angeboten

Um eine Liste aller privaten Angebote anzuzeigen, einschließlich privater Angebote mit mehreren Teilnehmern, die Ihrem Konto zugeordnet sind, verwenden Sie den folgenden API-Aufruf:

GET https://graph.microsoft.com/rp/product-ingestion/private-offer/query?$version=2023-07-15

Verwenden der API

Mit der api für private Angebote können Sie private Angebote erstellen und verwalten, die mit Produkten und Plänen in Ihrem Partner Center-Konto verknüpft sind. Nachfolgend finden Sie eine Zusammenfassung des typischen Aufrufmusters beim Verwenden dieser API.

Flussdiagramm mit schritten für private Angebote mit mehreren Teilnehmern.

Schritt 1: Anforderung stellen

Wenn Sie einen API-Aufruf zum Erstellen, Löschen, Zurückziehen oder Upgraden eines privaten Angebots senden, wird ein neuer Auftrag erstellt, um die angeforderte Aufgabe abzuschließen. Die API-Antwort enthält eine jobId, die dem Auftrag zugeordnet ist.

Schritt 2: Abrufen des Auftragsstatus

Rufen Sie mithilfe der jobId aus der anfänglichen API-Antwort ab, um den Auftragsstatus abzurufen. Der Status des Auftrags wird entweder ausgeführt oder abgeschlossen. Nachdem der Auftrag abgeschlossen wurde, wird das Ergebnis entweder erfolgreich oder fehlgeschlagen. Fragen Sie einen Auftrag nicht öfter als einmal pro Minute ab, um Leistungsprobleme zu vermeiden.

jobStatus Beschreibung
NotStarted Der Auftrag wurde noch nicht gestartet. Dies ist Teil der Antwort auf die erste Anforderung.
Wird ausgeführt Der Auftrag wird noch ausgeführt.
Abgeschlossen Der Auftrag wurde abgeschlossen. Weitere Informationen finden Sie unter jobResult .
jobResult Beschreibung
Ausstehend Der Auftrag wurde noch nicht abgeschlossen.
Erfolgreich Der Auftrag wurde erfolgreich abgeschlossen. Dieser Auftrag gibt auch einen Ressourcen-URI zurück, der auf das private Angebot im Zusammenhang mit dem Auftrag verweist. Verwenden Sie diesen Ressourcen-URI, um die vollständigen Details eines privaten Angebots abzurufen.
Fehler Der Auftrag ist fehlgeschlagen. Dies gibt auch alle relevanten Fehler zurück, um die Ursache des Fehlers zu ermitteln.

Weitere Informationen finden Sie unter Abfragen des Status eines vorhandenen Auftrags.

Schritt 3: Abrufen von Informationen aus abgeschlossenen Aufträgen

Ein erfolgreicher Auftrag gibt einen resourceUri zurück, der auf das entsprechende private Angebot verweist. Verwenden Sie diesen Ressourcen-URI, um in Zukunft weitere Details zum privaten Angebot zu erhalten, wie z. B. die privateofferId.

Ein fehlgeschlagener Auftrag enthält Fehler, die Details dazu liefern, warum der Auftrag fehlgeschlagen ist und wie das Problem behoben werden kann.

Weitere Informationen finden Sie unter Abrufen von Details zu einem vorhandenen privaten Angebot.

Wie ISV und Kanalpartner die API für privates Angebot mit mehreren Teilnehmern gemeinsam nutzen sollten

Sowohl ISV als auch Kanalpartner können die gleichen APIs zum Erstellen und Verwalten eines bestimmten MPO verwenden. Ressourcen in einem MPO, die sich auf die API auswirken können, hängen jedoch davon ab, ob der Aufrufer der API der ISV (Absender) oder der Kanalpartner (Verkäufer) des MPO ist. Der gleiche ISV/Channel Partner Publishing Flow und Geschäftsregeln für Partner Center werden in der API gespiegelt. Hier ist eine Übersicht:

API-Vorgang ISV (Absender) Kanalpartner (Verkäufer)
Erstellen
  • Beabsichtigte Zielgruppe ist der Vertriebspartner (Verkäufer), wenn der API-Aufruf veröffentlicht wird, wird das private Angebot erst angezeigt, wenn der Kanalpartner einreicht.
Bearbeitbare Ressourcen:
  • Wirksamkeitsdatum
  • Beabsichtigter Empfänger (Kunde)
  • Kanalpartner für die Zusammenarbeit am Angebot, beschränkt auf 1 pro privates Angebot
  • Weitere ISV-Kontakte, die über den Status des privaten Angebots benachrichtigt werden sollen
  • Benutzerdefinierte ISV-Geschäftsbedingungen
  • Produkte/Pläne, die im privaten Angebot enthalten sind
  • Vertragsdauer(en) für jedes Produkt/jeden Plan
  • Enthaltene Mengen für jedes Produkt (falls zutreffend)
  • Nicht zu erstellende Planattribute (falls zutreffend)
  • Ermäßigter Großhandelspreis für den Channelpartner auf den inbegriffenen Produkten/Plan
  • ISV-Verkaufsnotizen
  • Beabsichtigte Zielgruppe ist der Endbenutzer, wenn der API-Aufruf gepostet wird.
Bearbeitbare Ressourcen:
  • Benutzerdefinierte Geschäftsbedingungen für Kanalpartner
  • Vorbereitet von
  • Die Kundenanpassung (Markupprozentsatz) über dem ISV-Großhandelspreis für jedes Produkt/jeden Plan, der im privaten Angebot enthalten ist, bestimmt dies den Endkundenpreis.
  • Weitere Kanalpartnerkontakte, die über den Status des privaten Angebots benachrichtigt werden sollen
  • Channel Partner Sales Notes
Löschen
  • Unterstützt für private Angebote im Entwurfszustand
  • Nicht unterstützt
Zurückziehen
  • Unterstützt für private Angebote, die vom ISV veröffentlicht, aber noch nicht vom Kanalpartner veröffentlicht wurden oder vom Kanalpartner zurückgezogen wurden
  • Unterstützt für private Angebote, die für Endbenutzer veröffentlicht und verfügbar sind, aber noch nicht akzeptiert wurden