使用合作夥伴中心 API 將試用版訂用帳戶轉換為付費

發行項
10/01/2024

注意

這些步驟不適用於新商務產品。 請參閱轉換新的商務訂閱 檔，以將新商務試用版轉換為付費訂閱

您可以將試用版訂用帳戶轉換為付費訂閱。

必要條件

認證，如合作夥伴中心驗證所述。此案例僅支援使用「應用程式+使用者」認證來進行驗證。
客戶識別碼 (customer-tenant-id)。如果您不知道客戶的識別碼，您可以在合作夥伴中心中選取 [客戶 ] 工作區，然後從客戶清單中查看客戶，然後 從 [帳戶 ]。在客戶的 [帳戶] 頁面上，在 [客戶帳戶資訊] 區段中尋找 Microsoft 識別碼 。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。
使用中試用版訂用帳戶的訂用帳戶識別碼。
可用的轉換供應專案。

透過程式碼將試用訂用帳戶轉換為付費訂用帳戶

若要將試用訂閱轉換為付費訂閱，您必須先取得可用的試用版轉換集合。然後，您必須選擇您想要購買的轉換供應專案。

轉換供應專案會指定預設為與試用訂用帳戶相同的授權數目數量。您可以將 Quantity 屬性設定 為您想要購買的授權數目，以變更此數量。

注意

無論購買的授權數目為何，試用版的訂用帳戶識別碼都會重複使用給購買的授權。因此，生效的試驗會消失，並由購買所取代。

使用下列步驟，透過程式碼轉換試用訂閱：

取得可用的訂用帳戶作業介面。您必須識別客戶，並指定試用訂閱的訂用帳戶識別碼。
```
var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);
```
取得可用轉換供應專案的集合。如需此方法之要求/回應的詳細資訊和詳細資料，請參閱取得試用版轉換供應專案清單。
```
var conversions = subscriptionOperations.Conversions.Get();
```
選擇轉換供應專案。下列程式碼會選擇集合中的第一個轉換供應專案。
```
var selectedConversion = conversions.Items.ToList()[0];
```
選擇性地指定要購買的授權數目。預設值是試用版訂用帳戶中的授權數目。
```
selectedConversion.Quantity = 10;
```

呼叫 Create 或 CreateAsync 方法，將試用訂閱轉換為付費訂閱。

var convertResult = subscriptionOperations.Conversions.Create(selectedConversion);

C#

若要將試用版訂用帳戶轉換為付費訂閱：

使用 IAggregatePartner.Customers.ById 方法搭配客戶識別碼來識別客戶。
使用試用訂用帳戶識別碼呼叫 Subscriptions.ById 方法， 以取得訂用帳戶作業的介面。將訂用帳戶作業介面的參考儲存在區域變數中。
使用 Conversions 屬性取得轉換作業的介面，然後呼叫 Get 或 GetAsync 方法來擷取可用轉換供應專案的集合。您必須選擇一個。下列範例預設為第一個可用的轉換。
使用您儲存在區域變數中的訂用帳戶作業介面參考和 Conversions 屬性，以取得轉換上可用作業的介面。
將選取的轉換供應專案物件傳遞至 Create 或 CreateAsync 方法，以嘗試試用轉換。

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 要求

要求語法

方法	要求 URI
POST	{baseURL} /v1/customers/{customer-id}/subscriptions/{subscription-id}/conversions HTTP/1.1

URI 參數

使用下列路徑參數來識別客戶和試用訂用帳戶。

名稱	類型	必填	描述
customer-id	string	Yes	識別客戶的 GUID 格式化字串。
subscription-id	string	Yes	識別試用訂閱的 GUID 格式字串。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

填入的轉換資源必須包含在要求本文中。

要求範例

POST https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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 回應

如果成功，回應主體會包含 ConversionResult 資源。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 211
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bd0cde7f-ba87-4010-8a73-1190b641f2a4
MS-CV: kW4GzmhvHEqCq1ls.0
MS-ServerId: 030020643
Date: Thu, 15 Jun 2017 23:10:40 GMT

 {
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
    "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "attributes": {
        "objectType": "ConversionResult"
    }
}

共用方式為