Home › Methods › Messages › TranslateText
Layer 220

MessagesTranslateText

Translate a given text.

method Users
messages.translateText#63183030 flags:# peer:flags.0?InputPeer id:flags.0?Vector<int> text:flags.1?Vector<TextWithEntities> to_lang:string = messages.TranslatedText;

Parameters

Name Type Description
Flags # Flags, see TL conditional fields
Peer flags.0?InputPeer If the text is a chat message, the peer ID
Id Vector<int> A list of message IDs to translate
Text Vector<TextWithEntities> A list of styled messages to translate
ToLang string Two-letter ISO 639-1 language code of the language to which the message is translated

Returns

messages.TranslatedText

Possible Errors

Code Type Description
400 INPUT_TEXT_EMPTY The specified text is empty.
400 INPUT_TEXT_TOO_LONG The specified text is too long.
400 MSG_ID_INVALID Invalid message ID provided.
400 PEER_ID_INVALID The provided peer id is invalid.
400 TO_LANG_INVALID The specified destination language is invalid.
500 TRANSLATE_REQ_FAILED Translation failed, please try again later.
400 TRANSLATE_REQ_QUOTA_EXCEEDED Translation is currently unavailable due to a temporary server-side lack of resources.
406 TRANSLATIONS_DISABLED Translations are unavailable, a detailed and localized description for the error will be emitted via an update Service Notification as specified here.
500 TRANSLATION_TIMEOUT A timeout occurred while translating the specified text.

Gogram Example

// MessagesTranslateText - using Params struct
result, err := client.MessagesTranslateText(&tg.MessagesTranslateTextParams{
    ToLang: "...",

    // Optional fields:
    // Peer: &tg.InputPeerUser{UserID: int64(123456789)},
    // Id: []int{},
    // Text: []tg.TextWithEntities{&tg.TextWithEntities{}},
})
if err != nil {
    // handle error
}
// result is *tg.MessagesTranslatedText