blob: 5b7a59c54be79cf32b7650d85c36b83b53bf1d4d [file] [log] [blame]
Bu Sun Kim65020912020-05-20 12:08:20 -07001<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
75<h1><a href="dialogflow_v2beta1.html">Dialogflow API</a> . <a href="dialogflow_v2beta1.projects.html">projects</a> . <a href="dialogflow_v2beta1.projects.locations.html">locations</a> . <a href="dialogflow_v2beta1.projects.locations.agent.html">agent</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="dialogflow_v2beta1.projects.locations.agent.entityTypes.html">entityTypes()</a></code>
79</p>
80<p class="firstline">Returns the entityTypes Resource.</p>
81
82<p class="toc_element">
83 <code><a href="dialogflow_v2beta1.projects.locations.agent.environments.html">environments()</a></code>
84</p>
85<p class="firstline">Returns the environments Resource.</p>
86
87<p class="toc_element">
88 <code><a href="dialogflow_v2beta1.projects.locations.agent.intents.html">intents()</a></code>
89</p>
90<p class="firstline">Returns the intents Resource.</p>
91
92<p class="toc_element">
93 <code><a href="dialogflow_v2beta1.projects.locations.agent.sessions.html">sessions()</a></code>
94</p>
95<p class="firstline">Returns the sessions Resource.</p>
96
97<p class="toc_element">
98 <code><a href="#export">export(parent, body=None, x__xgafv=None)</a></code></p>
99<p class="firstline">Exports the specified agent to a ZIP file.</p>
100<p class="toc_element">
101 <code><a href="#fulfillment">fulfillment(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
102<p class="firstline">Updates the fulfillment.</p>
103<p class="toc_element">
104 <code><a href="#getFulfillment">getFulfillment(name, x__xgafv=None)</a></code></p>
105<p class="firstline">Retrieves the fulfillment.</p>
106<p class="toc_element">
107 <code><a href="#import_">import_(parent, body=None, x__xgafv=None)</a></code></p>
108<p class="firstline">Imports the specified agent from a ZIP file.</p>
109<p class="toc_element">
110 <code><a href="#restore">restore(parent, body=None, x__xgafv=None)</a></code></p>
111<p class="firstline">Restores the specified agent from a ZIP file.</p>
112<p class="toc_element">
113 <code><a href="#train">train(parent, body=None, x__xgafv=None)</a></code></p>
114<p class="firstline">Trains the specified agent.</p>
115<h3>Method Details</h3>
116<div class="method">
117 <code class="details" id="export">export(parent, body=None, x__xgafv=None)</code>
118 <pre>Exports the specified agent to a ZIP file.
119
120
121Operation &lt;response: ExportAgentResponse&gt;
122
123Args:
124 parent: string, Required. The project that the agent to export is associated with.
125Format: `projects/&lt;Project ID&gt;`. (required)
126 body: object, The request body.
127 The object takes the form of:
128
129{ # The request message for Agents.ExportAgent.
130 &quot;agentUri&quot;: &quot;A String&quot;, # Optional. The
131 # [Google Cloud Storage](https://cloud.google.com/storage/docs/)
132 # URI to export the agent to.
133 # The format of this URI must be `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
134 # If left unspecified, the serialized agent is returned inline.
135 }
136
137 x__xgafv: string, V1 error format.
138 Allowed values
139 1 - v1 error format
140 2 - v2 error format
141
142Returns:
143 An object of the form:
144
145 { # This resource represents a long-running operation that is the result of a
146 # network API call.
147 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
148 # contains progress information and common metadata such as create time.
149 # Some services might not provide such metadata. Any method that returns a
150 # long-running operation should document the metadata type, if any.
151 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
152 },
153 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
154 # If `true`, the operation is completed, and either `error` or `response` is
155 # available.
156 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
157 # method returns no data on success, such as `Delete`, the response is
158 # `google.protobuf.Empty`. If the original method is standard
159 # `Get`/`Create`/`Update`, the response should be the resource. For other
160 # methods, the response should have the type `XxxResponse`, where `Xxx`
161 # is the original method name. For example, if the original method name
162 # is `TakeSnapshot()`, the inferred response type is
163 # `TakeSnapshotResponse`.
164 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
165 },
166 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
167 # originally returns it. If you use the default HTTP mapping, the
168 # `name` should be a resource name ending with `operations/{unique_id}`.
169 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
170 # different programming environments, including REST APIs and RPC APIs. It is
171 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
172 # three pieces of data: error code, error message, and error details.
173 #
174 # You can find out more about this error model and how to work with it in the
175 # [API Design Guide](https://cloud.google.com/apis/design/errors).
176 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
177 # message types for APIs to use.
178 {
179 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
180 },
181 ],
182 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
183 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
184 # user-facing error message should be localized and sent in the
185 # google.rpc.Status.details field, or localized by the client.
186 },
187 }</pre>
188</div>
189
190<div class="method">
191 <code class="details" id="fulfillment">fulfillment(name, body=None, updateMask=None, x__xgafv=None)</code>
192 <pre>Updates the fulfillment.
193
194Args:
195 name: string, Required. The unique identifier of the fulfillment.
196Format: `projects/&lt;Project ID&gt;/agent/fulfillment`. (required)
197 body: object, The request body.
198 The object takes the form of:
199
200{ # Represents a fulfillment.
201 &quot;genericWebService&quot;: { # Represents configuration for a generic web service. # Configuration for a generic web service.
202 # Dialogflow supports two mechanisms for authentications:
203 # - Basic authentication with username and password.
204 # - Authentication with additional authentication headers.
205 # More information could be found at:
206 # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
207 &quot;uri&quot;: &quot;A String&quot;, # Required. The fulfillment URI for receiving POST requests.
208 # It must use https protocol.
209 &quot;password&quot;: &quot;A String&quot;, # Optional. The password for HTTP Basic authentication.
210 &quot;isCloudFunction&quot;: True or False, # Optional. Indicates if generic web service is created through Cloud Functions
211 # integration. Defaults to false.
212 &quot;username&quot;: &quot;A String&quot;, # Optional. The user name for HTTP Basic authentication.
213 &quot;requestHeaders&quot;: { # Optional. The HTTP request headers to send together with fulfillment requests.
214 &quot;a_key&quot;: &quot;A String&quot;,
215 },
216 },
217 &quot;features&quot;: [ # Optional. The field defines whether the fulfillment is enabled for certain features.
218 { # Whether fulfillment is enabled for the specific feature.
219 &quot;type&quot;: &quot;A String&quot;, # The type of the feature that enabled for fulfillment.
220 },
221 ],
222 &quot;name&quot;: &quot;A String&quot;, # Required. The unique identifier of the fulfillment.
223 # Format: `projects/&lt;Project ID&gt;/agent/fulfillment`.
224 &quot;displayName&quot;: &quot;A String&quot;, # Optional. The human-readable name of the fulfillment, unique within the agent.
225 &quot;enabled&quot;: True or False, # Optional. Whether fulfillment is enabled.
226}
227
228 updateMask: string, Required. The mask to control which fields get updated. If the mask is not
229present, all fields will be updated.
230 x__xgafv: string, V1 error format.
231 Allowed values
232 1 - v1 error format
233 2 - v2 error format
234
235Returns:
236 An object of the form:
237
238 { # Represents a fulfillment.
239 &quot;genericWebService&quot;: { # Represents configuration for a generic web service. # Configuration for a generic web service.
240 # Dialogflow supports two mechanisms for authentications:
241 # - Basic authentication with username and password.
242 # - Authentication with additional authentication headers.
243 # More information could be found at:
244 # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
245 &quot;uri&quot;: &quot;A String&quot;, # Required. The fulfillment URI for receiving POST requests.
246 # It must use https protocol.
247 &quot;password&quot;: &quot;A String&quot;, # Optional. The password for HTTP Basic authentication.
248 &quot;isCloudFunction&quot;: True or False, # Optional. Indicates if generic web service is created through Cloud Functions
249 # integration. Defaults to false.
250 &quot;username&quot;: &quot;A String&quot;, # Optional. The user name for HTTP Basic authentication.
251 &quot;requestHeaders&quot;: { # Optional. The HTTP request headers to send together with fulfillment requests.
252 &quot;a_key&quot;: &quot;A String&quot;,
253 },
254 },
255 &quot;features&quot;: [ # Optional. The field defines whether the fulfillment is enabled for certain features.
256 { # Whether fulfillment is enabled for the specific feature.
257 &quot;type&quot;: &quot;A String&quot;, # The type of the feature that enabled for fulfillment.
258 },
259 ],
260 &quot;name&quot;: &quot;A String&quot;, # Required. The unique identifier of the fulfillment.
261 # Format: `projects/&lt;Project ID&gt;/agent/fulfillment`.
262 &quot;displayName&quot;: &quot;A String&quot;, # Optional. The human-readable name of the fulfillment, unique within the agent.
263 &quot;enabled&quot;: True or False, # Optional. Whether fulfillment is enabled.
264 }</pre>
265</div>
266
267<div class="method">
268 <code class="details" id="getFulfillment">getFulfillment(name, x__xgafv=None)</code>
269 <pre>Retrieves the fulfillment.
270
271Args:
272 name: string, Required. The name of the fulfillment.
273Format: `projects/&lt;Project ID&gt;/agent/fulfillment`. (required)
274 x__xgafv: string, V1 error format.
275 Allowed values
276 1 - v1 error format
277 2 - v2 error format
278
279Returns:
280 An object of the form:
281
282 { # Represents a fulfillment.
283 &quot;genericWebService&quot;: { # Represents configuration for a generic web service. # Configuration for a generic web service.
284 # Dialogflow supports two mechanisms for authentications:
285 # - Basic authentication with username and password.
286 # - Authentication with additional authentication headers.
287 # More information could be found at:
288 # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
289 &quot;uri&quot;: &quot;A String&quot;, # Required. The fulfillment URI for receiving POST requests.
290 # It must use https protocol.
291 &quot;password&quot;: &quot;A String&quot;, # Optional. The password for HTTP Basic authentication.
292 &quot;isCloudFunction&quot;: True or False, # Optional. Indicates if generic web service is created through Cloud Functions
293 # integration. Defaults to false.
294 &quot;username&quot;: &quot;A String&quot;, # Optional. The user name for HTTP Basic authentication.
295 &quot;requestHeaders&quot;: { # Optional. The HTTP request headers to send together with fulfillment requests.
296 &quot;a_key&quot;: &quot;A String&quot;,
297 },
298 },
299 &quot;features&quot;: [ # Optional. The field defines whether the fulfillment is enabled for certain features.
300 { # Whether fulfillment is enabled for the specific feature.
301 &quot;type&quot;: &quot;A String&quot;, # The type of the feature that enabled for fulfillment.
302 },
303 ],
304 &quot;name&quot;: &quot;A String&quot;, # Required. The unique identifier of the fulfillment.
305 # Format: `projects/&lt;Project ID&gt;/agent/fulfillment`.
306 &quot;displayName&quot;: &quot;A String&quot;, # Optional. The human-readable name of the fulfillment, unique within the agent.
307 &quot;enabled&quot;: True or False, # Optional. Whether fulfillment is enabled.
308 }</pre>
309</div>
310
311<div class="method">
312 <code class="details" id="import_">import_(parent, body=None, x__xgafv=None)</code>
313 <pre>Imports the specified agent from a ZIP file.
314
315Uploads new intents and entity types without deleting the existing ones.
316Intents and entity types with the same name are replaced with the new
317versions from ImportAgentRequest.
318
319
320Operation &lt;response: google.protobuf.Empty&gt;
321
322Args:
323 parent: string, Required. The project that the agent to import is associated with.
324Format: `projects/&lt;Project ID&gt;`. (required)
325 body: object, The request body.
326 The object takes the form of:
327
328{ # The request message for Agents.ImportAgent.
329 &quot;agentContent&quot;: &quot;A String&quot;, # Zip compressed raw byte content for agent.
330 &quot;agentUri&quot;: &quot;A String&quot;, # The URI to a Google Cloud Storage file containing the agent to import.
331 # Note: The URI must start with &quot;gs://&quot;.
332 }
333
334 x__xgafv: string, V1 error format.
335 Allowed values
336 1 - v1 error format
337 2 - v2 error format
338
339Returns:
340 An object of the form:
341
342 { # This resource represents a long-running operation that is the result of a
343 # network API call.
344 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
345 # contains progress information and common metadata such as create time.
346 # Some services might not provide such metadata. Any method that returns a
347 # long-running operation should document the metadata type, if any.
348 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
349 },
350 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
351 # If `true`, the operation is completed, and either `error` or `response` is
352 # available.
353 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
354 # method returns no data on success, such as `Delete`, the response is
355 # `google.protobuf.Empty`. If the original method is standard
356 # `Get`/`Create`/`Update`, the response should be the resource. For other
357 # methods, the response should have the type `XxxResponse`, where `Xxx`
358 # is the original method name. For example, if the original method name
359 # is `TakeSnapshot()`, the inferred response type is
360 # `TakeSnapshotResponse`.
361 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
362 },
363 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
364 # originally returns it. If you use the default HTTP mapping, the
365 # `name` should be a resource name ending with `operations/{unique_id}`.
366 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
367 # different programming environments, including REST APIs and RPC APIs. It is
368 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
369 # three pieces of data: error code, error message, and error details.
370 #
371 # You can find out more about this error model and how to work with it in the
372 # [API Design Guide](https://cloud.google.com/apis/design/errors).
373 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
374 # message types for APIs to use.
375 {
376 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
377 },
378 ],
379 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
380 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
381 # user-facing error message should be localized and sent in the
382 # google.rpc.Status.details field, or localized by the client.
383 },
384 }</pre>
385</div>
386
387<div class="method">
388 <code class="details" id="restore">restore(parent, body=None, x__xgafv=None)</code>
389 <pre>Restores the specified agent from a ZIP file.
390
391Replaces the current agent version with a new one. All the intents and
392entity types in the older version are deleted.
393
394
395Operation &lt;response: google.protobuf.Empty&gt;
396
397Args:
398 parent: string, Required. The project that the agent to restore is associated with.
399Format: `projects/&lt;Project ID&gt;`. (required)
400 body: object, The request body.
401 The object takes the form of:
402
403{ # The request message for Agents.RestoreAgent.
404 &quot;agentUri&quot;: &quot;A String&quot;, # The URI to a Google Cloud Storage file containing the agent to restore.
405 # Note: The URI must start with &quot;gs://&quot;.
406 &quot;agentContent&quot;: &quot;A String&quot;, # Zip compressed raw byte content for agent.
407 }
408
409 x__xgafv: string, V1 error format.
410 Allowed values
411 1 - v1 error format
412 2 - v2 error format
413
414Returns:
415 An object of the form:
416
417 { # This resource represents a long-running operation that is the result of a
418 # network API call.
419 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
420 # contains progress information and common metadata such as create time.
421 # Some services might not provide such metadata. Any method that returns a
422 # long-running operation should document the metadata type, if any.
423 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
424 },
425 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
426 # If `true`, the operation is completed, and either `error` or `response` is
427 # available.
428 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
429 # method returns no data on success, such as `Delete`, the response is
430 # `google.protobuf.Empty`. If the original method is standard
431 # `Get`/`Create`/`Update`, the response should be the resource. For other
432 # methods, the response should have the type `XxxResponse`, where `Xxx`
433 # is the original method name. For example, if the original method name
434 # is `TakeSnapshot()`, the inferred response type is
435 # `TakeSnapshotResponse`.
436 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
437 },
438 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
439 # originally returns it. If you use the default HTTP mapping, the
440 # `name` should be a resource name ending with `operations/{unique_id}`.
441 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
442 # different programming environments, including REST APIs and RPC APIs. It is
443 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
444 # three pieces of data: error code, error message, and error details.
445 #
446 # You can find out more about this error model and how to work with it in the
447 # [API Design Guide](https://cloud.google.com/apis/design/errors).
448 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
449 # message types for APIs to use.
450 {
451 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
452 },
453 ],
454 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
455 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
456 # user-facing error message should be localized and sent in the
457 # google.rpc.Status.details field, or localized by the client.
458 },
459 }</pre>
460</div>
461
462<div class="method">
463 <code class="details" id="train">train(parent, body=None, x__xgafv=None)</code>
464 <pre>Trains the specified agent.
465
466
467Operation &lt;response: google.protobuf.Empty&gt;
468
469Args:
470 parent: string, Required. The project that the agent to train is associated with.
471Format: `projects/&lt;Project ID&gt;`. (required)
472 body: object, The request body.
473 The object takes the form of:
474
475{ # The request message for Agents.TrainAgent.
476 }
477
478 x__xgafv: string, V1 error format.
479 Allowed values
480 1 - v1 error format
481 2 - v2 error format
482
483Returns:
484 An object of the form:
485
486 { # This resource represents a long-running operation that is the result of a
487 # network API call.
488 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
489 # contains progress information and common metadata such as create time.
490 # Some services might not provide such metadata. Any method that returns a
491 # long-running operation should document the metadata type, if any.
492 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
493 },
494 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
495 # If `true`, the operation is completed, and either `error` or `response` is
496 # available.
497 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
498 # method returns no data on success, such as `Delete`, the response is
499 # `google.protobuf.Empty`. If the original method is standard
500 # `Get`/`Create`/`Update`, the response should be the resource. For other
501 # methods, the response should have the type `XxxResponse`, where `Xxx`
502 # is the original method name. For example, if the original method name
503 # is `TakeSnapshot()`, the inferred response type is
504 # `TakeSnapshotResponse`.
505 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
506 },
507 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
508 # originally returns it. If you use the default HTTP mapping, the
509 # `name` should be a resource name ending with `operations/{unique_id}`.
510 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
511 # different programming environments, including REST APIs and RPC APIs. It is
512 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
513 # three pieces of data: error code, error message, and error details.
514 #
515 # You can find out more about this error model and how to work with it in the
516 # [API Design Guide](https://cloud.google.com/apis/design/errors).
517 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
518 # message types for APIs to use.
519 {
520 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
521 },
522 ],
523 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
524 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
525 # user-facing error message should be localized and sent in the
526 # google.rpc.Status.details field, or localized by the client.
527 },
528 }</pre>
529</div>
530
531</body></html>