Actualizar la traducción en un lienzo

Utilice este punto final para actualizar varias traducciones de un lienzo.

Requisitos previos

Para utilizar este punto final, necesitarás una clave de API con el permiso canvas.translations.update.

Límite de velocidad

Este punto final tiene un límite de velocidad de 250 000 solicitudes por hora.

Parámetros de la ruta

No hay parámetros de ruta para este punto final.

Parámetros de la solicitud

Ten en cuenta que todos los ID de traducción se consideran identificadores únicos universales (UUID), que puedes encontrar en la configuración de Soporte multilingüe o en la respuesta de la solicitud GET.

Ejemplo de solicitud

1
2
3
4
5
6
7
8
9
10
11
12
13
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
    "canvas_id": "9a0ba932-11c0-4c33-b529-e79aafc12409",
    "message_variation_id": "f5896eec-847d-4c0d-a4b6-7695e67520d7",
    "locale_id": "3fa10d31-83ae-4ff4-9631-f52cea9ec8fa",
    "translation_map": {
        "id_4": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca.",
        "subject_1": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca.",
        "id_1": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca.",
        "image": "¿Dónde está la biblioteca? Me llamo T-Bone, La araña discoteca."
    }
}

Ejemplo de respuesta positiva

1
2
3
{
	"message": "success"
}

Ejemplo de respuesta de error

El código de estado 400 podría devolver el siguiente cuerpo de respuesta. Consulte la sección Solución de problemas para obtener más información sobre los errores que puede encontrar.

1
2
3
4
5
6
7
{
	"errors": [
		{
			"message": "Something went wrong. Translation IDs are mismatched or translated text exceeds limits."
		}
	]
}

Solución de problemas

La siguiente tabla enumera los posibles errores devueltos y los pasos asociados para solucionarlos.

1
2
3
4
5
6
7
8
9
10
      INVALID_CAMPAIGN_ID = "Invalid campaign or step ID"
      INVALID_LOCALE_ID = "Invalid locale ID"
      INVALID_MESSAGE_VARIATION_ID = "Invalid message ID"
      INVALID_TRANSLATION_OBJECT = "Invalid translation object"
      MESSAGE_NOT_FOUND = "Message not found"
      LOCALE_NOT_FOUND = "Locale not found"
      MISSING_TRANSLATIONS = "Missing translations from the request body"
      MULTI_LANGUAGE_NOT_ENABLED = "Multi-language feature is not enabled on this company"
      MULTI_LANGUAGE_NOT_ENABLED_ON_MESSAGE = "This message does not have multi-language setup"
      UNSUPPORTED_CHANNEL = "This message type does not support multi-language"