ID で可用性を取得する

[アーティクル]
11/05/2024

可用性 ID を使用して、指定した製品と SKU の可用性を取得します。可用性 ID は変更可能で動的であり、定期的に再発行されます。パートナーは、カートの品目を提出するとき、または可用性 ID を必要とする他のアクティビティを実行するときに、常に現在の可用性を取得する必要があります。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンアプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
製品 ID。
SKU ID。
可用性 ID。

C#

特定の可能性の詳細を取得するには最初に、「 ID で SKU を取得する特定の SKU の操作のインターフェイスを取得する」の手順を使用します。結果のインターフェイスから、 Availabilities プロパティを選択して、可用性に対して使用可能な操作を含むインターフェイスを取得します。その後、可用性 ID を ById() メソッドに渡して、その特定の可用性の操作を取得し、 Get() または GetAsync() を呼び出して可用性の詳細を取得します。

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string availabilityId;

// Get the availability details.
var availability = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.ById(availabilityId).Get();

Java

Partner Center Java SDK を使用して、パートナーセンターのリソースを管理できます。これは、パートナーコミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソースプロジェクトです。問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。

特定の可能性の詳細を取得するには最初に、「 ID で SKU を取得する特定の SKU の操作のインターフェイスを取得する」の手順を使用します。結果のインターフェイスから、 getAvailabilities 関数を選択して、可用性に使用可能な操作を含むインターフェイスを取得します。その後、可用性 ID を byId() 関数に渡して、その特定の可用性の操作を取得し、 get() 関数を呼び出して可用性の詳細を取得します。

IAggregatePartner partnerOperations;
String countryCode;
String productId;
String skuId;
String availabilityId;

// Get the availability details.
Availability availability = partnerOperations.getProducts().byCountry(countryCode).byId(productId).getSkus().byId(skuId).getAvailabilities().byId(availabilityId).get();

PowerShell

Partner Center PowerShell モジュールを使用して、パートナーセンターリソースを管理できます。これは、パートナーコミュニティによって管理され、Microsoft によって正式にサポートされていないオープンソースプロジェクトです。問題が発生した場合は、コミュニティから支援を得るか、GitHub に問題を投稿することができます。

特定の availability の詳細を取得するには、 Get-PartnerProductAvailability を実行し、 AvailabilityId、 CountryCode、 ProductId、および SkuId パラメーターを指定して可用性の詳細を取得します。

Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

URI パラメーター

可用性 ID を使用して特定の可用性を取得するには、次のパスとクエリパラメーターを使用します。

名前	タイプ	Required	説明
product-id	string	はい	製品を識別する GUID 形式の文字列。
sku-id	string	はい	SKU を識別する GUID 形式の文字列。
availability-id	string	はい	可用性を識別する GUID 形式の文字列。
country-code	string	はい	国/地域 ID。
IncludeLifeCycleState	string	いいえ	New Commerce ライセンスベースのオファーのライフサイクル状態の値を返すために true に設定できる文字列フラグ。フラグが含まれていない場合、これらの値は返されません。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求本文

なし。

要求の例

GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

重要

2023 年 6 月の時点で、最新のパートナーセンター .NET SDK リリース 3.4.0 がアーカイブされるようになりました。 SDK リリースは、有用な情報が記載された readme ファイルと一緒に GitHub からダウンロードできます。

パートナーの皆様には、パートナーセンター REST API を引き続き使用することをお勧めします。

REST 応答

成功した場合、応答本文には Availability リソースが含まれます。

応答の成功とエラーのコード

各応答には、成功または失敗と追加のデバッグ情報を示す HTTP 状態コードが付属しています。ネットワークトレースツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。完全な一覧については、 Partner Center のエラーコードを参照してください。

このメソッドは、次のエラーコードを返します。

HTTP 状態コード	エラーコード	説明
404	400013	製品が見つかりませんでした。
404	400018	SKU が見つかりませんでした。
404	400019	可用性が見つかりません。このエラーは、カートをチェックアウトするときに発生する可能性があります。このエラーが発生したパートナーは、新しい GET を発行して、現在の可用性 ID を持っていることを確認し、カートのチェックアウトを再試行する必要があります。

Azure VM 予約の応答の例 (Azure プラン)

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c,2e12a576-ded5-437e-a5ec-dbfbcbd1624c
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllc1xEWkgzMThaMEhNS1E=?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:43 GMT
Content-Length: 440

{
    "id": "DZH318XZXPHL",
    "productId": "DZH318Z0BQ3Q",
    "skuId": "0001",
    "catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXPHL",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": false,
    "terms": [{
        "duration": "P1Y",
        "description": "1 Year Prepaid"
    }],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

新しいコマースライセンスベースのサービスの応答例

Note

ライセンスベースのサービスの新しいコマースエクスペリエンスには、多くの新機能が含まれており、すべてのクラウドソリューションプロバイダー (CSP) で利用できます。詳細については、新しいコマースエクスペリエンスの概要を参照してください。

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808

{
    "id": "CFQ7TTC0K971",
    "productId": "CFQ7TTC0LH18",
    "skuId": "0001",
    "catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": true, 
    "renewalInstructions": [
        {
            "applicableTermIds": [
                "5aeco6mffyxo"
            ],
            "renewalOptions": [
                {
                    "renewToId": "CFQ7TTC0LH18:0001",
                    "isAutoRenewable": true
                }
            ]
        },
	 …
    ],
    "terms": [
        {
            "id": "5aeco6mffyxo",
            "duration": "P1Y",
            "description": "One-Year commitment for monthly/yearly billing",
            "billingCycle": "Annual",
            "cancellationPolicies": [
                {
                    "refundOptions": [
                        {
                            "sequenceId": 0,
                            "type": "Full",
                            "expiresAfter": "P1D"
                        }
                    ]
                }
            ]
        },
       …
    ],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

次の方法で共有

ID で可用性を取得する

前提条件

C#

Java

PowerShell

REST 要求

要求の構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

REST 応答

応答の成功とエラーのコード

Azure VM 予約の応答の例 (Azure プラン)

新しいコマースライセンスベースのサービスの応答例

フィードバック

その他のリソース

次の方法で共有

ID で可用性を取得する

前提条件

C#

Java

PowerShell

REST 要求

要求の構文

URI パラメーター

要求ヘッダー

要求本文

要求の例

REST 応答

応答の成功とエラーのコード

Azure VM 予約の応答の例 (Azure プラン)

新しいコマース ライセンス ベースのサービスの応答例

フィードバック

その他のリソース

新しいコマースライセンスベースのサービスの応答例