# General Translation Integrations: Impostazioni di connessione
URL: https://generaltranslation.com/it/docs/integrations/storyblok/reference/connection.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Riferimento per le impostazioni usate per collegare uno space Storyblok a General Translation. Riferimento API per le impostazioni di connessione di Storyblok.

Le impostazioni di connessione vengono inserite una sola volta da **Progetto > Integrazioni > Catalogo**. General Translation le salva in una connessione dell'Organizzazione e le usa per chiamare la Storyblok Management API.

## Panoramica [#overview]

| Impostazione                                | Descrizione                                     | Tipo                             | Facoltativo | Predefinito |
| ------------------------------------------- | ----------------------------------------------- | -------------------------------- | ----------- | ----------- |
| [ID dello space](#space-id)                 | L'ID numerico dello space di Storyblok.     | `string`                         | No          | —           |
| [Regione](#region)                          | La regione in cui è ospitato lo space.          | `eu` | `us` | `ca` | `ap` | `cn` | No          | `eu`        |
| [Token di accesso personale](#access-token) | Un token dell'API di gestione di Storyblok. | `string`                         | No          | —           |

Per la connessione è inoltre necessario soddisfare i [requisiti relativi al piano e ai permessi](#gating) riportati di seguito.

## Space ID [#space-id]

**Tipo** `string` · **Obbligatorio**

L'ID numerico dello space di Storyblok, visibile in Storyblok in **Impostazioni > Generali**. Va inserito nel campo **Space ID**, che accetta valori numerici. L'eventuale `#` iniziale viene rimossa e gli spazi iniziali e finali vengono eliminati prima del salvataggio del valore.

Lo space ID viene archiviato sia come identificatore della risorsa dell'integrazione sia all'interno delle credenziali. Un'esecuzione di traduzione non riesce se lo space ID nelle credenziali non corrisponde a quello dell'integrazione connessa.

## Regione [#region]

**Type** `eu` | `us` | `ca` | `ap` | `cn` · **Obbligatorio** · **Predefinito** `eu`

La regione in cui è ospitato il tuo space Storyblok. Viene selezionata nel campo **Regione**, che offre **EU**, **US**, **CA**, **AP** e **CN**. La regione determina quale URL di base della Storyblok Management API utilizza l'integrazione:

| Regione | URL di base della Management API   |
| ------- | ---------------------------------- |
| `eu`    | `https://mapi.storyblok.com/v1`    |
| `us`    | `https://api-us.storyblok.com/v1`  |
| `ca`    | `https://api-ca.storyblok.com/v1`  |
| `ap`    | `https://api-ap.storyblok.com/v1`  |
| `cn`    | `https://app.storyblokchina.cn/v1` |

Se la regione non è riconosciuta, la connessione viene rifiutata.

## Token di accesso personale [#access-token]

**Type** `string` · **Obbligatorio**

Un token di accesso personale di Storyblok (un token della Management API), creato in Storyblok alla voce **My account > Personal access tokens**. Va inserito nel campo **Personal access token**, il cui valore è mascherato.

Il token viene inviato come header `Authorization` in ogni richiesta alla Management API effettuata dall'integrazione. Deve avere accesso alle story e ai componenti dello space, perché l'integrazione legge le story, ne legge e aggiorna il contenuto e (per [Abilitazione automatica dei campi supportati](/docs/integrations/storyblok/guides/translating-content#auto-enable)) legge e aggiorna gli schema dei componenti.

## Archiviazione [#storage]

Le credenziali — l'ID dello space, la regione e il token di accesso personale — vengono memorizzate una sola volta in una connessione dell'Organizzazione associata allo space di Storyblok. L'integrazione del progetto si collega a questa connessione. La voce della connessione è visibile in **Organizzazione > Connessioni**.

## Requisito relativo al piano e al permesso [#gating]

Per collegare un'integrazione Storyblok sono necessari entrambi i seguenti elementi:

* **Permesso:** `project:write` sul progetto.
* **Piano:** Starter o Enterprise.

Senza un piano supportato, la Dashboard mostra una richiesta di upgrade al posto del catalogo delle integrazioni, quindi l'azione **Connect** non è accessibile. Senza `project:write`, l'azione **Connect** non è disponibile. L'esecuzione delle traduzioni richiede inoltre `translations:content:write` e la stessa funzionalità del piano; le azioni di connessione e traduzione rifiutano le richieste provenienti da piani non supportati.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.