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

title: msg
description: Registra un mensaje con sus opciones de traducción como una cadena codificada en General Translation Python. Referencia de la API para msg.

---

Registra un mensaje junto con sus opciones de traducción y devuelve una cadena codificada que puede decodificarse más adelante. Úsalo cuando crees un mensaje en un lugar y lo resuelvas en otro.

## Descripción general [#overview]

Llama a `msg` con una cadena de origen y cualquier variable u opción reservada. Si no se pasan argumentos por palabra clave, devuelve el mensaje sin cambios. Con opciones, devuelve una cadena codificada `{interpolated}:{base64options}` que [`m_fallback`](/docs/python/reference/functions/m-fallback), [`decode_msg`](/docs/python/reference/functions/decode-msg) y [`decode_options`](/docs/python/reference/functions/decode-options) pueden leer.

```python
from gt_i18n import msg

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

Firma:

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

Importa `msg` desde `gt_i18n`. No se reexporta en los paquetes del framework.

## Cómo funciona [#how-it-works]

* **Ruta rápida sin opciones.** Cuando `kwargs` está vacío, devuelve `message` sin cambios.
* **Interpolación.** Interpola el mensaje con las variables del usuario (eliminando las keys reservadas) para generar el prefijo legible para humanos.
* **Codificación.** Calcula el hash del mensaje (o reutiliza un `__hash` proporcionado), luego codifica en base64 un payload JSON de opciones que incluye todos los `kwargs`, además de `__source` y `__hash`, y devuelve `"{interpolated}:{encoded}"`.
* **Tolerancia a errores.** Si la interpolación falla, devuelve el mensaje original.

## Parámetros [#parameters]

| Parámetro             | Descripción                                                                               | Tipo         | Opcional | Predeterminado |
| --------------------- | ----------------------------------------------------------------------------------------- | ------------ | -------- | -------------- |
| [`message`](#message) | La cadena de origen de ICU MessageFormat.                                                    | `str`        | No       | —              |
| [`kwargs`](#kwargs)   | Variables de interpolación y opciones reservadas de GT (`_context`, `_id`, `_max_chars`). | keyword args | Sí       | —              |

### `message` [#message]

**Tipo** `str` · **Obligatorio**

La cadena de origen de ICU MessageFormat que se va a registrar.

### `kwargs` [#kwargs]

**Tipo** argumentos por palabra clave · **Opcional**

Variables de interpolación y las opciones reservadas `_context`, `_id` y `_max_chars`, que se integran en el hash. Todas las claves se conservan en el payload codificado.

## Devuelve [#returns]

**Tipo** `str`

El mensaje, sin cambios, cuando no se proporcionan opciones; en caso contrario, una cadena codificada `{interpolated}:{base64options}`.

## Ejemplo [#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": "..."}
```