已重組 AWS Marketplace API 參考。如需支援的 API 操作的詳細資訊，請參閱 AWS Marketplace API 參考。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用目錄資料建置界面

您可以使用 AWS Marketplace Discovery API 以程式設計方式存取目錄，並在您自己的平台上顯示產品和定價資訊。本節說明如何使用 探索 API，建置自訂界面，例如商店、合作夥伴入口網站和整合式銷售體驗，供您的客戶瀏覽。

架構概觀

典型的整合遵循此模式：

建立瀏覽體驗

使用 根據搜尋文字和篩選條件SearchListings擷取清單摘要，以及SearchFacets建置動態篩選條件導覽。面向包括類別、履行類型、定價模型、定價單位、發佈者和部署狀態。每個面向值都包含相符清單的計數，您可以隨篩選條件選項一起顯示。

import boto3

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

# Get facet values for building filter navigation
facets = client.search_facets(
    facetTypes=['CATEGORY', 'FULFILLMENT_OPTION_TYPE', 'PRICING_MODEL']
)

for facet_type, values in facets['listingFacets'].items():
    print(f"\n{facet_type}:")
    for facet in values:
        print(f"  {facet['displayName']} ({facet['count']})")

# Search listings with filters applied from user selections
response = client.search_listings(
    searchText='machine learning',
    filters=[
        {
            'filterType': 'CATEGORY',
            'filterValues': ['Machine Learning']
        },
        {
            'filterType': 'PRICING_MODEL',
            'filterValues': ['USAGE']
        }
    ],
    sortBy='RELEVANCE',
    maxResults=25
)

for listing in response['listingSummaries']:
    print(f"{listing['listingName']} - {listing['shortDescription']}")

建置產品詳細資訊頁面

使用 GetListing或 GetProduct 顯示完整的產品詳細資訊、媒體和評論。當您需要清單概觀，包括徽章、類別和定價摘要GetListing時，請使用 。當您需要詳細的產品資訊，例如描述、重點和媒體GetProduct時，請使用 。呼叫 ListFulfillmentOptions 以擷取特定產品的部署選項。

def get_product_page_data(listing_id, product_id):
    """Retrieve data for a product detail page."""

    # Use GetListing for listing-level overview
    listing = client.get_listing(listingId=listing_id)

    # Or use GetProduct for detailed product information
    product = client.get_product(productId=product_id)

    # Get deployment options for the product
    fulfillment = client.list_fulfillment_options(productId=product_id)

    return {
        'listing': listing,
        'product': product,
        'fulfillmentOptions': fulfillment
    }

顯示定價資訊

使用 ListPurchaseOptions 尋找產品的可用優惠，然後使用 GetOffer和 GetOfferTerms 擷取詳細的定價。顯示定價模型、費率卡和術語詳細資訊，協助您的客戶評估選項。

def get_pricing_for_product(product_id):
    """Retrieve pricing options for display."""
    options = client.list_purchase_options(
        filters=[{
            'filterType': 'PRODUCT_ID',
            'filterValues': [product_id]
        }]
    )

    pricing = []
    for option in options.get('purchaseOptions', []):
        for entity in option['associatedEntities']:
            offer = client.get_offer(
                offerId=entity['offer']['offerId']
            )
            terms = client.get_offer_terms(
                offerId=entity['offer']['offerId']
            )
            pricing.append({
                'option': option,
                'offer': offer,
                'terms': terms
            })

    return pricing

最佳實務