Konvertieren eines Testabonnements in kostenpflichtige Partner Center-APIs

Artikel
09/23/2023

Hinweis

Diese Schritte gelten nicht für Neue Commerce-Produkte. Informationen zum Konvertieren von New Commerce-Testversionen in kostenpflichtige Abonnements finden Sie in der Dokumentation zum Übergang eines neuen Commerce-Abonnements .

Sie können ein Testabonnement in kostenpflichtige Abonnements konvertieren.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. In diesem Szenario wird Authentifizierung nur mit App- und Benutzeranmeldeinformationen unterstützt.
Eine Kunden-ID (customer-tenant-id). Wenn Sie die KUNDEN-ID nicht kennen, können Sie sie im Partner Center nachschlagen, indem Sie den Arbeitsbereich "Kunden " und dann den Kunden aus der Kundenliste und dann "Konto" auswählen. Suchen Sie auf der Seite "Konto" des Kunden im Abschnitt "Kundenkontoinformationen" nach der Microsoft-ID. Die Microsoft-ID entspricht der Kunden-ID (customer-tenant-id).
Eine Abonnement-ID für ein aktives Testabonnement.
Ein verfügbares Konvertierungsangebot.

Konvertieren eines Testabonnements in ein kostenpflichtiges Abonnement über Code

Um ein Testabonnement in ein kostenpflichtiges Abonnement umzuwandeln, müssen Sie zuerst eine Sammlung der verfügbaren Testversionen erhalten. Anschließend müssen Sie das Konvertierungsangebot auswählen, das Sie kaufen möchten.

Die Konvertierungsangebote geben eine Menge an, die standardmäßig auf dieselbe Anzahl von Lizenzen wie das Testabonnement festgelegt ist. Sie können diese Menge ändern, indem Sie die Eigenschaft "Quantity " auf die Anzahl der Lizenzen festlegen, die Sie kaufen möchten.

Hinweis

Unabhängig von der Anzahl der erworbenen Lizenzen wird die Abonnement-ID der Testversion für die erworbenen Lizenzen wiederverwendet. Die Testversion verschwindet daher und wird durch den Kauf ersetzt.

Führen Sie die folgenden Schritte aus, um ein Testabonnement über Code zu konvertieren:

Rufen Sie eine Schnittstelle zu den verfügbaren Abonnementvorgängen ab. Sie müssen den Kunden identifizieren und den Abonnementbezeichner des Testabonnements angeben.
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```
Abrufen einer Sammlung der verfügbaren Konvertierungsangebote. Weitere Informationen und Details zur Anforderung/Antwort für diese Methode finden Sie unter Abrufen einer Liste der Testkonvertierungsangebote.
```
var conversions = subscriptionOperations.Conversions.Get();
```
Wählen Sie ein Konvertierungsangebot aus. Der folgende Code wählt das erste Konvertierungsangebot in der Sammlung aus.
```
var selectedConversion = conversions.Items.ToList()[0];
```
Geben Sie optional die Anzahl der zu erwerbenden Lizenzen an. Der Standardwert ist die Anzahl der Lizenzen im Testabonnement.
```
selectedConversion.Quantity = 10;
```
Rufen Sie die Create- oder CreateAsync-Methode auf, um das Testabonnement in kostenpflichtig zu konvertieren.
```
var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
```

C#

So konvertieren Sie ein Testabonnement in ein kostenpflichtiges Abonnement:

Verwenden Sie die IAggregatePartner.Customers.ById-Methode mit der Kunden-ID, um den Kunden zu identifizieren.
Rufen Sie eine Schnittstelle zu Abonnementvorgängen ab, indem Sie die Subscriptions.ById-Methode mit der Testabonnement-ID aufrufen. Speichern Sie einen Verweis auf die Schnittstelle für Abonnementvorgänge in einer lokalen Variablen.
Verwenden Sie die Conversions-Eigenschaft, um eine Schnittstelle zu den verfügbaren Vorgängen für Konvertierungen abzurufen, und rufen Sie dann die Get- oder GetAsync-Methode auf, um eine Sammlung verfügbarer Konvertierungsangebote abzurufen. Sie müssen sich für eine Option entscheiden. Im folgenden Beispiel wird standardmäßig die erste verfügbare Konvertierung verwendet.
Verwenden Sie den Verweis auf die Schnittstelle für Abonnementvorgänge, die Sie in einer lokalen Variable und der Conversions-Eigenschaft gespeichert haben, um eine Schnittstelle zu den verfügbaren Vorgängen für Konvertierungen abzurufen.
Übergeben Sie das ausgewählte Konvertierungsangebotsobjekt an die Create- oder CreateAsync-Methode, um die Testkonvertierung zu versuchen.

Beispiel für C#

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

// Get subscription operations for the trial subscription.
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

// Get the available conversions.
var conversions = subscriptionOperations.Conversions.Get();

// If there are no conversions available, we&#39;re done.
// Otherwise, convert the trial to the first available conversion offer.
if (conversions.TotalCount <= 0)
{
    System.Console.WriteLine("This subscription has no conversions");
}
else
{
    // Default to the first conversion.
    var selectedConversion = conversions.Items.ToList()[0];

    // Convert the trial and return the result.
    var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);
}

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI-Parameter

Verwenden Sie die folgenden Pfadparameter, um das Kunden- und Testabonnement zu identifizieren.

Name	Typ	Erforderlich	Beschreibung
Kunden-ID	Zeichenfolge	Ja	Eine guid formatierte Zeichenfolge, die den Kunden identifiziert.
subscription-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die das Testabonnement identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Eine ausgefüllte Konvertierungsressource muss im Anforderungstext enthalten sein.

Beispiel für eine Anfrage

POST https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/488745B5-2086-4912-802C-6ABB9F7C3638/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 234
Expect: 100-continue

{
    "OfferId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "TargetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "OrderId": "D51A052E-043C-4A2A-AA37-2BB938CEF6C1",
    "Quantity": 25,
    "BillingCycle": "monthly",
    "Attributes": {
        "ObjectType": "Conversion"
    }
}

REST-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext eine ConversionResult-Ressource .

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-Fehlercodes.

Beispielantwort

HTTP/1.1 200 OK
Content-Length: 211
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CV: kW4GzmhvHEqCq1ls.0
MS-ServerId: 030020643
Date: Thu, 15 Jun 2017 23:10:40 GMT

 {
    "subscriptionId": "488745B5-2086-4912-802C-6ABB9F7C3638",
    "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "attributes": {
        "objectType": "ConversionResult"
    }
}