# General Translation Integrations: Impostazioni di connessione
URL: https://generaltranslation.com/it/docs/integrations/storyblok/reference/connection.mdx
---

title: Impostazioni di connessione
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 usate per collegare uno space Storyblok a General Translation. Le inserisci una sola volta nella finestra di dialogo **Connetti** in **Progetto > Integrazioni**; General Translation le salva nel Progetto 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 — sono memorizzate nel Progetto che le ha connesse. Ogni Progetto collega il proprio space di Storyblok; le credenziali non sono condivise tra i vari Progetti. Restano memorizzate finché l'integrazione non viene scollegata.

## Limitazioni per piano e permessi [#gating]

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

* **Permesso:** `project:write` sul Progetto.
* **Funzionalità del piano:** la funzionalità `project_integrations` nel piano del Progetto.

Quando la funzionalità del piano non è disponibile, la Dashboard mostra una richiesta di upgrade (con il piano richiesto) al posto del catalogo delle integrazioni, quindi l'azione **Connect** non è accessibile. Senza `project:write`, l'azione **Connect** non è disponibile. La limitazione `project_integrations` si applica anche all'esecuzione delle traduzioni; le azioni del server per la connessione e la traduzione restituiscono l'errore "Le integrazioni non sono disponibili nel tuo piano attuale." quando la funzionalità non è disponibile.