AWS Marketplace API リファレンスが再構築されました。サポートされている API オペレーションの詳細については、[AWS Marketplace API リファレンス](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html)を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Marketplace Discovery API の使用
<a name="discovery-apis"></a>

 AWS Marketplace Discovery API は、 AWS Marketplace カタログへのプログラムによるアクセスを提供します。これを使用して、製品と料金情報の取得、統合された調達エクスペリエンスの構築、カスタムストアフロントの作成を行うことができます。

## サービスエンドポイント
<a name="discovery-service-endpoint"></a>

Discovery API は、次のエンドポイント形式を使用します。

```
https://discovery-marketplace.{{region}}.api.aws
```

たとえば、米国東部 (バージニア北部) で API を呼び出すには:

```
https://discovery-marketplace.us-east-1.api.aws
```

## API バージョン
<a name="discovery-api-version"></a>

現在の API バージョンは です`2026-02-05`。

## データモデル
<a name="discovery-data-model"></a>

Discovery API は、 AWS Marketplace カタログを次のエンティティに整理します。
+ **出品** — 購入者に表示される製品またはマルチ製品ソリューション。出品には、説明、ハイライト、カテゴリ、バッジ、料金モデル、料金単位、レビュー、プロモーションメディア、販売者のエンゲージメント、フルフィルメントオプションタイプ、および関連する製品やオファーへの参照が含まれます。`GetListing` を使用して出品を取得するか、出品全体で`SearchListings`検索します。
+ **製品** — 販売されている基盤となるソフトウェアまたはサービス。製品には、購入者が製品 (AMI、SaaS、コンテナ、Helm など) をデプロイまたはアクセスする方法を説明する説明、ハイライト、カテゴリ、プロモーションメディア、販売者のエンゲージメント、フルフィルメントオプションが含まれます。`GetProduct` を使用して製品の詳細を取得し、 `ListFulfillmentOptions` を使用して製品の詳細なフルフィルメントオプションを取得します。
+ **オファー** — 料金モデル、登録販売者、利用可能日、バッジなど、製品の料金設定。オファーには、使用量ベースの料金、固定前払い料金、無料トライアル期間、法律文書、支払いスケジュール、更新期間などの商用条件が含まれます。`ListPurchaseOptions` を使用して、製品の利用可能なすべてのオファーを検索し、オファーの詳細`GetOffer`を取得し、オファーの特定の条件`GetOfferTerms`を取得します。
+ **オファーセット** — マルチ製品ソリューションの各製品のプライベートオファーのグループ化されたコレクション。オファーセットを使用すると、購入者はすべてのオファーをまとめて確認し、1 つのアクションで同時に受け入れることができます。`ListPurchaseOptions` を使用して、製品の利用可能なすべてのオファーセットを検索`GetOfferSet`し、オファーセットの詳細を取得し、オファーの詳細`GetOffer`を取得し、オファーの特定の条件`GetOfferTerms`を取得します。

## 認証
<a name="discovery-authentication"></a>

Discovery API は、標準の AWS Signature Version 4 (SigV4) 認証を使用します。API を呼び出すには、有効な AWS 認証情報と適切な IAM アクセス許可が必要です。詳細については、「[AWS Marketplace Discovery API のアクセスコントロール](discovery-api-access-control.md)」を参照してください。

## リクエストの実行
<a name="discovery-making-requests"></a>

すべての Discovery API オペレーションは、JSON リクエストボディで HTTP `POST`メソッドを使用します。オペレーション名は URL パスで指定されます。

## レスポンスの形式
<a name="discovery-response-format"></a>

すべてのレスポンスは JSON 形式で返されます。正常なレスポンスは、HTTP ステータスコード 200 を返します。エラーレスポンスには、エラータイプとメッセージが含まれます。詳細については、[「一般的なエラー](https://docs.aws.amazon.com/marketplace/latest/APIReference/CommonErrors.html)」を参照してください。

## AWS SDK の使用
<a name="discovery-using-sdk"></a>

Discovery API を呼び出す推奨方法は、 AWS SDK を使用することです。SDK は、認証、リクエスト署名、シリアル化、エラー処理を自動的に処理します。

```
# Python (Boto3) example
import boto3

client = boto3.client('marketplace-discovery', region_name='us-east-1')

response = client.get_listing(
    listingId='listing-saas-abc123'
)

print(response['listingName'])
```

```
// JavaScript (AWS SDK v3) example
import { MarketplaceDiscoveryClient, GetListingCommand } from "@aws-sdk/client-marketplace-discovery";

const client = new MarketplaceDiscoveryClient({ region: "us-east-1" });
const response = await client.send(new GetListingCommand({
    listingId: "listing-saas-abc123"
}));

console.log(response.listingName);
```

## Pagination (ページ分割)
<a name="discovery-pagination"></a>

リストを返すオペレーション ( `ListPurchaseOptions`や など`SearchFacets`) は、 を使用したページ分割をサポートしています`nextToken`。レスポンスに`nextToken`値が含まれている場合は、次のリクエストでそれを渡して、追加の結果を取得します。

## スロットリング
<a name="discovery-throttling"></a>

Discovery API は、サービスの可用性を確保するためにリクエストレート制限を適用します。レート制限を超えると、API は `ThrottlingException` (HTTP 429) を返します。エクスポネンシャルバックオフと再試行ロジックをアプリケーションに実装します。