1// Code generated by smithy-go-codegen DO NOT EDIT.
2
3package translate
4
5import (
6	"context"
7	awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware"
8	"github.com/aws/aws-sdk-go-v2/aws/signer/v4"
9	"github.com/aws/aws-sdk-go-v2/service/translate/types"
10	"github.com/aws/smithy-go/middleware"
11	smithyhttp "github.com/aws/smithy-go/transport/http"
12)
13
14// Translates input text from the source language to the target language. For a
15// list of available languages and language codes, see what-is-languages.
16func (c *Client) TranslateText(ctx context.Context, params *TranslateTextInput, optFns ...func(*Options)) (*TranslateTextOutput, error) {
17	if params == nil {
18		params = &TranslateTextInput{}
19	}
20
21	result, metadata, err := c.invokeOperation(ctx, "TranslateText", params, optFns, addOperationTranslateTextMiddlewares)
22	if err != nil {
23		return nil, err
24	}
25
26	out := result.(*TranslateTextOutput)
27	out.ResultMetadata = metadata
28	return out, nil
29}
30
31type TranslateTextInput struct {
32
33	// The language code for the language of the source text. The language must be a
34	// language supported by Amazon Translate. For a list of language codes, see
35	// what-is-languages. To have Amazon Translate determine the source language of
36	// your text, you can specify auto in the SourceLanguageCode field. If you specify
37	// auto, Amazon Translate will call Amazon Comprehend
38	// (https://docs.aws.amazon.com/comprehend/latest/dg/comprehend-general.html) to
39	// determine the source language.
40	//
41	// This member is required.
42	SourceLanguageCode *string
43
44	// The language code requested for the language of the target text. The language
45	// must be a language supported by Amazon Translate.
46	//
47	// This member is required.
48	TargetLanguageCode *string
49
50	// The text to translate. The text string can be a maximum of 5,000 bytes long.
51	// Depending on your character set, this may be fewer than 5,000 characters.
52	//
53	// This member is required.
54	Text *string
55
56	// The name of the terminology list file to be used in the TranslateText request.
57	// You can use 1 terminology list at most in a TranslateText request. Terminology
58	// lists can contain a maximum of 256 terms.
59	TerminologyNames []string
60}
61
62type TranslateTextOutput struct {
63
64	// The language code for the language of the source text.
65	//
66	// This member is required.
67	SourceLanguageCode *string
68
69	// The language code for the language of the target text.
70	//
71	// This member is required.
72	TargetLanguageCode *string
73
74	// The translated text.
75	//
76	// This member is required.
77	TranslatedText *string
78
79	// The names of the custom terminologies applied to the input text by Amazon
80	// Translate for the translated text response.
81	AppliedTerminologies []types.AppliedTerminology
82
83	// Metadata pertaining to the operation's result.
84	ResultMetadata middleware.Metadata
85}
86
87func addOperationTranslateTextMiddlewares(stack *middleware.Stack, options Options) (err error) {
88	err = stack.Serialize.Add(&awsAwsjson11_serializeOpTranslateText{}, middleware.After)
89	if err != nil {
90		return err
91	}
92	err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpTranslateText{}, middleware.After)
93	if err != nil {
94		return err
95	}
96	if err = addSetLoggerMiddleware(stack, options); err != nil {
97		return err
98	}
99	if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil {
100		return err
101	}
102	if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil {
103		return err
104	}
105	if err = addResolveEndpointMiddleware(stack, options); err != nil {
106		return err
107	}
108	if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil {
109		return err
110	}
111	if err = addRetryMiddlewares(stack, options); err != nil {
112		return err
113	}
114	if err = addHTTPSignerV4Middleware(stack, options); err != nil {
115		return err
116	}
117	if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil {
118		return err
119	}
120	if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil {
121		return err
122	}
123	if err = addClientUserAgent(stack); err != nil {
124		return err
125	}
126	if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil {
127		return err
128	}
129	if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil {
130		return err
131	}
132	if err = addOpTranslateTextValidationMiddleware(stack); err != nil {
133		return err
134	}
135	if err = stack.Initialize.Add(newServiceMetadataMiddleware_opTranslateText(options.Region), middleware.Before); err != nil {
136		return err
137	}
138	if err = addRequestIDRetrieverMiddleware(stack); err != nil {
139		return err
140	}
141	if err = addResponseErrorMiddleware(stack); err != nil {
142		return err
143	}
144	if err = addRequestResponseLogging(stack, options); err != nil {
145		return err
146	}
147	return nil
148}
149
150func newServiceMetadataMiddleware_opTranslateText(region string) *awsmiddleware.RegisterServiceMetadata {
151	return &awsmiddleware.RegisterServiceMetadata{
152		Region:        region,
153		ServiceID:     ServiceID,
154		SigningName:   "translate",
155		OperationName: "TranslateText",
156	}
157}
158