# General Translation Python SDKs: msg
URL: https://generaltranslation.com/it/docs/python/reference/functions/msg.mdx
---

title: msg
description: Registra un messaggio con le relative opzioni di traduzione come stringa codificata in General Translation Python. Riferimento API per msg.

---

Registra un messaggio insieme alle relative opzioni di traduzione e restituisce una stringa codificata che può essere decodificata in un secondo momento. Usalo quando definisci un messaggio in un punto e lo utilizzi in un altro.

## Panoramica [#overview]

Chiama `msg` con una stringa sorgente e con eventuali variabili o opzioni riservate. Senza argomenti keyword, restituisce il messaggio invariato. Con le opzioni, restituisce una stringa codificata `{interpolated}:{base64options}` che [`m_fallback`](/docs/python/reference/functions/m-fallback), [`decode_msg`](/docs/python/reference/functions/decode-msg) e [`decode_options`](/docs/python/reference/functions/decode-options) possono leggere.

```python
from gt_i18n import msg

msg("Save", _context="button")
```

Sintassi:

```python
msg(message: str, **kwargs: object) -> str
```

Importa `msg` da `gt_i18n`. Non è riesportato dai pacchetti del framework.

## Come funziona [#how-it-works]

* **Scorciatoia senza opzioni.** Quando `kwargs` è vuoto, restituisce `message` invariato.
* **Interpolazione.** Interpola il messaggio con le variabili dell'utente (rimuovendo le chiavi riservate) per il prefisso leggibile dall'uomo.
* **Codifica.** Calcola l'hash del messaggio (o riutilizza un `__hash` passato), quindi codifica in base64 un payload JSON delle opzioni che include tutti i `kwargs` più `__source` e `__hash`, e restituisce `"{interpolated}:{encoded}"`.
* **Gestione sicura degli errori.** Se l'interpolazione non riesce, restituisce il messaggio originale.

## Parametri [#parameters]

| Parametro             | Descrizione                                                                           | Tipo               | Facoltativo | Predefinito |
| --------------------- | ------------------------------------------------------------------------------------- | ------------------ | ----------- | ----------- |
| [`message`](#message) | La stringa sorgente in formato ICU MessageFormat.                                     | `str`              | No          | —           |
| [`kwargs`](#kwargs)   | Variabili di interpolazione e opzioni GT riservate (`_context`, `_id`, `_max_chars`). | argomenti con nome | Sì          | —           |

### `message` [#message]

**Tipo** `str` · **Obbligatorio**

La stringa sorgente in formato ICU MessageFormat da registrare.

### `kwargs` [#kwargs]

**Type** argomenti con nome · **Opzionale**

Variabili di interpolazione e opzioni riservate `_context`, `_id` e `_max_chars`, incluse nell'hash. Tutte le chiavi vengono mantenute nel payload codificato.

## Restituisce [#returns]

**Tipo** `str`

Il messaggio invariato se non vengono fornite opzioni; altrimenti, una stringa codificata `{interpolated}:{base64options}`.

## Esempio [#example]

```python
from gt_i18n import msg, decode_msg, decode_options

encoded = msg("Hi, {name}!", name="Bob", _id="greet")
decode_msg(encoded)      # "Hi, Bob!"
decode_options(encoded)  # {"name": "Bob", "_id": "greet", "__source": "Hi, {name}!", "__hash": "..."}
```