L'AWS Marketplace API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'AWS Marketplace API Reference.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea interfacce con dati di catalogo

Puoi utilizzare l'API Marketplace AWS Discovery per accedere in modo programmatico al catalogo e visualizzare informazioni sui prodotti e sui prezzi sulle tue piattaforme. Questa sezione descrive come creare interfacce personalizzate come vetrine, portali per i partner ed esperienze di vendita integrate per consentire ai clienti di navigare, utilizzando l'API Discovery.

Panoramica dell’architettura

Un'integrazione tipica segue questo schema:

Crea un'esperienza di navigazione

Utilizzalo SearchListings per recuperare i riepiloghi delle inserzioni in base al testo di ricerca e ai filtri e SearchFacets per creare una navigazione dinamica tra filtri. Gli aspetti includono categorie, tipi di evasione degli ordini, modelli di prezzo, unità di prezzo, editori e stato di implementazione. Ogni valore sfaccettato include un numero di inserzioni corrispondenti, che puoi visualizzare insieme alle opzioni di filtro.

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']}")

Crea pagine di dettaglio dei prodotti

Utilizza GetListing o GetProduct per visualizzare i dettagli completi del prodotto, i contenuti multimediali e le recensioni. Utilizzalo GetListing quando ti serve la panoramica delle offerte che include badge, categorie e riepiloghi dei prezzi. Utilizzalo GetProduct quando hai bisogno di informazioni dettagliate sul prodotto come descrizioni, punti salienti e contenuti multimediali. Chiama ListFulfillmentOptions per recuperare le opzioni di distribuzione per un prodotto specifico.

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
    }

Visualizza le informazioni sui prezzi

ListPurchaseOptionsUtilizzalo per trovare le offerte disponibili per un prodotto GetOffer e quindi GetOfferTerms per recuperare i prezzi dettagliati. Visualizza modelli di prezzo, schede tariffarie e dettagli sui termini per aiutare i clienti a valutare le opzioni.

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

Best practice