

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 una pagina di prodotto in API Gateway
<a name="apigateway-portals-create-product-page"></a>

Una pagina di prodotto aiuta i consumatori a comprendere e utilizzare i prodotti. La documentazione è a livello di prodotto, quindi tutti i portali che includono il prodotto dispongono di questa documentazione. API Gateway supporta due tipi di pagine di prodotto scritte in [GitHub Flavored Markdown](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax):

Pagina di panoramica  
Quando crei il prodotto, API Gateway genera automaticamente una pagina di **panoramica** del prodotto in base alle informazioni fornite durante la creazione del prodotto. Questa pagina ha una formattazione aggiuntiva che non può essere modificata. È possibile modificare il testo o rimuovere la pagina dal prodotto del portale.

Pagine personalizzate  
Una pagina personalizzata è una pagina scritta in Markdown. Puoi utilizzare questa sezione per i termini e le condizioni o per un tutorial su come utilizzare il tuo prodotto. Puoi modificare qualsiasi pagina personalizzata in una pagina di panoramica. Quando si modifica una pagina personalizzata in una pagina di panoramica, il contenuto della pagina viene formattato in modo da corrispondere alla pagina di panoramica.

## Considerazioni
<a name="apigateway-portals-create-product-page-considerations"></a>

Le seguenti considerazioni potrebbero influire sull'utilizzo delle pagine dei prodotti:
+ Questa documentazione non è a livello di API e non include metodi, risorse o parametri di richiesta. Per informazioni su come modificare la documentazione a livello di API per un prodotto, consulta. [Aggiorna un endpoint REST del prodotto in API Gateway](apigateway-portals-update-product-endpoint.md)
+ Non puoi caricare direttamente un `.md` file sul tuo prodotto.
+ Puoi modificare l'ordine delle pagine dei prodotti modificando l'elenco delle pagine nell'ordine di visualizzazione del prodotto del portale. Per ulteriori informazioni, consulta [Aggiornare un prodotto del portale in API Gateway](apigateway-portals-update-portal-product.md).
+ È necessario ripubblicare tutti i portali che includono il prodotto affinché le modifiche alla documentazione abbiano effetto.
+ Se disponi di più portali che utilizzano lo stesso prodotto del portale, le pagine dei prodotti sono le stesse in tutti i portali. Per avere gli stessi endpoint REST del prodotto ma pagine di prodotto diverse, crea più prodotti.

## Crea una pagina di prodotto
<a name="apigateway-portals-create-product-page-create"></a>

La procedura seguente mostra come creare una pagina di prodotto.

**Per creare una pagina di prodotto**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. **Nel riquadro di navigazione principale, scegli i prodotti del portale.**

1. Scegli un prodotto.

1. In **Documentazione**, scegli **Crea pagina personalizzata**.

1. Per **Titolo della pagina**, inserisci il titolo della pagina. 

1. Per **Body**, inserisci la tua documentazione supplementare utilizzando GitHub Flavored Markdown.

   La sezione **Anteprima** mostra come i tuoi contenuti appaiono in un portale. Lo stile visivo finale potrebbe cambiare in base alle impostazioni del portale.

1. Scegli **Crea pagina di prodotto**.

1. La pagina del prodotto è ora una bozza. Scegli **Bozze di documentazione**, quindi scegli la pagina del prodotto per finalizzare il contenuto della pagina.

1. Scegli **Modifica pagina.**

1. Per **Nome sezione**, inserisci un nome o scegli una sezione esistente. Quando aggiungi la pagina del prodotto a una sezione, i consumatori possono visualizzare i tuoi contenuti su un portale pubblicato.

1. Scegli **Save changes** (Salva modifiche).

Per consentire alla nuova pagina di essere visibile ai consumatori, devi comunque ripubblicare il portale. Per ulteriori informazioni, consulta [Pubblica un portale in API Gateway](apigateway-portals-publish-portal.md). 