Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 die Übermittlung privater 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 Ihrer App oder Ihres Diensts zu authentifizieren.
Es gibt drei Haupttypen von privaten Angeboten, die in Partner Center verfügbar sind und von der API für die Übermittlung privater Angebote unterstützt werden:
- ISV für privates Kundenangebot : Auch als privates Kundenangebot in Partner Center bezeichnet. Hierbei handelt es sich um ein benutzerdefiniertes Angebot zwischen einem ISV und einem bestimmten Kunden mit benutzerdefinierten Bedingungen und Preisen für ein bestimmtes Produkt im Azure Marketplace. Erfahren Sie mehr über das private Angebot von ISV für Kunden.
- Privates Angebot von ISV-zu-CSP-Partnern : Im Partner Center auch als privates Angebot für CSP-Partner bezeichnet. Bei dieser Art von privatem Angebot kann der ISV eine zeitgebundene Marge angeben, um einen Großhandelspreis für seinen CSP-Partner zu erstellen. Erfahren Sie mehr über das private Angebot von ISV-zu-CSP-Partnern.
- Privates Angebot(Multiparty Private Offer, MPO) – Ein benutzerdefiniertes Angebot, das gemeinsam von einem ISV und einem bevorzugten Vertriebspartner eines bestimmten Kunden mit benutzerdefinierten Bedingungen und Preisen für bestimmte Produkte im Azure Marketplace konfiguriert wird. Der ISV definiert den ermäßigten Großhandelspreis, der dem Partner zur Verfügung gestellt wird, der Vertriebspartner kann dann einen Aufschlag auf den Großhandelspreis hinzufügen, um den Endkundenendpreis zu ermitteln, und präsentiert dem Kunden das Angebot zur Annahme und zum Kauf. Die Annahme und der Kauf des MPO erfolgen nach dem gleichen Ablauf wie bei der ISV für private Kundenangebote. Erfahren Sie mehr über das private Angebot mit mehreren Teilnehmern.
Terminologie
- MPO-Originator – MPO ist eine Zusammenarbeit zwischen ISV und Channel-Partner im Rahmen desselben benutzerdefinierten Deals für einen bestimmten Kunden, wobei die Partei, die das MPO zuerst erstellt, als "Originator" des Angebots bezeichnet wird, in der Regel der ISV der Produkte, die im MPO enthalten sind. Es kann nur einen Originator für ein bestimmtes MPO geben.
- MPO-Verkäufer – Der Vertriebspartner, der das Angebot mit dem Endkundenendpreis erstellt und dem Kunden das Angebot präsentiert, ist der Verkäufer des MPO. Es kann nur einen Verkäufer für ein bestimmtes MPO geben.
- Product – Eine einzelne Einheit, die ein Angebot im Azure Marketplace darstellt. Es gibt ein Produkt pro Angebotsseite.
- Plan – Eine einzelne Version eines bestimmten Produkts. Es kann mehrere Pläne für ein bestimmtes Produkt geben, die verschiedene Preisniveaus oder Bedingungen darstellen.
- Job – Eine Aufgabe, die erstellt wird, wenn eine Anforderung in dieser API gestellt wird. Wenn Sie diese API verwenden, um private Angebote und private Angebote mit mehreren Teilnehmern zu verwalten, wird ein Auftrag erstellt, um die Anforderung abzuschließen. Sobald der Auftrag abgeschlossen ist, können Sie weitere Informationen über das entsprechende private Angebot (mit mehreren Teilnehmern) erhalten.
Unterstützte Szenarien
- Erstellen eines privaten Angebots für einen Kunden
- Erstellen eines privaten Angebots für einen Reseller
- Erstellen eines privaten Angebots mit mehreren Teilnehmern für einen Kunden
- Löschen eines privaten Angebots
- Ein privates Angebot zurückziehen
- Abfragen einer Liste von privaten Angeboten mit mehreren Teilnehmern
- Abfrage einer Liste von Produkten und Plänen
Bereiten Sie sich auf die Verwendung dieser API vor
Bevor Sie Code zum Aufrufen der API für private Angebote schreiben, stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben. Für alle Verlagspartner gelten die gleichen Voraussetzungen.
Schritt 1: Erfüllen der Voraussetzungen für die Verwendung der Microsoft-Produkterfassungs-API (einmalig)
Sie oder Ihre Organisation müssen über ein Microsoft Entra Verzeichnis 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 kostenlos eine neue Microsoft Entra ID in Partner Center erstellen.
Sie müssen Ihrem 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 Antera-Zugriffstoken abzurufen, das Sie in Aufrufen der API für private Angebote 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, das an den Autorisierungsheader jeder Methode in der API übergeben wird. Sie haben 60 Minuten Zeit, um ein Token zu verwenden, bevor es abläuft. Nach Ablauf können Sie ein Token aktualisieren, damit Sie es in weiteren Aufrufen der API weiterhin verwenden können.
Informationen zum Abrufen des Zugriffstokens finden Sie unter Dienst-zu-Dienst-Aufrufe mithilfe von Clientanmeldeinformationen zum Senden eines HTTP POST an den https://login.microsoftonline.com/<Endpunkt tenant_id>/oauth2/token . 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://graph.microsoft.com/
Geben Sie für den tenant_id Wert im POST-URI und die Parameter 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 Ressourcenparameter müssen Sie https://graph.microsoft.com/angeben.
Suchen von Produkt-, Plan- und privaten Angebots-IDs
| ID | Wo man sie findet |
|---|---|
| Kunden-ID | Weitere Informationen finden Sie unter Zuordnen einer Microsoft Entra Anwendung zu Ihrem Partner Center-Konto. |
| Mieter_ID | Weitere Informationen finden Sie unter Zuordnen einer Microsoft Entra Anwendung zu Ihrem Partner Center-Konto. |
| client_secret (Kunden-Geheimnis) | Weitere Informationen finden Sie unter Zuordnen einer Microsoft Entra Anwendung zu Ihrem Partner Center-Konto. |
| Produkt-ID | Weitere Informationen finden Sie unter Abrufen von Produkten in diesem Artikel. |
| planId | Weitere Informationen finden Sie unter Abrufen von Plänen für ein bestimmtes Produkt in diesem Artikel. |
| privateofferId | Weitere Informationen finden Sie unter Abrufen privater Angebote in diesem Artikel. |
Produkte abrufen
Ein privates Angebot basiert auf einem vorhandenen Produkt in Ihrem Partner Center-Konto. Verwenden Sie diesen API-Aufruf, um eine Liste der Produkte anzuzeigen, die Ihrem Partner Center-Konto zugeordnet sind:
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 erstellen, das auf einem bestimmten Plan basiert. 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"
}
]
}
Private Angebote abrufen
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 Produkten und Plänen in Ihrem Partner Center-Konto zugeordnet sind. Im Folgenden finden Sie eine Zusammenfassung des typischen Aufrufmusters bei der Verwendung dieser API.
Schritt 1: Stellen Sie die Anfrage
Wenn Sie einen API-Aufruf ausführen, um ein privates Angebot zu erstellen, zu löschen, zurückzuziehen oder zu aktualisieren, 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: Abfrage des Auftragsstatus
Verwenden Sie die jobId aus der ersten API-Antwort, um den Auftragsstatus abzurufen. Der Status des Auftrags lautet entweder Wird ausgeführt oder Abgeschlossen. Sobald der Auftrag abgeschlossen ist, lautet das Ergebnis entweder Erfolgreich oder Fehlgeschlagen. Um Leistungsprobleme zu vermeiden, sollten Sie einen Auftrag nicht mehr als einmal pro Minute abfragen.
| jobStatus (englisch) | BESCHREIBUNG |
|---|---|
| Nicht gestartet | Der Job wurde noch nicht gestartet. Dies ist Teil der Antwort auf die erste Anforderung. |
| Laufen | Der Job wird noch ausgeführt. |
| Abgeschlossen | Der Auftrag wurde abgeschlossen. Weitere Informationen finden Sie unter jobResult . |
| jobErgebnis | Beschreibung |
| Anhängig | Der Auftrag ist noch nicht abgeschlossen. |
| Erfolgreich | Der Auftrag wurde erfolgreich abgeschlossen. Dieser Auftrag gibt auch einen resourceURI zurück, der auf das private Angebot verweist, das sich auf den Auftrag bezieht. Verwenden Sie diesen resourceURI, um die vollständigen Details eines privaten Angebots abzurufen. |
| gescheitert | Der Auftrag ist fehlgeschlagen. Dadurch werden auch alle relevanten Fehler zurückgegeben, um die Fehlerursache 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 relevante private Angebot verweist. Verwenden Sie diesen Ressourcen-URI, um in Zukunft weitere Details zum privaten Angebot zu erhalten, z. B. die privateofferId.
Ein fehlgeschlagener Auftrag enthält Fehler, die detailliert beschreiben, 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 Channel-Partner die API für private Angebote mit mehreren Teilnehmern gemeinsam verwenden sollten
Sowohl der ISV als auch der Vertriebspartner können dieselben APIs für die Erstellung und Verwaltung eines bestimmten MPO verwenden. Die Ressourcen in einem MPO, die sich auf die API auswirken können, hängen jedoch davon ab, ob der Aufrufer der API der ISV (Urheber) oder der Vertriebspartner (Verkäufer) des MPO ist. Der gleiche ISV-/Channel-Partner-Veröffentlichungsablauf und die gleichen Geschäftsregeln, die für Partner Center gelten, werden in der API gespiegelt. Hier ist ein Überblick:
| API-Vorgang | ISV (Absender) | Vertriebspartner (Verkäufer) |
|---|---|---|
| Erstellen |
|
|
| Löschen |
|
|
| Zurückziehen |
|
|