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à.
# Integrazione dell'API Amazon Selling Partner
Per accedere ai dati tramite l'Amazon Selling Partner API (SP-API), devi completare le seguenti azioni:
1. [Registrati come sviluppatore SP-API](#integrating-developer)
1. [Richiedi ruoli SP-API](#integrating-roles)
1. [Registra la tua candidatura](#integrating-register)
1. [Seleziona un modello di autorizzazione per la tua domanda](#integrating-authorization)
1. [Connect alla SP-API](#integrating-connect)
## Registrati come sviluppatore SP-API
Prima di poter registrare la tua applicazione SP-API, devi creare un account sviluppatore Amazon e registrarti come sviluppatore SP-API. Per una panoramica completa del processo di registrazione degli sviluppatori, consulta Panoramica sulla registrazione SP-API nella [documentazione SP-API](https://developer-docs.amazon.com/sp-api/docs/sp-api-registration-overview).
## Richiedi i ruoli SP-API
Un [ruolo SP-API](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api) determina se uno sviluppatore o un'applicazione ha accesso a un'operazione o una risorsa specifica. In qualità di sviluppatore, devi richiedere e qualificarti per un ruolo particolare, altrimenti non sarai in grado di accedere alle operazioni e alle risorse raggruppate in quel ruolo.
I ruoli proteggono l'accesso alle informazioni di identificazione personale (PII) e ad altri dati sensibili. Limitano l'accesso ai dati per garantire che gli sviluppatori possano accedere solo ai dati necessari per la loro applicazione. Questo aiuta a proteggere i dati dei clienti e a preservare la fiducia dei clienti.
L'accesso ai dati disponibili nei report di analisi del marchio richiede il [ruolo di Brand Analytics](https://developer-docs.amazon.com/sp-api/docs/brand-analytics-role). Per ulteriori informazioni sulla richiesta di accesso a un ruolo, consulta [Come posso richiedere e qualificarmi per un ruolo](https://developer-docs.amazon.com/sp-api/docs/roles-in-the-selling-partner-api#how-do-i-request-and-qualify-for-a-role) nella documentazione SP-API.
## Registra la tua candidatura
Il processo di registrazione varia leggermente a seconda del tipo di domanda. Ai fini della registrazione, le domande sono classificate in uno dei seguenti tipi:
+ **Applicazioni pubbliche e applicazioni per venditori privati**: si tratta di applicazioni disponibili pubblicamente e autorizzate da un venditore o fornitore oppure di applicazioni per venditori disponibili solo per l'organizzazione dell'utente e autorizzate autonomamente.
+ **Applicazioni di fornitori privati**: si tratta di applicazioni di fornitori disponibili solo per l'organizzazione e autorizzate autonomamente.
Per ulteriori informazioni, consulta [Registrare l'applicazione nella documentazione SP-API](https://developer-docs.amazon.com/sp-api/docs/registering-your-application).
## Seleziona un modello di autorizzazione per la tua applicazione
Il modello di autorizzazione per l'API Selling Partner si basa su [Login with Amazon](https://developer.amazon.com/docs/login-with-amazon/documentation-overview.html), un'implementazione Amazon OAuth 2.0. La tua applicazione è autorizzata tramite interazioni con le pagine visualizzate da Amazon e dal tuo sito Web. Il browser Web è l'agente utente che trasmette i parametri tra il tuo sito Web e Amazon a ogni azione del partner di vendita. Per implementare OAuth l'autorizzazione, devi configurare il tuo sito Web in modo che accetti ed elabori i parametri che Amazon gli trasmette. È inoltre necessario configurare il sito Web per reindirizzare il browser Web e passare i parametri ad Amazon. Per ulteriori informazioni sull'autorizzazione, consulta [Autorizzazione delle applicazioni API Selling Partner nella documentazione](https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications) SP-API.
### Comprendi l'autorizzazione delle applicazioni
Ai fini dell'autorizzazione, esistono tre tipi di applicazioni:
+ **Applicazioni pubbliche per venditori**: queste applicazioni sono disponibili al pubblico e sono autorizzate dai venditori. Puoi scegliere uno dei seguenti flussi di lavoro di autorizzazione:
+ [Flusso di lavoro di autorizzazione Selling Partner Appstore](https://developer-docs.amazon.com/sp-api/docs/selling-partner-appstore-authorization-workflow): un flusso di lavoro di OAuth autorizzazione avviato dalla pagina dei dettagli di Selling Partner Appstore.
+ [Flusso di lavoro di autorizzazione del sito Web](https://developer-docs.amazon.com/sp-api/docs/website-authorization-workflow): un flusso di lavoro di OAuth autorizzazione avviato dal tuo sito Web.
+ **Applicazioni pubbliche per fornitori**: queste applicazioni sono disponibili al pubblico e sono autorizzate dai fornitori. È possibile utilizzare il flusso di lavoro di [autorizzazione del sito Web](https://developer-docs.amazon.com/sp-api/docs/website-authorization-workflow). Si tratta di un flusso di lavoro di OAuth autorizzazione avviato dal tuo sito Web.
+ **Applicazioni private per venditori o fornitori**: queste applicazioni sono disponibili solo per la tua organizzazione. Queste possono essere applicazioni per venditori o fornitori. È possibile utilizzare l'approccio di [autoautorizzazione](https://developer-docs.amazon.com/sp-api/docs/self-authorization). Quando crei un'applicazione privata per la tua organizzazione, puoi autorizzarla automaticamente ad accedere alle informazioni del tuo account. Puoi autorizzare automaticamente la tua candidatura in stato di bozza; non c'è motivo di pubblicare una candidatura privata. [Per informazioni sulla revoca dell'autoautorizzazione dalle applicazioni del venditore e del fornitore, consulta Revoca delle autoautorizzazioni nella documentazione SP-API.](https://developer-docs.amazon.com/sp-api/docs/revoke-self-authorizations-from-your-application)
### Autorizza i gruppi di fornitori per l'accesso alle applicazioni
Quando autorizzi la tua applicazione Selling Partner API ad accedere ai tuoi dati, concedi l'accesso al gruppo di fornitori associato alle credenziali di accesso per il tuo account Vendor Central. Per estensione, concedi l'accesso a tutti i codici fornitore presenti nel gruppo di fornitori. Pertanto, è importante utilizzare le credenziali e il gruppo di fornitori corretti di Vendor Central per l'integrazione dell'API Selling Partner.
Il *gruppo di fornitori* è l'account a cui accedi. A seconda degli accordi commerciali, dei modelli operativi e di altri fattori, il gruppo di fornitori può includere uno o più codici fornitore. Ogni *codice fornitore* consente di elencare i prodotti in una categoria specifica oppure include gli accordi commerciali necessari, ad esempio un codice fornitore per una determinata marca.
È possibile [disporre di più autorizzazioni](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access#use-multiple-vendor-groups-to-authorize-an-application) per ogni gruppo di fornitori oppure creare un [unico gruppo di fornitori](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access#use-a-single-vendor-group-to-authorize-an-application) che contenga tutti i codici fornitore. La possibilità di utilizzare più gruppi di fornitori associati al tuo profilo ti dà la possibilità di utilizzare un'applicazione con lo stesso codice fornitore in diversi gruppi di fornitori. Con questa opzione, non è necessario inviare più applicazioni di sviluppo di fornitori per ogni gruppo di fornitori.
Per ulteriori informazioni, consulta [Autorizzare i gruppi di fornitori per l'accesso alle applicazioni](https://developer-docs.amazon.com/sp-api/docs/authorize-vendor-groups-for-application-access) nella documentazione SP-API.
## Connect alla SP-API
Dopo aver registrato e autorizzato la tua applicazione, puoi iniziare a fare richieste. Per ulteriori informazioni, consulta [Connessione all'API Selling Partner](https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api) nella documentazione SP-API.