blob: 0f8750450d1082ca390e5d086375d1022a3f541c [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -04001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040075<h1><a href="translate_v2.html">Google Cloud Translation API</a> . <a href="translate_v2.translations.html">translations</a></h1>
John Asmuth614db982014-04-24 15:46:26 -040076<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080081 <code><a href="#list">list(q, target, cid=None, format=None, model=None, source=None, x__xgafv=None)</a></code></p>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040082<p class="firstline">Translates input text, returning translated text.</p>
83<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070084 <code><a href="#translate">translate(body=None, x__xgafv=None)</a></code></p>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040085<p class="firstline">Translates input text, returning translated text.</p>
John Asmuth614db982014-04-24 15:46:26 -040086<h3>Method Details</h3>
87<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070088 <code class="details" id="close">close()</code>
89 <pre>Close httplib2 connections.</pre>
90</div>
91
92<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080093 <code class="details" id="list">list(q, target, cid=None, format=None, model=None, source=None, x__xgafv=None)</code>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040094 <pre>Translates input text, returning translated text.
John Asmuth614db982014-04-24 15:46:26 -040095
96Args:
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040097 q: string, The input text to translate. Repeat this parameter to perform translation
98operations on multiple text inputs. (required) (repeated)
99 target: string, The language to use for translation of the input text, set to one of the
100language codes listed in Language Support. (required)
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800101 cid: string, The customization id for translate (repeated)
102 format: string, The format of the source text, in either HTML (default) or plain-text. A
103value of &quot;html&quot; indicates HTML and a value of &quot;text&quot; indicates plain-text.
104 Allowed values
105 html - Specifies the input is in HTML
106 text - Specifies the input is in plain textual format
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800107 model: string, The `model` type requested for this translation. Valid values are
108listed in public documentation.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800109 source: string, The language of the source text, set to one of the language codes listed in
110Language Support. If the source language is not specified, the API will
111attempt to identify the source language automatically and return it within
112the response.
Bu Sun Kim65020912020-05-20 12:08:20 -0700113 x__xgafv: string, V1 error format.
114 Allowed values
115 1 - v1 error format
116 2 - v2 error format
John Asmuth614db982014-04-24 15:46:26 -0400117
118Returns:
119 An object of the form:
120
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400121 { # The main language translation response message.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800122 &quot;translations&quot;: [ # Translations contains list of translation results of given text
123 {
124 &quot;detectedSourceLanguage&quot;: &quot;A String&quot;, # The source language of the initial request, detected automatically, if
125 # no source language was passed within the initial request. If the
126 # source language was passed, auto-detection of the language will not
127 # occur and this field will be empty.
128 &quot;model&quot;: &quot;A String&quot;, # The `model` type used for this translation. Valid values are
129 # listed in public documentation. Can be different from requested `model`.
130 # Present only if specific model type was explicitly requested.
131 &quot;translatedText&quot;: &quot;A String&quot;, # Text translated into the target language.
132 },
133 ],
134}</pre>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400135</div>
136
137<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700138 <code class="details" id="translate">translate(body=None, x__xgafv=None)</code>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400139 <pre>Translates input text, returning translated text.
140
141Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700142 body: object, The request body.
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400143 The object takes the form of:
144
145{ # The main translation request message for the Cloud Translation API.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800146 &quot;format&quot;: &quot;A String&quot;, # The format of the source text, in either HTML (default) or plain-text. A
147 # value of &quot;html&quot; indicates HTML and a value of &quot;text&quot; indicates plain-text.
148 &quot;model&quot;: &quot;A String&quot;, # The `model` type requested for this translation. Valid values are
149 # listed in public documentation.
150 &quot;q&quot;: [ # The input text to translate. Repeat this parameter to perform translation
151 # operations on multiple text inputs.
152 &quot;A String&quot;,
153 ],
154 &quot;source&quot;: &quot;A String&quot;, # The language of the source text, set to one of the language codes listed in
155 # Language Support. If the source language is not specified, the API will
156 # attempt to identify the source language automatically and return it within
157 # the response.
158 &quot;target&quot;: &quot;A String&quot;, # The language to use for translation of the input text, set to one of the
159 # language codes listed in Language Support.
160}
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400161
162 x__xgafv: string, V1 error format.
163 Allowed values
164 1 - v1 error format
165 2 - v2 error format
166
167Returns:
168 An object of the form:
169
170 { # The main language translation response message.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800171 &quot;translations&quot;: [ # Translations contains list of translation results of given text
172 {
173 &quot;detectedSourceLanguage&quot;: &quot;A String&quot;, # The source language of the initial request, detected automatically, if
174 # no source language was passed within the initial request. If the
175 # source language was passed, auto-detection of the language will not
176 # occur and this field will be empty.
177 &quot;model&quot;: &quot;A String&quot;, # The `model` type used for this translation. Valid values are
178 # listed in public documentation. Can be different from requested `model`.
179 # Present only if specific model type was explicitly requested.
180 &quot;translatedText&quot;: &quot;A String&quot;, # Text translated into the target language.
181 },
182 ],
183}</pre>
John Asmuth614db982014-04-24 15:46:26 -0400184</div>
185
186</body></html>