AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Marketplace API 참조를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

카탈로그 데이터를 사용하여 인터페이스 구축

AWS Marketplace Discovery API를 사용하여 프로그래밍 방식으로 카탈로그에 액세스하고 자체 플랫폼에 제품 및 요금 정보를 표시할 수 있습니다. 이 섹션에서는 Discovery 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를 사용하여 제품에 사용할 수 있는 제안을 찾은 다음 GetOfferGetOfferTerms를 사용하여 자세한 요금을 검색합니다. 고객이 옵션을 평가하는 데 도움이 되는 요금 모델, 요금 카드 및 기간 세부 정보를 표시합니다.

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

모범 사례