適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
カート内で顧客の注文を追加できます。 現在販売可能な内容の詳細については、「 クラウド ソリューション プロバイダー プログラムのパートナー オファー」を参照してください。
注
カートの有効期限は、最初の作成から 7 日間です。
[前提条件]
パートナー センター認証で説明されている資格証明。 このシナリオでは、スタンドアロン アプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
顧客 ID (
customer-tenant-id)。 顧客の ID がわからない場合は、Partner Center で Customers ワークスペースを選択し、顧客一覧から該当の顧客を選択して、Account を選択することで、検索できます。 顧客の [アカウント] ページで、[顧客アカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。
C#
顧客向けの注文を作成するには:
Cart オブジェクトをインスタンス化します。
CartLineItem オブジェクトのリストを作成し、そのリストをカートの LineItems プロパティに割り当てます。 各カート品目には、1 つの製品の購入情報が含まれています。 少なくとも 1 つのカート品目が必要です。
顧客 ID を指定して IAggregatePartner.Customers.ById メソッドを呼び出して顧客を識別し、Cart プロパティからインターフェイスを取得することで、カート操作へのインターフェイスを取得します。
Create メソッドまたは CreateAsync メソッドを呼び出して、カートを作成します。
証明を完了し、他のリセラーを含めるには、次の要求と応答のサンプルを参照してください。
サンプルをリクエスト
{
"PartnerOnRecordAttestationAccepted":true, "lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
"quantity": 1,
"billingCycle": "monthly",
"termDuration": "P1M",
"renewsTo": null,
"provisioningContext": {},
"customTermEndDate": "2022-02-19T00:00:00Z"
},
{
"id": 1,
"catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
"quantity": 2,
"billingCycle": "monthly",
"termDuration": "P1Y",
"participants": [
{
"key": "transaction_reseller",
"value": "5357564"
},
{
"key": "additional_transaction_reseller",
"value": "517285"
},
{
"key": "additional_transaction_reseller",
"value": "5357563"
}
]
}
]
}
応答のサンプル
{
"id": "3e22b548-647d-4223-9675-1fcb6cb57665",
"creationTimestamp": "2021-08-18T17:29:52.3517492Z",
"lastModifiedTimestamp": "2021-08-18T17:29:52.3517553Z",
"expirationTimestamp": "2021-08-25T17:30:11.2406416Z",
"lastModifiedUser": "da62a0dc-35e9-4601-b48e-a047bd3ec7c1",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LH0Z:0001:CFQ7TTC0K18P",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1M",
"customTermEndDate": "2022-02-19T00:00:00Z";
"provisioningContext": {},
"orderGroup": "0"
},
{
"id": 1,
"catalogItemId": "CFQ7TTC0LFLS:0002:CFQ7TTC0KDLJ",
"quantity": 2,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1Y",
"participants": [
{
"key": "transaction_reseller",
"value": "5357564"
},
{
"key": "additional_transaction_reseller",
"value": "517285"
},
{
"key": "additional_transaction_reseller",
"value": "5357563"
}
],
"provisioningContext": {},
"orderGroup": "0"
}
],
"links": {
"self": {
"uri": "/customers/f81d98dd-c2f4-499e-a194-5619e260344e/carts/3e22b548-647d-4223-9675-1fcb6cb57665",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
C# の例
// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;
var cart = new Cart()
{
LineItems = new List<CartLineItem>()
{
new CartLineItem()
{
/* Microsoft Azure Subscription */
Id = 0,
CatalogItemId = "MS-AZR-0145P",
Quantity = 1,
BillingCycle = BillingCycleType.Monthly,
TermDuration = "P1Y"
},
new CartLineItem()
{
/* Azure Reserved Instance */
Id = 1,
CatalogItemId = "DZH318Z0BQ36:004G:DZH318Z08C0S",
Quantity = 1,
BillingCycle = BillingCycleType.OneTime,
TermDuration = "P1Y",
ProvisioningContext = new Dictionary<string, string>
{
{ "subscriptionId", subscriptionId },
{ "scope", "shared" }
}
},
new CartLineItem()
{
/* Azure Reserved Instance */
Id = 2,
CatalogItemId = "DZH318Z0BQ36:004J:DZH318Z08B8X",
Quantity = 1,
BillingCycle = BillingCycleType.OneTime,
TermDuration = "P3Y",
ProvisioningContext = new Dictionary<string, string>
{
{ "subscriptionId", subscriptionId },
{ "scope", "shared" }
}
},
new CartLineItem()
{
/* Perpetual Software */
Id = 3,
CatalogItemId = "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
Quantity = 1,
BillingCycle = BillingCycleType.OneTime
},
new CartLineItem()
{
/* SaaS */
Id = 4,
CatalogItemId = "DZH318Z0BXWC:0002:DZH318Z0BMRV",
Quantity = 1,
BillingCycle = BillingCycleType.Monthly,
TermDuration = "P1M"
},
new CartLineItem()
{
/* SaaS Free Trial */
Id = 5,
CatalogItemId = "DZH318Z0C0WF:0001:DZH318Z0BP69",
Quantity = 10,
BillingCycle = BillingCycleType.None,
TermDuration = "P1M",
RenewsTo = new RenewsTo
{
TermDuration = "P1Y"
}
}
}
};
cart = partnerOperations.Customers.ById(customerId).Carts.Create(cart);
Java
パートナー センター Java SDK を使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は 、コミュニティからヘルプを受 けたり 、GitHub で問題を開 いたりすることができます。
顧客向けの注文を作成するには:
Cart オブジェクトをインスタンス化します。
CartLineItem オブジェクトのリストを作成し、そのリストをカートのラインアイテムに割り当てます。 各カート品目には、1 つの製品の購入情報が含まれています。 少なくとも 1 つのカート品目が必要です。
顧客 ID で IAggregatePartner.getCustomers().byId 関数を呼び出して顧客を識別し、 getCart 関数からインターフェイスを取得することで、カート操作へのインターフェイスを取得します。
create 関数を呼び出してカートを作成します。
Java の例
// IAggregatePartner partnerOperations;
// String customerId;
// String subscriptionId;
// String catalogItemId;
CartLineItem lineItem = new CartLineItem();
lineItem.setBillingCycle(BillingCycleType.OneTime);
lineItem.setCatalogItemId(catalogItemId);
lineItem.setFriendlyName("Sample RI Purchase");
lineItem.setQuantity(1);
Map<String, String> provisioningContext = new HashMap<String,String>();
provisioningContext.put("duration", "3Years");
provisioningContext.put("scope", "shared");
provisioningContext.put("subscriptionId", subscriptionId);
lineItem.setProvisioningContext(provisioningContext);
List<CartLineItem> lineItemList = new ArrayList<CartLineItem>();
lineItemList.add(lineItem);
Cart cart = new Cart();
cart.setLineItems(lineItemList);
Cart cartCreated = partnerOperations.getCustomers().byId(customerId).getCarts().create(cart);
PowerShell
パートナー センター PowerShell モジュールを使用して、パートナー センター リソースを管理できます。 これは、パートナー コミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソース プロジェクトです。 問題が発生した場合は、コミュニティからヘルプを受けたり、GitHub で issue を作成したりすることができます。
顧客のために注文を作成するには:
Cart オブジェクトをインスタンス化します。
CartLineItem オブジェクトのリストを作成し、そのリストをカートの品目に割り当てます。 各カート品目には、1 つの製品の購入情報が含まれています。 少なくとも 1 つのカート品目が必要です。
New-PartnerCustomerCart コマンドを実行してカートを作成します。
# $customerId
# $subscriptionId
# $catalogItemId
$lineItem = New-Object -TypeName Microsoft.Store.PartnerCenter.PowerShell.Models.Carts.PSCartLineItem
$lineItem.BillingCycle = 'OneTime'
$lineItem.CatalogItemId = $catalogItemId
$lineItem.FriendlyName = 'Sample RI Purchase'
$lineItem.ProvisioningContext.Add('duration', '1Year')
$lineItem.ProvisioningContext.Add('scope', 'shared')
$lineItem.ProvisioningContext.Add('subscriptionId', $subsciptionId)
$lineItem.Quantity = 10
New-PartnerCustomerCart -CustomerId $customerId -LineItems $lineItem
REST 要求
リクエスト構文
| メソッド | 要求 URI |
|---|---|
| 投稿 | {baseURL}/v1/customers/{customer-id}/carts HTTP/1.1 |
URI パラメーター
顧客を識別するには、次のパス パラメーターを使用します。
| 名前 | タイプ | 必須 | Description |
|---|---|---|---|
| customer-id | 文字列 | イエス | 顧客を識別する GUID 形式の顧客 ID。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
リクエストの本文
次の表では、要求本文の Cart プロパティについて説明します。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| id | 文字列 | いいえ | カートの作成が成功したときに提供されるカート識別子。 |
| 作成タイムスタンプ | DateTime | いいえ | 日時形式での、カートが作成された日時。 カートの作成が成功した場合に適用されます。 |
| lastModifiedTimeStamp | DateTime | いいえ | カートが最後に更新された日時（日時形式） カートの作成が成功した場合に適用されます。 |
| expirationTimeStamp | DateTime | いいえ | 日付と時刻の形式で、カートの有効期限が切れる日付。 カートの正常な作成時に適用されます。 |
| lastModifiedUser | 文字列 | いいえ | カートを最後に更新したユーザー。 カートの正常な作成時に適用されます。 |
| lineItems | オブジェクトの配列 | イエス | CartLineItem リソースの配列。 |
| 記録上のパートナーの証明が承認されました | ブール値 | イエス | Attestation の完了を確認 |
次の表では、要求本文の CartLineItem プロパティについて説明します。
注
API を使用してカートをチェックアウトすると、品目は カートに入れた順序で処理されます。 注文は、同じ種類の商品がカートに 2 つあり、1 つはプロモーション ID を持ち、もう 1 つは (たとえば、異なる条件で) ない場合に、New To Offer 制約によるプロモーションの適格性に影響を与える可能性があります。 複数のアイテムを購入手続きする場合は、プロモーションの対象となる商品項目をカートの最初に配置してください。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| id | 文字列 | いいえ | カートの品目の一意識別子。 カートの正常な作成時に適用されます。 |
| catalogId | 文字列 | イエス | カタログアイテム識別子 カタログ項目の利用可否が正しいセグメント用であることを確認します。 |
| フレンドリーネーム | 文字列 | いいえ | Optional. あいまいさを解消するためにパートナーによって定義された項目のフレンドリ名。 |
| promotionId | 文字列 | いいえ | Optional. ほとんどの新しいコマース プロモーションは自動的に適用されますが、オプションのプロモーション (Bridge to the Cloud 2 など) をカートの品目に適用するには、パートナーはカートに追加するときにプロモーション ID を含める必要があります。 |
| 量 | 整数 (int) | イエス | ライセンスまたはインスタンスの数。 |
| 通貨コード | 文字列 | いいえ | 通貨コード。 |
| billingCycle | Object | イエス | 現在の期間に設定された請求サイクルの種類。 |
| customTermEndDate | DateTime | いいえ | 新しいサブスクリプションの終了日を合わせる既存のサブスクリプションの終了日。 |
| 参加者 | オブジェクト文字列ペアの一覧 | いいえ | 購入時の PartnerId on Record (PartnerID) のコレクション。 |
| provisioningContext | Dictionary<string、string> | いいえ | カタログ内の一部の項目のプロビジョニングに必要な情報。 SKU の provisioningVariables プロパティは、カタログ内の特定のアイテムに必要なプロパティを示します。 |
| orderGroup | 文字列 | いいえ | 一緒に配置できる項目を示すグループ。 |
| エラー | Object | いいえ | エラーが発生した場合、カートが作成された後に適用されます。 |
| renewsTo | オブジェクトの配列 | いいえ | RenewsTo リソースの配列。 |
| AttestationAccepted | ブール値 | いいえ | オファーまたは SKU の条件への同意を示します。 SkuAttestationProperties または OfferAttestationProperties enforceAttestation が True のオファーまたは SKU にのみ必要です。 |
| transaction_reseller | String | いいえ | 間接プロバイダーが間接リセラーに代わって注文を行う場合は、このフィールドには 間接リセラーのみ の PartnerID を設定します (間接プロバイダーの ID は設定しません)。 これにより、インセンティブを適切に会計処理できます。 |
| additional_transaction_reseller | String | いいえ | 間接プロバイダーが間接リセラーに代わって注文を行う場合は、このフィールドに 追加間接リセラーのみの PartnerID を設定します (間接プロバイダーの ID は設定しません)。 インセンティブは、これらの他のリセラーには適用されません。 最大 5 つの間接リセラーのみを入力できます。 この必要は、ヨーロッパの国/地域内で取引する適用可能なパートナーのみです。 |
| scheduledNextTermInstructions | Object | いいえ | 試用版サブスクリプションの次の期間の指示を定義します。 パートナーは、更新時に対応する有料サブスクリプションが持つ期間、billingFrequency、数量を指定できます。 |
次の表では、Microsoft Marketplace オファーの要求本文の RenewsTo プロパティについて説明します。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| termDuration | 文字列 | いいえ | 更新期間の長さを表す ISO 8601 形式の表現。 現在サポートされている値は P1M (1 か月) と P1Y (1 年) です。 |
ScheduledNextTermInstructions
次の表では、NCE ライセンス ベースの試用版オファーの要求本文の scheduledNextTermInstructions プロパティについて説明します。 値が指定されていない場合、試用版は年間期間、月単位の請求、25 個のライセンスを使用して有料サブスクリプションに更新されます。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| 製品 | アレイ | いいえ | 試用版サブスクリプションが更新されるオファーと、有料サブスクリプションの期間と請求頻度を指定する配列。 |
| 量 | 整数 (int) | いいえ | 試用版オファーが更新されると、対応する有料サブスクリプションに含まれるライセンス数量。 |
注文グループ
API は、カートの作成または更新中にカート明細項目に返される orderGroup 値を割り当てます。 指定した値は API によって上書きされます。 チェックアウト中、各注文グループは個別の注文になります。
次のすべての値が一致する場合にのみ、同じグループに行項目を配置します。
-
annual、monthly、トライアルなどの課金サイクル - セグメント、
commercialやeducationなど - 通貨コード
- 製品ファミリ（
OnlineServicesNCEなど） - レガシー vs. NCE
注文グループには、最大 10 個の明細を含めることができます。 新しい注文グループに追加の明細が配置されます。 カートに表示できる注文グループの数に制限はありません。
以下の項目タイプが個別の注文グループに配置されます。
- Azure Reservations
- Azure特典（プロモーションや
FlexSpendPlanを含む）
Product
次の表では、NCE ライセンス ベースの試用版オファーの要求本文の productTerm プロパティについて説明します。 この配列に値が指定されていない場合、試用版は年単位の月単位の請求で有料サブスクリプションに更新されます。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| productId | 文字列 | いいえ | 試用版が更新される有料サブスクリプションの製品を表現するためにフォーマットされた GUID。 |
| skuId | 文字列 | いいえ | 試用版が更新される有料サブスクリプションの SKU を表す形式の GUID。 |
| availabilityId | 文字列 | いいえ | 試用版が更新される有料サブスクリプションの可用性を示すようにフォーマットされた GUID。 |
| billingCycle | 文字列 | いいえ | 試用版オファーが更新されると、対応する有料サブスクリプションが持つ課金頻度。 |
| termDuration | 文字列 | いいえ | 試用版オファーが更新された後に適用される、対応する有料サブスクリプションの期間。 |
要求の例
POST /v1/customers/d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d/carts HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 496
Expect: 100-continue
{
"lineItems": [
{
/* Microsoft Azure Subscription */
"id": 0,
"catalogItemId": "MS-AZR-0145P",
"quantity": 1,
"billingCycle": "monthly",
"termDuration": "P1Y"
},
{
/* Azure Reserved Instance */
"id": 1,
"catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
"quantity": 1,
"billingCycle": "one_time",
"termDuration": "P1Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "shared"
}
},
{
/* Azure Reserved Instance */
"id": 2,
"catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
"quantity": 1,
"billingCycle": "one_time",
"termDuration": "P3Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "single"
}
},
{
/* Perpetual Software */
"id": 3,
"catalogItemId": "DG7GMGF0DWTL:0001:DG7GMGF0DSFM",
"quantity": 1,
"billingCycle": "one_time"
},
{
/* SaaS */
"id": 4,
"catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
"quantity": 1,
"billingCycle": "monthly",
"termDuration": "P1M"
},
{
/* SaaS Free Trial */
"id": 5,
"catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
"quantity": 10,
"billingCycle": "none",
"termDuration": "P1M",
"renewsTo": {
"termDuration": "P1Y"
}
}
]
}
Important
2023 年 6 月の時点で、最新のパートナー センター .NET SDK リリース 3.4.0 は現在アーカイブされています。 GitHub から SDK リリースをダウンロードできます。有用な情報を含む readme ファイルもあります。
パートナーは、引き続き パートナー センター REST API を使用することをお勧めします。
REST 応答
成功した場合、このメソッドは応答本文で設定された Cart リソースを返します。
応答の成功とエラー コード
各応答には、成功または失敗とデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを確認します。 完全な一覧については、「エラーコード」を参照してください。
応答の例
HTTP/1.1 201 Created
Content-Length: 764
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 4fa6dad6-a89f-4875-8247-8294a10ae1cf
X-Locale: en-US,en-US
MS-CV: sF/wRa2ih0CzbABc.0
MS-ServerId: 000001
Date: Thu, 15 Mar 2018 17:15:01 GMT
{
"id": "3655b1a0-b1c9-4268-9824-577fdbc4d0be",
"creationTimestamp": "2019-01-16T00:45:41.6062996Z",
"lastModifiedTimestamp": "2019-01-16T00:45:41.6062996Z",
"expirationTimestamp": "2019-01-16T01:00:54.4188497Z",
"lastModifiedUser": "1824b7fc-2fac-4478-b177-66823c40ab75",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "MS-AZR-0145P",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1Y",
"orderGroup": "OMS-0"
},
{
"id": 1,
"catalogItemId": "DZH318Z0BQ36:004G:DZH318Z08C0S",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "one_time",
"termDuration": "P1Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "shared"
},
"orderGroup": "0"
},
{
"id": 2,
"catalogItemId": "DZH318Z0BQ36:004J:DZH318Z08B8X",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "one_time",
"termDuration": "P3Y",
"provisioningContext": {
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"scope": "shared"
},
"orderGroup": "0"
},
{
"id": 3,
"catalogItemId": "DG7GMGF0DWM3:0002:DG7GMGF0DT1M",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "one_time",
"orderGroup": "0"
},
{
"id": 4,
"catalogItemId": "DZH318Z0BXWC:0002:DZH318Z0BMRV",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1M",
"orderGroup": "1"
},
{
"id": 5,
"catalogItemId": "DZH318Z0C0WF:0001:DZH318Z0BP69",
"quantity": 10,
"currencyCode": "USD",
"billingCycle": "none",
"termDuration": "P1M",
"renewsTo": {
"termDuration": "P1Y"
},
"orderGroup": "2"
}
],
"links": {
"self": {
"uri": "/customers/28045616-f6b9-462f-9701-0d89b5e65c44/carts/3655b1a0-b1c9-4268-9824-577fdbc4d0be",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
新しいコマース ライセンス ベースのサービスの例
注
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
要求の例
POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165
{
"LineItems": [
{
"CatalogItemId":"CFQ7TTC0LFLZ:0002:CFQ7TTC0K4TS",
"Quantity": 1,
"TermDuration": "P1M",
"BillingCycle": "Monthly"
}
]
}
Important
Azure プランと永続ソフトウェアの項目は、termDuration プロパティをサポートしていません。 これらの種類の項目を取得する際に、これを含めないでください。
// request example where several renewal values for an NCE license-based trial are specified
http
POST /v1/customers/932c4101-dc08-461b-b4c1-75d80e905775/carts HTTP/1.1
Host: api.partnercenter.microsoft.com
Content-Type: application/json
Content-Length: 165
{
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
"quantity": 25,
"currencyCode": "USD",
"billingCycle": "none",
"termDuration": "P1M",
"promotionId": null,
"provisioningContext": {},
"customTermEndDate": null,
"scheduledNextTermInstructions": {
"product": {
"billingCycle": "monthly",
"termDuration": "P1M"
}
}
}
],
"partnerOnRecordAttestationAccepted": true
}
REST 応答
成功した場合、このメソッドは応答本文で設定された Cart リソースを返します。
応答の成功とエラー コード
各応答には、成功または失敗とその他のデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ってください。 完全な一覧については、「エラーコード」を参照してください。
応答の例
{
"id": "2517c51b-58cd-4abe-87ed-3ab812401ab4",
"creationTimestamp": "2023-07-11T21:16:11.55149Z",
"lastModifiedTimestamp": "2023-07-11T21:16:11.5515713Z",
"expirationTimestamp": "2023-07-18T21:16:17.2480482Z",
"lastModifiedUser": "9db12087-fbc3-481c-8965-73d44ff88e27",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0VZW5",
"quantity": 1,
"currencyCode": "USD",
"billingCycle": "monthly",
"termDuration": "P1Y",
"provisioningContext": {},
"orderGroup": "0",
"pricing": {
"listPrice": 30.4,
"discountedPrice": 30.4,
"proratedPrice": 30.4,
"price": 30.4,
"extendedPrice": 364.8
}
}
],
"links": {
"self": {
"uri": "/customers/ebd8b4c2-4069-46a8-bd70-123d6dec3e39/carts/2517c51b-58cd-4abe-87ed-3ab812401ab4",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}
// response content for an order containing an NCE license-based trial
{
"id": "99d3777b-61da-4c95-aefa-203c248c4180",
"creationTimestamp": "2025-02-04T22:22:36.7924103Z",
"lastModifiedTimestamp": "2025-02-04T22:22:36.7924109Z",
"expirationTimestamp": "2025-02-11T22:23:34.5190698Z",
"lastModifiedUser": "b5109661-56c5-45ed-9447-f67463458a97",
"status": "Active",
"lineItems": [
{
"id": 0,
"catalogItemId": "CFQ7TTC0LCHC:0003:CFQ7TTC0XCQC",
"quantity": 25,
"currencyCode": "USD",
"billingCycle": "none",
"termDuration": "P1M",
"provisioningContext": {},
"orderGroup": "0",
"pricing": {
"listPrice": 0.0,
"discountedPrice": 0.0,
"proratedPrice": 0.0,
"price": 0.0,
"extendedPrice": 0.0
},
"scheduledNextTermInstructions": {
"product": {
"productId": "CFQ7TTC0LCHC",
"skuId": "0002",
"availabilityId": "CFQ7TTC0XL82",
"billingCycle": "monthly",
"termDuration": "P1M"
},
"quantity": 25
}
}
],
"links": {
"self": {
"uri": "/customers/81e78b53-9aa8-44e7-a041-3b15272d8f84/carts/99d3777b-61da-4c95-aefa-203c248c4180",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Cart"
}
}