Freigeben über

API-Referenz für das Cloud-Partnerportal

Hinweis

Die Cloud-Partnerportal-APIs sind in Partner Center integriert und funktionieren weiterhin in Partner Center. Der Übergang führt zu kleinen Veränderungen. Überprüfen Sie die in diesem Dokument aufgeführten Änderungen an CPP-APIs , um sicherzustellen, dass Ihr Code nach dem Übergang zu Partner Center weiterhin funktioniert. CPP-APIs sollten nur für vorhandene Produkte verwendet werden, die bereits vor dem Übergang zu Partner Center integriert wurden. Neue Produkte sollten Partner Center-Übermittlungs-APIs verwenden.

Die REST-APIs des Cloud-Partnerportals ermöglichen das programmgesteuerte Abrufen und Bearbeiten von Workloads, Angeboten und Herausgeberprofilen. Die APIs verwenden die rollenbasierte Zugriffssteuerung von Azure (Azure Role-Based Access Control, Azure RBAC), um die richtigen Berechtigungen zur Verarbeitungszeit zu erzwingen.

Diese Referenz enthält die technischen Details für die REST-APIs des Cloud-Partnerportals. Die Payload-Beispiele in diesem Dokument dienen nur als Referenz und können sich ändern, wenn neue Funktionen hinzugefügt werden.

Voraussetzungen und Überlegungen

Bevor Sie die APIs verwenden, sollten Sie Folgendes überprüfen:

  • Im Artikel Voraussetzungen erfahren Sie, wie Sie Ihrem Konto einen Dienstprinzipal hinzufügen und ein Microsoft Entra Zugriffstoken für die Authentifizierung abrufen.
  • Die beiden Strategien zur Steuerung der Parallelität, die zum Aufrufen dieser APIs verfügbar sind.
  • Weitere API-Überlegungen, z. B. Versionierung und Fehlerbehandlung.

Änderungen an CPP-APIs nach der Migration zu Partner Center

API Beschreibung ändern Auswirkung
POST Veröffentlichen, GoLive, Abbrechen Bei migrierten Angeboten hat der Antwortheader ein anderes Format, funktioniert aber weiterhin auf die gleiche Weise und gibt einen relativen Pfad zum Abrufen des Vorgangsstatus an. Wenn Sie eine der entsprechenden POST-Anforderungen für ein Angebot senden, hat der Location-Header je nach Migrationsstatus des Angebots eines von zwei Formaten:
  • Nicht migrierte Angebote
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Migrierte Angebote
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
GET-Vorgang Bei Angebotstypen, die zuvor das Feld "notification-email" in der Antwort unterstützt haben, ist dieses Feld veraltet und wird für migrierte Angebote nicht mehr zurückgegeben. Bei migrierten Angeboten senden wir keine Benachrichtigungen mehr an die Liste der E-Mails, die in den Anfragen angegeben sind. Stattdessen richtet sich der API-Dienst an den Benachrichtigungs-E-Mail-Prozess in Partner Center aus, um E-Mails zu senden. Insbesondere werden Benachrichtigungen an die E-Mail-Adresse gesendet, die im Abschnitt "Kontaktinformationen des Verkäufers" Ihrer Kontoeinstellungen in Partner Center festgelegt ist, um Sie über den Fortschritt des Vorgangs zu informieren.

Überprüfen Sie die E-Mail-Adresse, die im Abschnitt "Kontaktinformationen des Verkäufers" Ihrer Kontoeinstellungen in Partner Center festgelegt ist, um sicherzustellen, dass die richtige E-Mail-Adresse für Benachrichtigungen bereitgestellt wird.

Allgemeine Aufgaben

In dieser Referenz werden APIs zum Ausführen der folgenden allgemeinen Aufgaben beschrieben.

Angebote

Operationen

Veröffentlichen einer App

Weitere Aufgaben

Problembehandlung

API-Versionen und -Updates

Aktualisierung Was hat sich geändert?
12-2022 Die öffentliche CPP-API (Version 2017-10-31) wurde jetzt aktualisiert, um clientId und clientSecret für den Marketo-Connector beim Konfigurieren von Kundenleads zu erfassen. Während der Lead-Konfiguration müssen Sie das Feld serverId in Zukunft nicht mehr angeben. Dieses Update der API beinhaltet keine Versionsupdates oder Breaking Changes.