google-apis-dialogflow_v2beta1 0.116.0 → 0.118.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -52,10 +52,8 @@ module Google
52
52
  @batch_path = 'batch'
53
53
  end
54
54
 
55
- # Deletes the specified agent.
55
+ #
56
56
  # @param [String] parent
57
- # Required. The project that the agent to delete is associated with. Format: `
58
- # projects/` or `projects//locations/`.
59
57
  # @param [String] fields
60
58
  # Selector specifying which fields to include in a partial response.
61
59
  # @param [String] quota_user
@@ -83,10 +81,8 @@ module Google
83
81
  execute_or_queue_command(command, &block)
84
82
  end
85
83
 
86
- # Retrieves the specified agent.
84
+ #
87
85
  # @param [String] parent
88
- # Required. The project that the agent to fetch is associated with. Format: `
89
- # projects/` or `projects//locations/`.
90
86
  # @param [String] fields
91
87
  # Selector specifying which fields to include in a partial response.
92
88
  # @param [String] quota_user
@@ -114,15 +110,10 @@ module Google
114
110
  execute_or_queue_command(command, &block)
115
111
  end
116
112
 
117
- # Creates/updates the specified agent. Note: You should always train an agent
118
- # prior to sending it queries. See the [training documentation](https://cloud.
119
- # google.com/dialogflow/es/docs/training).
113
+ #
120
114
  # @param [String] parent
121
- # Required. The project of this agent. Format: `projects/` or `projects//
122
- # locations/`
123
115
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Agent] google_cloud_dialogflow_v2beta1_agent_object
124
116
  # @param [String] update_mask
125
- # Optional. The mask to control which fields get updated.
126
117
  # @param [String] fields
127
118
  # Selector specifying which fields to include in a partial response.
128
119
  # @param [String] quota_user
@@ -153,15 +144,8 @@ module Google
153
144
  execute_or_queue_command(command, &block)
154
145
  end
155
146
 
156
- # Exports the specified agent to a ZIP file. This method is a [long-running
157
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
158
- # operations). The returned `Operation` type has the following method-specific
159
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
160
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
161
- # ExportAgentResponse
147
+ #
162
148
  # @param [String] parent
163
- # Required. The project that the agent to export is associated with. Format: `
164
- # projects/` or `projects//locations/`.
165
149
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ExportAgentRequest] google_cloud_dialogflow_v2beta1_export_agent_request_object
166
150
  # @param [String] fields
167
151
  # Selector specifying which fields to include in a partial response.
@@ -192,10 +176,8 @@ module Google
192
176
  execute_or_queue_command(command, &block)
193
177
  end
194
178
 
195
- # Retrieves the fulfillment.
179
+ #
196
180
  # @param [String] name
197
- # Required. The name of the fulfillment. Supported formats: - `projects//agent/
198
- # fulfillment` - `projects//locations//agent/fulfillment`
199
181
  # @param [String] fields
200
182
  # Selector specifying which fields to include in a partial response.
201
183
  # @param [String] quota_user
@@ -223,16 +205,9 @@ module Google
223
205
  execute_or_queue_command(command, &block)
224
206
  end
225
207
 
226
- # Gets agent validation result. Agent validation is performed during training
227
- # time and is updated automatically when training is completed.
208
+ #
228
209
  # @param [String] parent
229
- # Required. The project that the agent is associated with. Format: `projects/`
230
- # or `projects//locations/`.
231
210
  # @param [String] language_code
232
- # Optional. The language for which you want a validation result. If not
233
- # specified, the agent's default language is used. [Many languages](https://
234
- # cloud.google.com/dialogflow/docs/reference/language) are supported. Note:
235
- # languages must be enabled in the agent before they can be used.
236
211
  # @param [String] fields
237
212
  # Selector specifying which fields to include in a partial response.
238
213
  # @param [String] quota_user
@@ -261,25 +236,8 @@ module Google
261
236
  execute_or_queue_command(command, &block)
262
237
  end
263
238
 
264
- # Imports the specified agent from a ZIP file. Uploads new intents and entity
265
- # types without deleting the existing ones. Intents and entity types with the
266
- # same name are replaced with the new versions from ImportAgentRequest. After
267
- # the import, the imported draft agent will be trained automatically (unless
268
- # disabled in agent settings). However, once the import is done, training may
269
- # not be completed yet. Please call TrainAgent and wait for the operation it
270
- # returns in order to train explicitly. This method is a [long-running operation]
271
- # (https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The
272
- # returned `Operation` type has the following method-specific fields: - `
273
- # metadata`: An empty [Struct message](https://developers.google.com/protocol-
274
- # buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message]
275
- # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
276
- # empty) The operation only tracks when importing is complete, not when it is
277
- # done training. Note: You should always train an agent prior to sending it
278
- # queries. See the [training documentation](https://cloud.google.com/dialogflow/
279
- # es/docs/training).
239
+ #
280
240
  # @param [String] parent
281
- # Required. The project that the agent to import is associated with. Format: `
282
- # projects/` or `projects//locations/`.
283
241
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ImportAgentRequest] google_cloud_dialogflow_v2beta1_import_agent_request_object
284
242
  # @param [String] fields
285
243
  # Selector specifying which fields to include in a partial response.
@@ -310,24 +268,8 @@ module Google
310
268
  execute_or_queue_command(command, &block)
311
269
  end
312
270
 
313
- # Restores the specified agent from a ZIP file. Replaces the current agent
314
- # version with a new one. All the intents and entity types in the older version
315
- # are deleted. After the restore, the restored draft agent will be trained
316
- # automatically (unless disabled in agent settings). However, once the restore
317
- # is done, training may not be completed yet. Please call TrainAgent and wait
318
- # for the operation it returns in order to train explicitly. This method is a [
319
- # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
320
- # running-operations). The returned `Operation` type has the following method-
321
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
322
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
323
- # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
324
- # reference/google.protobuf#empty) The operation only tracks when restoring is
325
- # complete, not when it is done training. Note: You should always train an agent
326
- # prior to sending it queries. See the [training documentation](https://cloud.
327
- # google.com/dialogflow/es/docs/training).
271
+ #
328
272
  # @param [String] parent
329
- # Required. The project that the agent to restore is associated with. Format: `
330
- # projects/` or `projects//locations/`.
331
273
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1RestoreAgentRequest] google_cloud_dialogflow_v2beta1_restore_agent_request_object
332
274
  # @param [String] fields
333
275
  # Selector specifying which fields to include in a partial response.
@@ -358,19 +300,10 @@ module Google
358
300
  execute_or_queue_command(command, &block)
359
301
  end
360
302
 
361
- # Returns the list of agents. Since there is at most one conversational agent
362
- # per project, this method is useful primarily for listing all agents across
363
- # projects the caller has access to. One can achieve that with a wildcard
364
- # project collection id "-". Refer to [List Sub-Collections](https://cloud.
365
- # google.com/apis/design/design_patterns#list_sub-collections).
303
+ #
366
304
  # @param [String] parent
367
- # Required. The project to list agents from. Format: `projects/` or `projects//
368
- # locations/`.
369
305
  # @param [Fixnum] page_size
370
- # Optional. The maximum number of items to return in a single page. By default
371
- # 100 and at most 1000.
372
306
  # @param [String] page_token
373
- # Optional. The next_page_token value returned from a previous list request.
374
307
  # @param [String] fields
375
308
  # Selector specifying which fields to include in a partial response.
376
309
  # @param [String] quota_user
@@ -400,17 +333,8 @@ module Google
400
333
  execute_or_queue_command(command, &block)
401
334
  end
402
335
 
403
- # Trains the specified agent. This method is a [long-running operation](https://
404
- # cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned
405
- # `Operation` type has the following method-specific fields: - `metadata`: An
406
- # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
407
- # reference/google.protobuf#struct) - `response`: An [Empty message](https://
408
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
409
- # Note: You should always train an agent prior to sending it queries. See the [
410
- # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
336
+ #
411
337
  # @param [String] parent
412
- # Required. The project that the agent to train is associated with. Format: `
413
- # projects/` or `projects//locations/`.
414
338
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1TrainAgentRequest] google_cloud_dialogflow_v2beta1_train_agent_request_object
415
339
  # @param [String] fields
416
340
  # Selector specifying which fields to include in a partial response.
@@ -441,15 +365,10 @@ module Google
441
365
  execute_or_queue_command(command, &block)
442
366
  end
443
367
 
444
- # Updates the fulfillment.
368
+ #
445
369
  # @param [String] name
446
- # Required. The unique identifier of the fulfillment. Supported formats: - `
447
- # projects//agent/fulfillment` - `projects//locations//agent/fulfillment` This
448
- # field is not used for Fulfillment in an Environment.
449
370
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Fulfillment] google_cloud_dialogflow_v2beta1_fulfillment_object
450
371
  # @param [String] update_mask
451
- # Required. The mask to control which fields get updated. If the mask is not
452
- # present, all fields will be updated.
453
372
  # @param [String] fields
454
373
  # Selector specifying which fields to include in a partial response.
455
374
  # @param [String] quota_user
@@ -480,18 +399,8 @@ module Google
480
399
  execute_or_queue_command(command, &block)
481
400
  end
482
401
 
483
- # Deletes entity types in the specified agent. This method is a [long-running
484
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
485
- # operations). The returned `Operation` type has the following method-specific
486
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
487
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
488
- # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
489
- # google.protobuf#empty) Note: You should always train an agent prior to sending
490
- # it queries. See the [training documentation](https://cloud.google.com/
491
- # dialogflow/es/docs/training).
402
+ #
492
403
  # @param [String] parent
493
- # Required. The name of the agent to delete all entities types for. Supported
494
- # formats: - `projects//agent`, - `projects//locations//agent`.
495
404
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest] google_cloud_dialogflow_v2beta1_batch_delete_entity_types_request_object
496
405
  # @param [String] fields
497
406
  # Selector specifying which fields to include in a partial response.
@@ -522,17 +431,8 @@ module Google
522
431
  execute_or_queue_command(command, &block)
523
432
  end
524
433
 
525
- # Updates/Creates multiple entity types in the specified agent. This method is a
526
- # [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
527
- # running-operations). The returned `Operation` type has the following method-
528
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
529
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
530
- # : BatchUpdateEntityTypesResponse Note: You should always train an agent prior
531
- # to sending it queries. See the [training documentation](https://cloud.google.
532
- # com/dialogflow/es/docs/training).
434
+ #
533
435
  # @param [String] parent
534
- # Required. The name of the agent to update or create entity types in. Supported
535
- # formats: - `projects//agent` - `projects//locations//agent`
536
436
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest] google_cloud_dialogflow_v2beta1_batch_update_entity_types_request_object
537
437
  # @param [String] fields
538
438
  # Selector specifying which fields to include in a partial response.
@@ -563,18 +463,10 @@ module Google
563
463
  execute_or_queue_command(command, &block)
564
464
  end
565
465
 
566
- # Creates an entity type in the specified agent. Note: You should always train
567
- # an agent prior to sending it queries. See the [training documentation](https://
568
- # cloud.google.com/dialogflow/es/docs/training).
466
+ #
569
467
  # @param [String] parent
570
- # Required. The agent to create a entity type for. Supported formats: - `
571
- # projects//agent` - `projects//locations//agent`
572
468
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EntityType] google_cloud_dialogflow_v2beta1_entity_type_object
573
469
  # @param [String] language_code
574
- # Optional. The language used to access language-specific data. If not specified,
575
- # the agent's default language is used. For more information, see [Multilingual
576
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
577
- # multilingual#intent-entity).
578
470
  # @param [String] fields
579
471
  # Selector specifying which fields to include in a partial response.
580
472
  # @param [String] quota_user
@@ -605,12 +497,8 @@ module Google
605
497
  execute_or_queue_command(command, &block)
606
498
  end
607
499
 
608
- # Deletes the specified entity type. Note: You should always train an agent
609
- # prior to sending it queries. See the [training documentation](https://cloud.
610
- # google.com/dialogflow/es/docs/training).
500
+ #
611
501
  # @param [String] name
612
- # Required. The name of the entity type to delete. Supported formats: - `
613
- # projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
614
502
  # @param [String] fields
615
503
  # Selector specifying which fields to include in a partial response.
616
504
  # @param [String] quota_user
@@ -638,15 +526,9 @@ module Google
638
526
  execute_or_queue_command(command, &block)
639
527
  end
640
528
 
641
- # Retrieves the specified entity type.
529
+ #
642
530
  # @param [String] name
643
- # Required. The name of the entity type. Supported formats: - `projects//agent/
644
- # entityTypes/` - `projects//locations//agent/entityTypes/`
645
531
  # @param [String] language_code
646
- # Optional. The language used to access language-specific data. If not specified,
647
- # the agent's default language is used. For more information, see [Multilingual
648
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
649
- # multilingual#intent-entity).
650
532
  # @param [String] fields
651
533
  # Selector specifying which fields to include in a partial response.
652
534
  # @param [String] quota_user
@@ -675,20 +557,11 @@ module Google
675
557
  execute_or_queue_command(command, &block)
676
558
  end
677
559
 
678
- # Returns the list of all entity types in the specified agent.
560
+ #
679
561
  # @param [String] parent
680
- # Required. The agent to list all entity types from. Supported formats: - `
681
- # projects//agent` - `projects//locations//agent`
682
562
  # @param [String] language_code
683
- # Optional. The language used to access language-specific data. If not specified,
684
- # the agent's default language is used. For more information, see [Multilingual
685
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
686
- # multilingual#intent-entity).
687
563
  # @param [Fixnum] page_size
688
- # Optional. The maximum number of items to return in a single page. By default
689
- # 100 and at most 1000.
690
564
  # @param [String] page_token
691
- # Optional. The next_page_token value returned from a previous list request.
692
565
  # @param [String] fields
693
566
  # Selector specifying which fields to include in a partial response.
694
567
  # @param [String] quota_user
@@ -719,22 +592,11 @@ module Google
719
592
  execute_or_queue_command(command, &block)
720
593
  end
721
594
 
722
- # Updates the specified entity type. Note: You should always train an agent
723
- # prior to sending it queries. See the [training documentation](https://cloud.
724
- # google.com/dialogflow/es/docs/training).
595
+ #
725
596
  # @param [String] name
726
- # The unique identifier of the entity type. Required for EntityTypes.
727
- # UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Supported
728
- # formats: - `projects//agent/entityTypes/` - `projects//locations//agent/
729
- # entityTypes/`
730
597
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EntityType] google_cloud_dialogflow_v2beta1_entity_type_object
731
598
  # @param [String] language_code
732
- # Optional. The language used to access language-specific data. If not specified,
733
- # the agent's default language is used. For more information, see [Multilingual
734
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
735
- # multilingual#intent-entity).
736
599
  # @param [String] update_mask
737
- # Optional. The mask to control which fields get updated.
738
600
  # @param [String] fields
739
601
  # Selector specifying which fields to include in a partial response.
740
602
  # @param [String] quota_user
@@ -766,18 +628,8 @@ module Google
766
628
  execute_or_queue_command(command, &block)
767
629
  end
768
630
 
769
- # Creates multiple new entities in the specified entity type. This method is a [
770
- # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
771
- # running-operations). The returned `Operation` type has the following method-
772
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
773
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
774
- # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
775
- # reference/google.protobuf#empty) Note: You should always train an agent prior
776
- # to sending it queries. See the [training documentation](https://cloud.google.
777
- # com/dialogflow/es/docs/training).
631
+ #
778
632
  # @param [String] parent
779
- # Required. The name of the entity type to create entities in. Supported formats:
780
- # - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
781
633
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest] google_cloud_dialogflow_v2beta1_batch_create_entities_request_object
782
634
  # @param [String] fields
783
635
  # Selector specifying which fields to include in a partial response.
@@ -808,18 +660,8 @@ module Google
808
660
  execute_or_queue_command(command, &block)
809
661
  end
810
662
 
811
- # Deletes entities in the specified entity type. This method is a [long-running
812
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
813
- # operations). The returned `Operation` type has the following method-specific
814
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
815
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
816
- # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
817
- # google.protobuf#empty) Note: You should always train an agent prior to sending
818
- # it queries. See the [training documentation](https://cloud.google.com/
819
- # dialogflow/es/docs/training).
663
+ #
820
664
  # @param [String] parent
821
- # Required. The name of the entity type to delete entries for. Supported formats:
822
- # - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
823
665
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest] google_cloud_dialogflow_v2beta1_batch_delete_entities_request_object
824
666
  # @param [String] fields
825
667
  # Selector specifying which fields to include in a partial response.
@@ -850,20 +692,8 @@ module Google
850
692
  execute_or_queue_command(command, &block)
851
693
  end
852
694
 
853
- # Updates or creates multiple entities in the specified entity type. This method
854
- # does not affect entities in the entity type that aren't explicitly specified
855
- # in the request. Note: You should always train an agent prior to sending it
856
- # queries. See the [training documentation](https://cloud.google.com/dialogflow/
857
- # es/docs/training). This method is a [long-running operation](https://cloud.
858
- # google.com/dialogflow/es/docs/how/long-running-operations). The returned `
859
- # Operation` type has the following method-specific fields: - `metadata`: An
860
- # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
861
- # reference/google.protobuf#struct) - `response`: An [Empty message](https://
862
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
695
+ #
863
696
  # @param [String] parent
864
- # Required. The name of the entity type to update or create entities in.
865
- # Supported formats: - `projects//agent/entityTypes/` - `projects//locations//
866
- # agent/entityTypes/`
867
697
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest] google_cloud_dialogflow_v2beta1_batch_update_entities_request_object
868
698
  # @param [String] fields
869
699
  # Selector specifying which fields to include in a partial response.
@@ -894,13 +724,10 @@ module Google
894
724
  execute_or_queue_command(command, &block)
895
725
  end
896
726
 
897
- # Creates an agent environment.
727
+ #
898
728
  # @param [String] parent
899
- # Required. The agent to create an environment for. Supported formats: - `
900
- # projects//agent` - `projects//locations//agent`
901
729
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
902
730
  # @param [String] environment_id
903
- # Required. The unique id of the new environment.
904
731
  # @param [String] fields
905
732
  # Selector specifying which fields to include in a partial response.
906
733
  # @param [String] quota_user
@@ -931,10 +758,8 @@ module Google
931
758
  execute_or_queue_command(command, &block)
932
759
  end
933
760
 
934
- # Deletes the specified agent environment.
761
+ #
935
762
  # @param [String] name
936
- # Required. The name of the environment to delete. / Format: - `projects//agent/
937
- # environments/` - `projects//locations//agent/environments/`
938
763
  # @param [String] fields
939
764
  # Selector specifying which fields to include in a partial response.
940
765
  # @param [String] quota_user
@@ -962,10 +787,8 @@ module Google
962
787
  execute_or_queue_command(command, &block)
963
788
  end
964
789
 
965
- # Retrieves the specified agent environment.
790
+ #
966
791
  # @param [String] name
967
- # Required. The name of the environment. Supported formats: - `projects//agent/
968
- # environments/` - `projects//locations//agent/environments/`
969
792
  # @param [String] fields
970
793
  # Selector specifying which fields to include in a partial response.
971
794
  # @param [String] quota_user
@@ -993,16 +816,10 @@ module Google
993
816
  execute_or_queue_command(command, &block)
994
817
  end
995
818
 
996
- # Gets the history of the specified environment.
819
+ #
997
820
  # @param [String] parent
998
- # Required. The name of the environment to retrieve history for. Supported
999
- # formats: - `projects//agent/environments/` - `projects//locations//agent/
1000
- # environments/`
1001
821
  # @param [Fixnum] page_size
1002
- # Optional. The maximum number of items to return in a single page. By default
1003
- # 100 and at most 1000.
1004
822
  # @param [String] page_token
1005
- # Optional. The next_page_token value returned from a previous list request.
1006
823
  # @param [String] fields
1007
824
  # Selector specifying which fields to include in a partial response.
1008
825
  # @param [String] quota_user
@@ -1032,15 +849,10 @@ module Google
1032
849
  execute_or_queue_command(command, &block)
1033
850
  end
1034
851
 
1035
- # Returns the list of all non-draft environments of the specified agent.
852
+ #
1036
853
  # @param [String] parent
1037
- # Required. The agent to list all environments from. Format: - `projects//agent`
1038
- # - `projects//locations//agent`
1039
854
  # @param [Fixnum] page_size
1040
- # Optional. The maximum number of items to return in a single page. By default
1041
- # 100 and at most 1000.
1042
855
  # @param [String] page_token
1043
- # Optional. The next_page_token value returned from a previous list request.
1044
856
  # @param [String] fields
1045
857
  # Selector specifying which fields to include in a partial response.
1046
858
  # @param [String] quota_user
@@ -1070,28 +882,11 @@ module Google
1070
882
  execute_or_queue_command(command, &block)
1071
883
  end
1072
884
 
1073
- # Updates the specified agent environment. This method allows you to deploy new
1074
- # agent versions into the environment. When an environment is pointed to a new
1075
- # agent version by setting `environment.agent_version`, the environment is
1076
- # temporarily set to the `LOADING` state. During that time, the environment
1077
- # keeps on serving the previous version of the agent. After the new agent
1078
- # version is done loading, the environment is set back to the `RUNNING` state.
1079
- # You can use "-" as Environment ID in environment name to update version in "
1080
- # draft" environment. WARNING: this will negate all recent changes to draft and
1081
- # can't be undone. You may want to save the draft to a version before calling
1082
- # this function.
885
+ #
1083
886
  # @param [String] name
1084
- # Output only. The unique identifier of this agent environment. Supported
1085
- # formats: - `projects//agent/environments/` - `projects//locations//agent/
1086
- # environments/`
1087
887
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
1088
888
  # @param [Boolean] allow_load_to_draft_and_discard_changes
1089
- # Optional. This field is used to prevent accidental overwrite of the draft
1090
- # environment, which is an operation that cannot be undone. To confirm that the
1091
- # caller desires this overwrite, this field must be explicitly set to true when
1092
- # updating the draft environment (environment ID = `-`).
1093
889
  # @param [String] update_mask
1094
- # Required. The mask to control which fields get updated.
1095
890
  # @param [String] fields
1096
891
  # Selector specifying which fields to include in a partial response.
1097
892
  # @param [String] quota_user
@@ -1123,25 +918,12 @@ module Google
1123
918
  execute_or_queue_command(command, &block)
1124
919
  end
1125
920
 
1126
- # Returns the list of all intents in the specified agent.
921
+ #
1127
922
  # @param [String] parent
1128
- # Required. The agent to list all intents from. Format: `projects//agent` or `
1129
- # projects//locations//agent`. Alternatively, you can specify the environment to
1130
- # list intents for. Format: `projects//agent/environments/` or `projects//
1131
- # locations//agent/environments/`. Note: training phrases of the intents will
1132
- # not be returned for non-draft environment.
1133
923
  # @param [String] intent_view
1134
- # Optional. The resource view to apply to the returned intent.
1135
924
  # @param [String] language_code
1136
- # Optional. The language used to access language-specific data. If not specified,
1137
- # the agent's default language is used. For more information, see [Multilingual
1138
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
1139
- # multilingual#intent-entity).
1140
925
  # @param [Fixnum] page_size
1141
- # Optional. The maximum number of items to return in a single page. By default
1142
- # 100 and at most 1000.
1143
926
  # @param [String] page_token
1144
- # Optional. The next_page_token value returned from a previous list request.
1145
927
  # @param [String] fields
1146
928
  # Selector specifying which fields to include in a partial response.
1147
929
  # @param [String] quota_user
@@ -1173,15 +955,8 @@ module Google
1173
955
  execute_or_queue_command(command, &block)
1174
956
  end
1175
957
 
1176
- # Deletes all active contexts in the specified session.
958
+ #
1177
959
  # @param [String] parent
1178
- # Required. The name of the session to delete all contexts from. Supported
1179
- # formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`
1180
- # , - `projects//agent/environments//users//sessions/`, - `projects//locations//
1181
- # agent/environments//users//sessions/`, If `Location ID` is not specified we
1182
- # assume default 'us' location. If `Environment ID` is not specified we assume
1183
- # default 'draft' environment. If `User ID` is not specified, we assume default '
1184
- # -' user.
1185
960
  # @param [String] fields
1186
961
  # Selector specifying which fields to include in a partial response.
1187
962
  # @param [String] quota_user
@@ -1209,30 +984,8 @@ module Google
1209
984
  execute_or_queue_command(command, &block)
1210
985
  end
1211
986
 
1212
- # Processes a natural language query and returns structured, actionable data as
1213
- # a result. This method is not idempotent, because it may cause contexts and
1214
- # session entity types to be updated, which in turn might affect results of
1215
- # future queries. If you might use [Agent Assist](https://cloud.google.com/
1216
- # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
1217
- # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
1218
- # additional functionality for Agent Assist and other CCAI products. Note:
1219
- # Always use agent versions for production traffic. See [Versions and
1220
- # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
987
+ #
1221
988
  # @param [String] session
1222
- # Required. The name of the session this query is sent to. Supported formats: - `
1223
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
1224
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
1225
- # environments//users//sessions/`, If `Location ID` is not specified we assume
1226
- # default 'us' location. If `Environment ID` is not specified, we assume default
1227
- # 'draft' environment (`Environment ID` might be referred to as environment name
1228
- # at some places). If `User ID` is not specified, we are using "-". It's up to
1229
- # the API caller to choose an appropriate `Session ID` and `User Id`. They can
1230
- # be a random number or some type of user and session identifiers (preferably
1231
- # hashed). The length of the `Session ID` and `User ID` must not exceed 36
1232
- # characters. For more information, see the [API interactions guide](https://
1233
- # cloud.google.com/dialogflow/docs/api-overview). Note: Always use agent
1234
- # versions for production traffic. See [Versions and environments](https://cloud.
1235
- # google.com/dialogflow/es/docs/agents-versions).
1236
989
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1DetectIntentRequest] google_cloud_dialogflow_v2beta1_detect_intent_request_object
1237
990
  # @param [String] fields
1238
991
  # Selector specifying which fields to include in a partial response.
@@ -1263,15 +1016,8 @@ module Google
1263
1016
  execute_or_queue_command(command, &block)
1264
1017
  end
1265
1018
 
1266
- # Creates a context. If the specified context already exists, overrides the
1267
- # context.
1019
+ #
1268
1020
  # @param [String] parent
1269
- # Required. The session to create a context for. Supported formats: - `projects//
1270
- # agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/
1271
- # environments//users//sessions/`, - `projects//locations//agent/environments//
1272
- # users//sessions/`, If `Location ID` is not specified we assume default 'us'
1273
- # location. If `Environment ID` is not specified, we assume default 'draft'
1274
- # environment. If `User ID` is not specified, we assume default '-' user.
1275
1021
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
1276
1022
  # @param [String] fields
1277
1023
  # Selector specifying which fields to include in a partial response.
@@ -1302,15 +1048,8 @@ module Google
1302
1048
  execute_or_queue_command(command, &block)
1303
1049
  end
1304
1050
 
1305
- # Deletes the specified context.
1051
+ #
1306
1052
  # @param [String] name
1307
- # Required. The name of the context to delete. Supported formats: - `projects//
1308
- # agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`,
1309
- # - `projects//agent/environments//users//sessions//contexts/`, - `projects//
1310
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
1311
- # is not specified we assume default 'us' location. If `Environment ID` is not
1312
- # specified, we assume default 'draft' environment. If `User ID` is not
1313
- # specified, we assume default '-' user.
1314
1053
  # @param [String] fields
1315
1054
  # Selector specifying which fields to include in a partial response.
1316
1055
  # @param [String] quota_user
@@ -1338,15 +1077,8 @@ module Google
1338
1077
  execute_or_queue_command(command, &block)
1339
1078
  end
1340
1079
 
1341
- # Retrieves the specified context.
1080
+ #
1342
1081
  # @param [String] name
1343
- # Required. The name of the context. Supported formats: - `projects//agent/
1344
- # sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `
1345
- # projects//agent/environments//users//sessions//contexts/`, - `projects//
1346
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
1347
- # is not specified we assume default 'us' location. If `Environment ID` is not
1348
- # specified, we assume default 'draft' environment. If `User ID` is not
1349
- # specified, we assume default '-' user.
1350
1082
  # @param [String] fields
1351
1083
  # Selector specifying which fields to include in a partial response.
1352
1084
  # @param [String] quota_user
@@ -1374,19 +1106,10 @@ module Google
1374
1106
  execute_or_queue_command(command, &block)
1375
1107
  end
1376
1108
 
1377
- # Returns the list of all contexts in the specified session.
1109
+ #
1378
1110
  # @param [String] parent
1379
- # Required. The session to list all contexts from. Supported formats: - `
1380
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
1381
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
1382
- # environments//users//sessions/`, If `Location ID` is not specified we assume
1383
- # default 'us' location. If `Environment ID` is not specified, we assume default
1384
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
1385
1111
  # @param [Fixnum] page_size
1386
- # Optional. The maximum number of items to return in a single page. By default
1387
- # 100 and at most 1000.
1388
1112
  # @param [String] page_token
1389
- # Optional. The next_page_token value returned from a previous list request.
1390
1113
  # @param [String] fields
1391
1114
  # Selector specifying which fields to include in a partial response.
1392
1115
  # @param [String] quota_user
@@ -1416,21 +1139,10 @@ module Google
1416
1139
  execute_or_queue_command(command, &block)
1417
1140
  end
1418
1141
 
1419
- # Updates the specified context.
1142
+ #
1420
1143
  # @param [String] name
1421
- # Required. The unique identifier of the context. Supported formats: - `projects/
1422
- # /agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`
1423
- # , - `projects//agent/environments//users//sessions//contexts/`, - `projects//
1424
- # locations//agent/environments//users//sessions//contexts/`, The `Context ID`
1425
- # is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%`
1426
- # and may be at most 250 bytes long. If `Environment ID` is not specified, we
1427
- # assume default 'draft' environment. If `User ID` is not specified, we assume
1428
- # default '-' user. The following context names are reserved for internal use by
1429
- # Dialogflow. You should not use these contexts or create contexts with these
1430
- # names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`
1431
1144
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
1432
1145
  # @param [String] update_mask
1433
- # Optional. The mask to control which fields get updated.
1434
1146
  # @param [String] fields
1435
1147
  # Selector specifying which fields to include in a partial response.
1436
1148
  # @param [String] quota_user
@@ -1461,17 +1173,8 @@ module Google
1461
1173
  execute_or_queue_command(command, &block)
1462
1174
  end
1463
1175
 
1464
- # Creates a session entity type. If the specified session entity type already
1465
- # exists, overrides the session entity type. This method doesn't work with
1466
- # Google Assistant integration. Contact Dialogflow support if you need to use
1467
- # session entities with Google Assistant integration.
1176
+ #
1468
1177
  # @param [String] parent
1469
- # Required. The session to create a session entity type for. Supported formats: -
1470
- # `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
1471
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
1472
- # environments//users//sessions/`, If `Location ID` is not specified we assume
1473
- # default 'us' location. If `Environment ID` is not specified, we assume default
1474
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
1475
1178
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
1476
1179
  # @param [String] fields
1477
1180
  # Selector specifying which fields to include in a partial response.
@@ -1502,17 +1205,8 @@ module Google
1502
1205
  execute_or_queue_command(command, &block)
1503
1206
  end
1504
1207
 
1505
- # Deletes the specified session entity type. This method doesn't work with
1506
- # Google Assistant integration. Contact Dialogflow support if you need to use
1507
- # session entities with Google Assistant integration.
1208
+ #
1508
1209
  # @param [String] name
1509
- # Required. The name of the entity type to delete. Supported formats: - `
1510
- # projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions/
1511
- # /entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/`
1512
- # - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If
1513
- # `Location ID` is not specified we assume default 'us' location. If `
1514
- # Environment ID` is not specified, we assume default 'draft' environment. If `
1515
- # User ID` is not specified, we assume default '-' user.
1516
1210
  # @param [String] fields
1517
1211
  # Selector specifying which fields to include in a partial response.
1518
1212
  # @param [String] quota_user
@@ -1540,17 +1234,8 @@ module Google
1540
1234
  execute_or_queue_command(command, &block)
1541
1235
  end
1542
1236
 
1543
- # Retrieves the specified session entity type. This method doesn't work with
1544
- # Google Assistant integration. Contact Dialogflow support if you need to use
1545
- # session entities with Google Assistant integration.
1237
+ #
1546
1238
  # @param [String] name
1547
- # Required. The name of the session entity type. Supported formats: - `projects//
1548
- # agent/sessions//entityTypes/` - `projects//locations//agent/sessions//
1549
- # entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` -
1550
- # `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `
1551
- # Location ID` is not specified we assume default 'us' location. If `Environment
1552
- # ID` is not specified, we assume default 'draft' environment. If `User ID` is
1553
- # not specified, we assume default '-' user.
1554
1239
  # @param [String] fields
1555
1240
  # Selector specifying which fields to include in a partial response.
1556
1241
  # @param [String] quota_user
@@ -1578,21 +1263,10 @@ module Google
1578
1263
  execute_or_queue_command(command, &block)
1579
1264
  end
1580
1265
 
1581
- # Returns the list of all session entity types in the specified session. This
1582
- # method doesn't work with Google Assistant integration. Contact Dialogflow
1583
- # support if you need to use session entities with Google Assistant integration.
1266
+ #
1584
1267
  # @param [String] parent
1585
- # Required. The session to list all session entity types from. Supported formats:
1586
- # - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
1587
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
1588
- # environments//users//sessions/`, If `Location ID` is not specified we assume
1589
- # default 'us' location. If `Environment ID` is not specified, we assume default
1590
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
1591
1268
  # @param [Fixnum] page_size
1592
- # Optional. The maximum number of items to return in a single page. By default
1593
- # 100 and at most 1000.
1594
1269
  # @param [String] page_token
1595
- # Optional. The next_page_token value returned from a previous list request.
1596
1270
  # @param [String] fields
1597
1271
  # Selector specifying which fields to include in a partial response.
1598
1272
  # @param [String] quota_user
@@ -1622,22 +1296,10 @@ module Google
1622
1296
  execute_or_queue_command(command, &block)
1623
1297
  end
1624
1298
 
1625
- # Updates the specified session entity type. This method doesn't work with
1626
- # Google Assistant integration. Contact Dialogflow support if you need to use
1627
- # session entities with Google Assistant integration.
1299
+ #
1628
1300
  # @param [String] name
1629
- # Required. The unique identifier of this session entity type. Supported formats:
1630
- # - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/
1631
- # sessions//entityTypes/` - `projects//agent/environments//users//sessions//
1632
- # entityTypes/` - `projects//locations//agent/environments/ /users//sessions//
1633
- # entityTypes/` If `Location ID` is not specified we assume default 'us'
1634
- # location. If `Environment ID` is not specified, we assume default 'draft'
1635
- # environment. If `User ID` is not specified, we assume default '-' user. ``
1636
- # must be the display name of an existing entity type in the same agent that
1637
- # will be overridden or supplemented.
1638
1301
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
1639
1302
  # @param [String] update_mask
1640
- # Optional. The mask to control which fields get updated.
1641
1303
  # @param [String] fields
1642
1304
  # Selector specifying which fields to include in a partial response.
1643
1305
  # @param [String] quota_user
@@ -1668,18 +1330,8 @@ module Google
1668
1330
  execute_or_queue_command(command, &block)
1669
1331
  end
1670
1332
 
1671
- # Deletes intents in the specified agent. This method is a [long-running
1672
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
1673
- # operations). The returned `Operation` type has the following method-specific
1674
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
1675
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
1676
- # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
1677
- # google.protobuf#empty) Note: You should always train an agent prior to sending
1678
- # it queries. See the [training documentation](https://cloud.google.com/
1679
- # dialogflow/es/docs/training).
1333
+ #
1680
1334
  # @param [String] parent
1681
- # Required. The name of the agent to delete all entities types for. Supported
1682
- # formats: - `projects//agent` - `projects//locations//agent`
1683
1335
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest] google_cloud_dialogflow_v2beta1_batch_delete_intents_request_object
1684
1336
  # @param [String] fields
1685
1337
  # Selector specifying which fields to include in a partial response.
@@ -1710,17 +1362,8 @@ module Google
1710
1362
  execute_or_queue_command(command, &block)
1711
1363
  end
1712
1364
 
1713
- # Updates/Creates multiple intents in the specified agent. This method is a [
1714
- # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
1715
- # running-operations). The returned `Operation` type has the following method-
1716
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
1717
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
1718
- # : BatchUpdateIntentsResponse Note: You should always train an agent prior to
1719
- # sending it queries. See the [training documentation](https://cloud.google.com/
1720
- # dialogflow/es/docs/training).
1365
+ #
1721
1366
  # @param [String] parent
1722
- # Required. The name of the agent to update or create intents in. Supported
1723
- # formats: - `projects//agent` - `projects//locations//agent`
1724
1367
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest] google_cloud_dialogflow_v2beta1_batch_update_intents_request_object
1725
1368
  # @param [String] fields
1726
1369
  # Selector specifying which fields to include in a partial response.
@@ -1751,20 +1394,11 @@ module Google
1751
1394
  execute_or_queue_command(command, &block)
1752
1395
  end
1753
1396
 
1754
- # Creates an intent in the specified agent. Note: You should always train an
1755
- # agent prior to sending it queries. See the [training documentation](https://
1756
- # cloud.google.com/dialogflow/es/docs/training).
1397
+ #
1757
1398
  # @param [String] parent
1758
- # Required. The agent to create a intent for. Supported formats: - `projects//
1759
- # agent` - `projects//locations//agent`
1760
1399
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Intent] google_cloud_dialogflow_v2beta1_intent_object
1761
1400
  # @param [String] intent_view
1762
- # Optional. The resource view to apply to the returned intent.
1763
1401
  # @param [String] language_code
1764
- # Optional. The language used to access language-specific data. If not specified,
1765
- # the agent's default language is used. For more information, see [Multilingual
1766
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
1767
- # multilingual#intent-entity).
1768
1402
  # @param [String] fields
1769
1403
  # Selector specifying which fields to include in a partial response.
1770
1404
  # @param [String] quota_user
@@ -1796,13 +1430,8 @@ module Google
1796
1430
  execute_or_queue_command(command, &block)
1797
1431
  end
1798
1432
 
1799
- # Deletes the specified intent and its direct or indirect followup intents. Note:
1800
- # You should always train an agent prior to sending it queries. See the [
1801
- # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
1433
+ #
1802
1434
  # @param [String] name
1803
- # Required. The name of the intent to delete. If this intent has direct or
1804
- # indirect followup intents, we also delete them. Supported formats: - `projects/
1805
- # /agent/intents/` - `projects//locations//agent/intents/`
1806
1435
  # @param [String] fields
1807
1436
  # Selector specifying which fields to include in a partial response.
1808
1437
  # @param [String] quota_user
@@ -1830,17 +1459,10 @@ module Google
1830
1459
  execute_or_queue_command(command, &block)
1831
1460
  end
1832
1461
 
1833
- # Retrieves the specified intent.
1462
+ #
1834
1463
  # @param [String] name
1835
- # Required. The name of the intent. Supported formats: - `projects//agent/
1836
- # intents/` - `projects//locations//agent/intents/`
1837
1464
  # @param [String] intent_view
1838
- # Optional. The resource view to apply to the returned intent.
1839
1465
  # @param [String] language_code
1840
- # Optional. The language used to access language-specific data. If not specified,
1841
- # the agent's default language is used. For more information, see [Multilingual
1842
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
1843
- # multilingual#intent-entity).
1844
1466
  # @param [String] fields
1845
1467
  # Selector specifying which fields to include in a partial response.
1846
1468
  # @param [String] quota_user
@@ -1870,25 +1492,12 @@ module Google
1870
1492
  execute_or_queue_command(command, &block)
1871
1493
  end
1872
1494
 
1873
- # Returns the list of all intents in the specified agent.
1495
+ #
1874
1496
  # @param [String] parent
1875
- # Required. The agent to list all intents from. Format: `projects//agent` or `
1876
- # projects//locations//agent`. Alternatively, you can specify the environment to
1877
- # list intents for. Format: `projects//agent/environments/` or `projects//
1878
- # locations//agent/environments/`. Note: training phrases of the intents will
1879
- # not be returned for non-draft environment.
1880
1497
  # @param [String] intent_view
1881
- # Optional. The resource view to apply to the returned intent.
1882
1498
  # @param [String] language_code
1883
- # Optional. The language used to access language-specific data. If not specified,
1884
- # the agent's default language is used. For more information, see [Multilingual
1885
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
1886
- # multilingual#intent-entity).
1887
1499
  # @param [Fixnum] page_size
1888
- # Optional. The maximum number of items to return in a single page. By default
1889
- # 100 and at most 1000.
1890
1500
  # @param [String] page_token
1891
- # Optional. The next_page_token value returned from a previous list request.
1892
1501
  # @param [String] fields
1893
1502
  # Selector specifying which fields to include in a partial response.
1894
1503
  # @param [String] quota_user
@@ -1920,23 +1529,12 @@ module Google
1920
1529
  execute_or_queue_command(command, &block)
1921
1530
  end
1922
1531
 
1923
- # Updates the specified intent. Note: You should always train an agent prior to
1924
- # sending it queries. See the [training documentation](https://cloud.google.com/
1925
- # dialogflow/es/docs/training).
1532
+ #
1926
1533
  # @param [String] name
1927
- # Optional. The unique identifier of this intent. Required for Intents.
1928
- # UpdateIntent and Intents.BatchUpdateIntents methods. Supported formats: - `
1929
- # projects//agent/intents/` - `projects//locations//agent/intents/`
1930
1534
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Intent] google_cloud_dialogflow_v2beta1_intent_object
1931
1535
  # @param [String] intent_view
1932
- # Optional. The resource view to apply to the returned intent.
1933
1536
  # @param [String] language_code
1934
- # Optional. The language used to access language-specific data. If not specified,
1935
- # the agent's default language is used. For more information, see [Multilingual
1936
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
1937
- # multilingual#intent-entity).
1938
1537
  # @param [String] update_mask
1939
- # Optional. The mask to control which fields get updated.
1940
1538
  # @param [String] fields
1941
1539
  # Selector specifying which fields to include in a partial response.
1942
1540
  # @param [String] quota_user
@@ -1969,11 +1567,8 @@ module Google
1969
1567
  execute_or_queue_command(command, &block)
1970
1568
  end
1971
1569
 
1972
- # Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource
1973
- # is deprecated; only use `projects.knowledgeBases`.
1570
+ #
1974
1571
  # @param [String] parent
1975
- # Required. The project to create a knowledge base for. Format: `projects//
1976
- # locations/`.
1977
1572
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1KnowledgeBase] google_cloud_dialogflow_v2beta1_knowledge_base_object
1978
1573
  # @param [String] fields
1979
1574
  # Selector specifying which fields to include in a partial response.
@@ -2004,14 +1599,9 @@ module Google
2004
1599
  execute_or_queue_command(command, &block)
2005
1600
  end
2006
1601
 
2007
- # Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases`
2008
- # resource is deprecated; only use `projects.knowledgeBases`.
1602
+ #
2009
1603
  # @param [String] name
2010
- # Required. The name of the knowledge base to delete. Format: `projects//
2011
- # locations//knowledgeBases/`.
2012
1604
  # @param [Boolean] force
2013
- # Optional. Force deletes the knowledge base. When set to true, any documents in
2014
- # the knowledge base are also deleted.
2015
1605
  # @param [String] fields
2016
1606
  # Selector specifying which fields to include in a partial response.
2017
1607
  # @param [String] quota_user
@@ -2040,11 +1630,8 @@ module Google
2040
1630
  execute_or_queue_command(command, &block)
2041
1631
  end
2042
1632
 
2043
- # Retrieves the specified knowledge base. Note: The `projects.agent.
2044
- # knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
1633
+ #
2045
1634
  # @param [String] name
2046
- # Required. The name of the knowledge base to retrieve. Format `projects//
2047
- # locations//knowledgeBases/`.
2048
1635
  # @param [String] fields
2049
1636
  # Selector specifying which fields to include in a partial response.
2050
1637
  # @param [String] quota_user
@@ -2072,30 +1659,11 @@ module Google
2072
1659
  execute_or_queue_command(command, &block)
2073
1660
  end
2074
1661
 
2075
- # Returns the list of all knowledge bases of the specified agent. Note: The `
2076
- # projects.agent.knowledgeBases` resource is deprecated; only use `projects.
2077
- # knowledgeBases`.
1662
+ #
2078
1663
  # @param [String] parent
2079
- # Required. The project to list of knowledge bases for. Format: `projects//
2080
- # locations/`.
2081
1664
  # @param [String] filter
2082
- # The filter expression used to filter knowledge bases returned by the list
2083
- # method. The expression has the following syntax: [AND ] ... The following
2084
- # fields and operators are supported: * display_name with has(:) operator *
2085
- # language_code with equals(=) operator Examples: * 'language_code=en-us'
2086
- # matches knowledge bases with en-us language code. * 'display_name:articles'
2087
- # matches knowledge bases whose display name contains "articles". * '
2088
- # display_name:"Best Articles"' matches knowledge bases whose display name
2089
- # contains "Best Articles". * 'language_code=en-gb AND display_name=articles'
2090
- # matches all knowledge bases whose display name contains "articles" and whose
2091
- # language code is "en-gb". Note: An empty filter string (i.e. "") is a no-op
2092
- # and will result in no filtering. For more information about filtering, see [
2093
- # API Filtering](https://aip.dev/160).
2094
1665
  # @param [Fixnum] page_size
2095
- # The maximum number of items to return in a single page. By default 10 and at
2096
- # most 100.
2097
1666
  # @param [String] page_token
2098
- # The next_page_token value returned from a previous list request.
2099
1667
  # @param [String] fields
2100
1668
  # Selector specifying which fields to include in a partial response.
2101
1669
  # @param [String] quota_user
@@ -2126,16 +1694,10 @@ module Google
2126
1694
  execute_or_queue_command(command, &block)
2127
1695
  end
2128
1696
 
2129
- # Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases`
2130
- # resource is deprecated; only use `projects.knowledgeBases`.
1697
+ #
2131
1698
  # @param [String] name
2132
- # The knowledge base resource name. The name must be empty when creating a
2133
- # knowledge base. Format: `projects//locations//knowledgeBases/`.
2134
1699
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1KnowledgeBase] google_cloud_dialogflow_v2beta1_knowledge_base_object
2135
1700
  # @param [String] update_mask
2136
- # Optional. Not specified means `update all`. Currently, only `display_name` can
2137
- # be updated, an InvalidArgument will be returned for attempting to update other
2138
- # fields.
2139
1701
  # @param [String] fields
2140
1702
  # Selector specifying which fields to include in a partial response.
2141
1703
  # @param [String] quota_user
@@ -2166,19 +1728,10 @@ module Google
2166
1728
  execute_or_queue_command(command, &block)
2167
1729
  end
2168
1730
 
2169
- # Creates a new document. This method is a [long-running operation](https://
2170
- # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
2171
- # Operation` type has the following method-specific fields: - `metadata`:
2172
- # KnowledgeOperationMetadata - `response`: Document Note: The `projects.agent.
2173
- # knowledgeBases.documents` resource is deprecated; only use `projects.
2174
- # knowledgeBases.documents`.
1731
+ #
2175
1732
  # @param [String] parent
2176
- # Required. The knowledge base to create a document for. Format: `projects//
2177
- # locations//knowledgeBases/`.
2178
1733
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
2179
1734
  # @param [Boolean] import_gcs_custom_metadata
2180
- # Whether to import custom metadata from Google Cloud Storage. Only valid when
2181
- # the document source is Google Cloud Storage URI.
2182
1735
  # @param [String] fields
2183
1736
  # Selector specifying which fields to include in a partial response.
2184
1737
  # @param [String] quota_user
@@ -2209,16 +1762,8 @@ module Google
2209
1762
  execute_or_queue_command(command, &block)
2210
1763
  end
2211
1764
 
2212
- # Deletes the specified document. This method is a [long-running operation](
2213
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
2214
- # returned `Operation` type has the following method-specific fields: - `
2215
- # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
2216
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
2217
- # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
2218
- # only use `projects.knowledgeBases.documents`.
1765
+ #
2219
1766
  # @param [String] name
2220
- # Required. The name of the document to delete. Format: `projects//locations//
2221
- # knowledgeBases//documents/`.
2222
1767
  # @param [String] fields
2223
1768
  # Selector specifying which fields to include in a partial response.
2224
1769
  # @param [String] quota_user
@@ -2246,12 +1791,8 @@ module Google
2246
1791
  execute_or_queue_command(command, &block)
2247
1792
  end
2248
1793
 
2249
- # Retrieves the specified document. Note: The `projects.agent.knowledgeBases.
2250
- # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
2251
- # .
1794
+ #
2252
1795
  # @param [String] name
2253
- # Required. The name of the document to retrieve. Format `projects//locations//
2254
- # knowledgeBases//documents/`.
2255
1796
  # @param [String] fields
2256
1797
  # Selector specifying which fields to include in a partial response.
2257
1798
  # @param [String] quota_user
@@ -2279,27 +1820,11 @@ module Google
2279
1820
  execute_or_queue_command(command, &block)
2280
1821
  end
2281
1822
 
2282
- # Returns the list of all documents of the knowledge base. Note: The `projects.
2283
- # agent.knowledgeBases.documents` resource is deprecated; only use `projects.
2284
- # knowledgeBases.documents`.
1823
+ #
2285
1824
  # @param [String] parent
2286
- # Required. The knowledge base to list all documents for. Format: `projects//
2287
- # locations//knowledgeBases/`.
2288
1825
  # @param [String] filter
2289
- # The filter expression used to filter documents returned by the list method.
2290
- # The expression has the following syntax: [AND ] ... The following fields and
2291
- # operators are supported: * knowledge_types with has(:) operator * display_name
2292
- # with has(:) operator * state with equals(=) operator Examples: * "
2293
- # knowledge_types:FAQ" matches documents with FAQ knowledge type. * "
2294
- # display_name:customer" matches documents whose display name contains "customer"
2295
- # . * "state=ACTIVE" matches documents with ACTIVE state. * "knowledge_types:FAQ
2296
- # AND state=ACTIVE" matches all active FAQ documents. For more information about
2297
- # filtering, see [API Filtering](https://aip.dev/160).
2298
1826
  # @param [Fixnum] page_size
2299
- # The maximum number of items to return in a single page. By default 10 and at
2300
- # most 100.
2301
1827
  # @param [String] page_token
2302
- # The next_page_token value returned from a previous list request.
2303
1828
  # @param [String] fields
2304
1829
  # Selector specifying which fields to include in a partial response.
2305
1830
  # @param [String] quota_user
@@ -2330,20 +1855,10 @@ module Google
2330
1855
  execute_or_queue_command(command, &block)
2331
1856
  end
2332
1857
 
2333
- # Updates the specified document. This method is a [long-running operation](
2334
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
2335
- # returned `Operation` type has the following method-specific fields: - `
2336
- # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
2337
- # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
2338
- # projects.knowledgeBases.documents`.
1858
+ #
2339
1859
  # @param [String] name
2340
- # Optional. The document resource name. The name must be empty when creating a
2341
- # document. Format: `projects//locations//knowledgeBases//documents/`.
2342
1860
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
2343
1861
  # @param [String] update_mask
2344
- # Optional. Not specified means `update all`. Currently, only `display_name` can
2345
- # be updated, an InvalidArgument will be returned for attempting to update other
2346
- # fields.
2347
1862
  # @param [String] fields
2348
1863
  # Selector specifying which fields to include in a partial response.
2349
1864
  # @param [String] quota_user
@@ -2374,21 +1889,8 @@ module Google
2374
1889
  execute_or_queue_command(command, &block)
2375
1890
  end
2376
1891
 
2377
- # Reloads the specified document from its specified source, content_uri or
2378
- # content. The previously loaded content of the document will be deleted. Note:
2379
- # Even when the content of the document has not changed, there still may be side
2380
- # effects because of internal implementation changes. Note: If the document
2381
- # source is Google Cloud Storage URI, its metadata will be replaced with the
2382
- # custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata`
2383
- # field is set to true in the request. This method is a [long-running operation](
2384
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
2385
- # returned `Operation` type has the following method-specific fields: - `
2386
- # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
2387
- # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
2388
- # projects.knowledgeBases.documents`.
1892
+ #
2389
1893
  # @param [String] name
2390
- # Required. The name of the document to reload. Format: `projects//locations//
2391
- # knowledgeBases//documents/`
2392
1894
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ReloadDocumentRequest] google_cloud_dialogflow_v2beta1_reload_document_request_object
2393
1895
  # @param [String] fields
2394
1896
  # Selector specifying which fields to include in a partial response.
@@ -2419,15 +1921,8 @@ module Google
2419
1921
  execute_or_queue_command(command, &block)
2420
1922
  end
2421
1923
 
2422
- # Deletes all active contexts in the specified session.
1924
+ #
2423
1925
  # @param [String] parent
2424
- # Required. The name of the session to delete all contexts from. Supported
2425
- # formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`
2426
- # , - `projects//agent/environments//users//sessions/`, - `projects//locations//
2427
- # agent/environments//users//sessions/`, If `Location ID` is not specified we
2428
- # assume default 'us' location. If `Environment ID` is not specified we assume
2429
- # default 'draft' environment. If `User ID` is not specified, we assume default '
2430
- # -' user.
2431
1926
  # @param [String] fields
2432
1927
  # Selector specifying which fields to include in a partial response.
2433
1928
  # @param [String] quota_user
@@ -2455,30 +1950,8 @@ module Google
2455
1950
  execute_or_queue_command(command, &block)
2456
1951
  end
2457
1952
 
2458
- # Processes a natural language query and returns structured, actionable data as
2459
- # a result. This method is not idempotent, because it may cause contexts and
2460
- # session entity types to be updated, which in turn might affect results of
2461
- # future queries. If you might use [Agent Assist](https://cloud.google.com/
2462
- # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
2463
- # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
2464
- # additional functionality for Agent Assist and other CCAI products. Note:
2465
- # Always use agent versions for production traffic. See [Versions and
2466
- # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
1953
+ #
2467
1954
  # @param [String] session
2468
- # Required. The name of the session this query is sent to. Supported formats: - `
2469
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
2470
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
2471
- # environments//users//sessions/`, If `Location ID` is not specified we assume
2472
- # default 'us' location. If `Environment ID` is not specified, we assume default
2473
- # 'draft' environment (`Environment ID` might be referred to as environment name
2474
- # at some places). If `User ID` is not specified, we are using "-". It's up to
2475
- # the API caller to choose an appropriate `Session ID` and `User Id`. They can
2476
- # be a random number or some type of user and session identifiers (preferably
2477
- # hashed). The length of the `Session ID` and `User ID` must not exceed 36
2478
- # characters. For more information, see the [API interactions guide](https://
2479
- # cloud.google.com/dialogflow/docs/api-overview). Note: Always use agent
2480
- # versions for production traffic. See [Versions and environments](https://cloud.
2481
- # google.com/dialogflow/es/docs/agents-versions).
2482
1955
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1DetectIntentRequest] google_cloud_dialogflow_v2beta1_detect_intent_request_object
2483
1956
  # @param [String] fields
2484
1957
  # Selector specifying which fields to include in a partial response.
@@ -2509,15 +1982,8 @@ module Google
2509
1982
  execute_or_queue_command(command, &block)
2510
1983
  end
2511
1984
 
2512
- # Creates a context. If the specified context already exists, overrides the
2513
- # context.
1985
+ #
2514
1986
  # @param [String] parent
2515
- # Required. The session to create a context for. Supported formats: - `projects//
2516
- # agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/
2517
- # environments//users//sessions/`, - `projects//locations//agent/environments//
2518
- # users//sessions/`, If `Location ID` is not specified we assume default 'us'
2519
- # location. If `Environment ID` is not specified, we assume default 'draft'
2520
- # environment. If `User ID` is not specified, we assume default '-' user.
2521
1987
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
2522
1988
  # @param [String] fields
2523
1989
  # Selector specifying which fields to include in a partial response.
@@ -2548,15 +2014,8 @@ module Google
2548
2014
  execute_or_queue_command(command, &block)
2549
2015
  end
2550
2016
 
2551
- # Deletes the specified context.
2017
+ #
2552
2018
  # @param [String] name
2553
- # Required. The name of the context to delete. Supported formats: - `projects//
2554
- # agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`,
2555
- # - `projects//agent/environments//users//sessions//contexts/`, - `projects//
2556
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
2557
- # is not specified we assume default 'us' location. If `Environment ID` is not
2558
- # specified, we assume default 'draft' environment. If `User ID` is not
2559
- # specified, we assume default '-' user.
2560
2019
  # @param [String] fields
2561
2020
  # Selector specifying which fields to include in a partial response.
2562
2021
  # @param [String] quota_user
@@ -2584,15 +2043,8 @@ module Google
2584
2043
  execute_or_queue_command(command, &block)
2585
2044
  end
2586
2045
 
2587
- # Retrieves the specified context.
2046
+ #
2588
2047
  # @param [String] name
2589
- # Required. The name of the context. Supported formats: - `projects//agent/
2590
- # sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `
2591
- # projects//agent/environments//users//sessions//contexts/`, - `projects//
2592
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
2593
- # is not specified we assume default 'us' location. If `Environment ID` is not
2594
- # specified, we assume default 'draft' environment. If `User ID` is not
2595
- # specified, we assume default '-' user.
2596
2048
  # @param [String] fields
2597
2049
  # Selector specifying which fields to include in a partial response.
2598
2050
  # @param [String] quota_user
@@ -2620,19 +2072,10 @@ module Google
2620
2072
  execute_or_queue_command(command, &block)
2621
2073
  end
2622
2074
 
2623
- # Returns the list of all contexts in the specified session.
2075
+ #
2624
2076
  # @param [String] parent
2625
- # Required. The session to list all contexts from. Supported formats: - `
2626
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
2627
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
2628
- # environments//users//sessions/`, If `Location ID` is not specified we assume
2629
- # default 'us' location. If `Environment ID` is not specified, we assume default
2630
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
2631
2077
  # @param [Fixnum] page_size
2632
- # Optional. The maximum number of items to return in a single page. By default
2633
- # 100 and at most 1000.
2634
2078
  # @param [String] page_token
2635
- # Optional. The next_page_token value returned from a previous list request.
2636
2079
  # @param [String] fields
2637
2080
  # Selector specifying which fields to include in a partial response.
2638
2081
  # @param [String] quota_user
@@ -2662,21 +2105,10 @@ module Google
2662
2105
  execute_or_queue_command(command, &block)
2663
2106
  end
2664
2107
 
2665
- # Updates the specified context.
2108
+ #
2666
2109
  # @param [String] name
2667
- # Required. The unique identifier of the context. Supported formats: - `projects/
2668
- # /agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`
2669
- # , - `projects//agent/environments//users//sessions//contexts/`, - `projects//
2670
- # locations//agent/environments//users//sessions//contexts/`, The `Context ID`
2671
- # is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%`
2672
- # and may be at most 250 bytes long. If `Environment ID` is not specified, we
2673
- # assume default 'draft' environment. If `User ID` is not specified, we assume
2674
- # default '-' user. The following context names are reserved for internal use by
2675
- # Dialogflow. You should not use these contexts or create contexts with these
2676
- # names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`
2677
2110
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
2678
2111
  # @param [String] update_mask
2679
- # Optional. The mask to control which fields get updated.
2680
2112
  # @param [String] fields
2681
2113
  # Selector specifying which fields to include in a partial response.
2682
2114
  # @param [String] quota_user
@@ -2707,17 +2139,8 @@ module Google
2707
2139
  execute_or_queue_command(command, &block)
2708
2140
  end
2709
2141
 
2710
- # Creates a session entity type. If the specified session entity type already
2711
- # exists, overrides the session entity type. This method doesn't work with
2712
- # Google Assistant integration. Contact Dialogflow support if you need to use
2713
- # session entities with Google Assistant integration.
2142
+ #
2714
2143
  # @param [String] parent
2715
- # Required. The session to create a session entity type for. Supported formats: -
2716
- # `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
2717
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
2718
- # environments//users//sessions/`, If `Location ID` is not specified we assume
2719
- # default 'us' location. If `Environment ID` is not specified, we assume default
2720
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
2721
2144
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
2722
2145
  # @param [String] fields
2723
2146
  # Selector specifying which fields to include in a partial response.
@@ -2748,17 +2171,8 @@ module Google
2748
2171
  execute_or_queue_command(command, &block)
2749
2172
  end
2750
2173
 
2751
- # Deletes the specified session entity type. This method doesn't work with
2752
- # Google Assistant integration. Contact Dialogflow support if you need to use
2753
- # session entities with Google Assistant integration.
2174
+ #
2754
2175
  # @param [String] name
2755
- # Required. The name of the entity type to delete. Supported formats: - `
2756
- # projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions/
2757
- # /entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/`
2758
- # - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If
2759
- # `Location ID` is not specified we assume default 'us' location. If `
2760
- # Environment ID` is not specified, we assume default 'draft' environment. If `
2761
- # User ID` is not specified, we assume default '-' user.
2762
2176
  # @param [String] fields
2763
2177
  # Selector specifying which fields to include in a partial response.
2764
2178
  # @param [String] quota_user
@@ -2786,17 +2200,8 @@ module Google
2786
2200
  execute_or_queue_command(command, &block)
2787
2201
  end
2788
2202
 
2789
- # Retrieves the specified session entity type. This method doesn't work with
2790
- # Google Assistant integration. Contact Dialogflow support if you need to use
2791
- # session entities with Google Assistant integration.
2203
+ #
2792
2204
  # @param [String] name
2793
- # Required. The name of the session entity type. Supported formats: - `projects//
2794
- # agent/sessions//entityTypes/` - `projects//locations//agent/sessions//
2795
- # entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` -
2796
- # `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `
2797
- # Location ID` is not specified we assume default 'us' location. If `Environment
2798
- # ID` is not specified, we assume default 'draft' environment. If `User ID` is
2799
- # not specified, we assume default '-' user.
2800
2205
  # @param [String] fields
2801
2206
  # Selector specifying which fields to include in a partial response.
2802
2207
  # @param [String] quota_user
@@ -2824,21 +2229,10 @@ module Google
2824
2229
  execute_or_queue_command(command, &block)
2825
2230
  end
2826
2231
 
2827
- # Returns the list of all session entity types in the specified session. This
2828
- # method doesn't work with Google Assistant integration. Contact Dialogflow
2829
- # support if you need to use session entities with Google Assistant integration.
2232
+ #
2830
2233
  # @param [String] parent
2831
- # Required. The session to list all session entity types from. Supported formats:
2832
- # - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
2833
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
2834
- # environments//users//sessions/`, If `Location ID` is not specified we assume
2835
- # default 'us' location. If `Environment ID` is not specified, we assume default
2836
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
2837
2234
  # @param [Fixnum] page_size
2838
- # Optional. The maximum number of items to return in a single page. By default
2839
- # 100 and at most 1000.
2840
2235
  # @param [String] page_token
2841
- # Optional. The next_page_token value returned from a previous list request.
2842
2236
  # @param [String] fields
2843
2237
  # Selector specifying which fields to include in a partial response.
2844
2238
  # @param [String] quota_user
@@ -2868,22 +2262,10 @@ module Google
2868
2262
  execute_or_queue_command(command, &block)
2869
2263
  end
2870
2264
 
2871
- # Updates the specified session entity type. This method doesn't work with
2872
- # Google Assistant integration. Contact Dialogflow support if you need to use
2873
- # session entities with Google Assistant integration.
2265
+ #
2874
2266
  # @param [String] name
2875
- # Required. The unique identifier of this session entity type. Supported formats:
2876
- # - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/
2877
- # sessions//entityTypes/` - `projects//agent/environments//users//sessions//
2878
- # entityTypes/` - `projects//locations//agent/environments/ /users//sessions//
2879
- # entityTypes/` If `Location ID` is not specified we assume default 'us'
2880
- # location. If `Environment ID` is not specified, we assume default 'draft'
2881
- # environment. If `User ID` is not specified, we assume default '-' user. ``
2882
- # must be the display name of an existing entity type in the same agent that
2883
- # will be overridden or supplemented.
2884
2267
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
2885
2268
  # @param [String] update_mask
2886
- # Optional. The mask to control which fields get updated.
2887
2269
  # @param [String] fields
2888
2270
  # Selector specifying which fields to include in a partial response.
2889
2271
  # @param [String] quota_user
@@ -2914,11 +2296,8 @@ module Google
2914
2296
  execute_or_queue_command(command, &block)
2915
2297
  end
2916
2298
 
2917
- # Creates an agent version. The new version points to the agent instance in the "
2918
- # default" environment.
2299
+ #
2919
2300
  # @param [String] parent
2920
- # Required. The agent to create a version for. Supported formats: - `projects//
2921
- # agent` - `projects//locations//agent`
2922
2301
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
2923
2302
  # @param [String] fields
2924
2303
  # Selector specifying which fields to include in a partial response.
@@ -2949,10 +2328,8 @@ module Google
2949
2328
  execute_or_queue_command(command, &block)
2950
2329
  end
2951
2330
 
2952
- # Delete the specified agent version.
2331
+ #
2953
2332
  # @param [String] name
2954
- # Required. The name of the version to delete. Supported formats: - `projects//
2955
- # agent/versions/` - `projects//locations//agent/versions/`
2956
2333
  # @param [String] fields
2957
2334
  # Selector specifying which fields to include in a partial response.
2958
2335
  # @param [String] quota_user
@@ -2980,10 +2357,8 @@ module Google
2980
2357
  execute_or_queue_command(command, &block)
2981
2358
  end
2982
2359
 
2983
- # Retrieves the specified agent version.
2360
+ #
2984
2361
  # @param [String] name
2985
- # Required. The name of the version. Supported formats: - `projects//agent/
2986
- # versions/` - `projects//locations//agent/versions/`
2987
2362
  # @param [String] fields
2988
2363
  # Selector specifying which fields to include in a partial response.
2989
2364
  # @param [String] quota_user
@@ -3011,15 +2386,10 @@ module Google
3011
2386
  execute_or_queue_command(command, &block)
3012
2387
  end
3013
2388
 
3014
- # Returns the list of all versions of the specified agent.
2389
+ #
3015
2390
  # @param [String] parent
3016
- # Required. The agent to list all versions from. Supported formats: - `projects//
3017
- # agent` - `projects//locations//agent`
3018
2391
  # @param [Fixnum] page_size
3019
- # Optional. The maximum number of items to return in a single page. By default
3020
- # 100 and at most 1000.
3021
2392
  # @param [String] page_token
3022
- # Optional. The next_page_token value returned from a previous list request.
3023
2393
  # @param [String] fields
3024
2394
  # Selector specifying which fields to include in a partial response.
3025
2395
  # @param [String] quota_user
@@ -3049,15 +2419,10 @@ module Google
3049
2419
  execute_or_queue_command(command, &block)
3050
2420
  end
3051
2421
 
3052
- # Updates the specified agent version. Note that this method does not allow you
3053
- # to update the state of the agent the given version points to. It allows you to
3054
- # update only mutable properties of the version resource.
2422
+ #
3055
2423
  # @param [String] name
3056
- # Output only. The unique identifier of this agent version. Supported formats: -
3057
- # `projects//agent/versions/` - `projects//locations//agent/versions/`
3058
2424
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
3059
2425
  # @param [String] update_mask
3060
- # Required. The mask to control which fields get updated.
3061
2426
  # @param [String] fields
3062
2427
  # Selector specifying which fields to include in a partial response.
3063
2428
  # @param [String] quota_user
@@ -3088,10 +2453,8 @@ module Google
3088
2453
  execute_or_queue_command(command, &block)
3089
2454
  end
3090
2455
 
3091
- # Deprecated. Retrieves a specific answer record.
2456
+ #
3092
2457
  # @param [String] name
3093
- # Required. The name of the answer record to retrieve. Format: `projects//
3094
- # locations//answerRecords/`.
3095
2458
  # @param [String] fields
3096
2459
  # Selector specifying which fields to include in a partial response.
3097
2460
  # @param [String] quota_user
@@ -3119,26 +2482,11 @@ module Google
3119
2482
  execute_or_queue_command(command, &block)
3120
2483
  end
3121
2484
 
3122
- # Returns the list of all answer records in the specified project in reverse
3123
- # chronological order.
2485
+ #
3124
2486
  # @param [String] parent
3125
- # Required. The project to list all answer records for in reverse chronological
3126
- # order. Format: `projects//locations/`.
3127
2487
  # @param [String] filter
3128
- # Optional. Filters to restrict results to specific answer records. The
3129
- # expression has the following syntax: [AND ] ... The following fields and
3130
- # operators are supported: * conversation_id with equals(=) operator Examples: *
3131
- # "conversation_id=bar" matches answer records in the projects/foo/locations/
3132
- # global/conversations/bar conversation (assuming the parent is projects/foo/
3133
- # locations/global). For more information about filtering, see [API Filtering](
3134
- # https://aip.dev/160).
3135
2488
  # @param [Fixnum] page_size
3136
- # Optional. The maximum number of records to return in a single page. The server
3137
- # may return fewer records than this. If unspecified, we use 10. The maximum is
3138
- # 100.
3139
2489
  # @param [String] page_token
3140
- # Optional. The ListAnswerRecordsResponse.next_page_token value returned from a
3141
- # previous list request used to continue listing on the next page.
3142
2490
  # @param [String] fields
3143
2491
  # Selector specifying which fields to include in a partial response.
3144
2492
  # @param [String] quota_user
@@ -3169,13 +2517,10 @@ module Google
3169
2517
  execute_or_queue_command(command, &block)
3170
2518
  end
3171
2519
 
3172
- # Updates the specified answer record.
2520
+ #
3173
2521
  # @param [String] name
3174
- # The unique identifier of this answer record. Required for AnswerRecords.
3175
- # UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`.
3176
2522
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] google_cloud_dialogflow_v2beta1_answer_record_object
3177
2523
  # @param [String] update_mask
3178
- # Required. The mask to control which fields get updated.
3179
2524
  # @param [String] fields
3180
2525
  # Selector specifying which fields to include in a partial response.
3181
2526
  # @param [String] quota_user
@@ -3206,15 +2551,8 @@ module Google
3206
2551
  execute_or_queue_command(command, &block)
3207
2552
  end
3208
2553
 
3209
- # Clears a suggestion feature from a conversation profile for the given
3210
- # participant role. This method is a [long-running operation](https://cloud.
3211
- # google.com/dialogflow/es/docs/how/long-running-operations). The returned `
3212
- # Operation` type has the following method-specific fields: - `metadata`:
3213
- # ClearSuggestionFeatureConfigOperationMetadata - `response`:
3214
- # ConversationProfile
2554
+ #
3215
2555
  # @param [String] conversation_profile
3216
- # Required. The Conversation Profile to add or update the suggestion feature
3217
- # config. Format: `projects//locations//conversationProfiles/`.
3218
2556
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ClearSuggestionFeatureConfigRequest] google_cloud_dialogflow_v2beta1_clear_suggestion_feature_config_request_object
3219
2557
  # @param [String] fields
3220
2558
  # Selector specifying which fields to include in a partial response.
@@ -3245,12 +2583,8 @@ module Google
3245
2583
  execute_or_queue_command(command, &block)
3246
2584
  end
3247
2585
 
3248
- # Creates a conversation profile in the specified project. ConversationProfile.
3249
- # CreateTime and ConversationProfile.UpdateTime aren't populated in the response.
3250
- # You can retrieve them via GetConversationProfile API.
2586
+ #
3251
2587
  # @param [String] parent
3252
- # Required. The project to create a conversation profile for. Format: `projects//
3253
- # locations/`.
3254
2588
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] google_cloud_dialogflow_v2beta1_conversation_profile_object
3255
2589
  # @param [String] fields
3256
2590
  # Selector specifying which fields to include in a partial response.
@@ -3281,10 +2615,8 @@ module Google
3281
2615
  execute_or_queue_command(command, &block)
3282
2616
  end
3283
2617
 
3284
- # Deletes the specified conversation profile.
2618
+ #
3285
2619
  # @param [String] name
3286
- # Required. The name of the conversation profile to delete. Format: `projects//
3287
- # locations//conversationProfiles/`.
3288
2620
  # @param [String] fields
3289
2621
  # Selector specifying which fields to include in a partial response.
3290
2622
  # @param [String] quota_user
@@ -3312,10 +2644,8 @@ module Google
3312
2644
  execute_or_queue_command(command, &block)
3313
2645
  end
3314
2646
 
3315
- # Retrieves the specified conversation profile.
2647
+ #
3316
2648
  # @param [String] name
3317
- # Required. The resource name of the conversation profile. Format: `projects//
3318
- # locations//conversationProfiles/`.
3319
2649
  # @param [String] fields
3320
2650
  # Selector specifying which fields to include in a partial response.
3321
2651
  # @param [String] quota_user
@@ -3343,15 +2673,10 @@ module Google
3343
2673
  execute_or_queue_command(command, &block)
3344
2674
  end
3345
2675
 
3346
- # Returns the list of all conversation profiles in the specified project.
2676
+ #
3347
2677
  # @param [String] parent
3348
- # Required. The project to list all conversation profiles from. Format: `
3349
- # projects//locations/`.
3350
2678
  # @param [Fixnum] page_size
3351
- # The maximum number of items to return in a single page. By default 100 and at
3352
- # most 1000.
3353
2679
  # @param [String] page_token
3354
- # The next_page_token value returned from a previous list request.
3355
2680
  # @param [String] fields
3356
2681
  # Selector specifying which fields to include in a partial response.
3357
2682
  # @param [String] quota_user
@@ -3381,15 +2706,10 @@ module Google
3381
2706
  execute_or_queue_command(command, &block)
3382
2707
  end
3383
2708
 
3384
- # Updates the specified conversation profile. ConversationProfile.CreateTime and
3385
- # ConversationProfile.UpdateTime aren't populated in the response. You can
3386
- # retrieve them via GetConversationProfile API.
2709
+ #
3387
2710
  # @param [String] name
3388
- # The unique identifier of this conversation profile. Format: `projects//
3389
- # locations//conversationProfiles/`.
3390
2711
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] google_cloud_dialogflow_v2beta1_conversation_profile_object
3391
2712
  # @param [String] update_mask
3392
- # Required. The mask to control which fields to update.
3393
2713
  # @param [String] fields
3394
2714
  # Selector specifying which fields to include in a partial response.
3395
2715
  # @param [String] quota_user
@@ -3420,20 +2740,8 @@ module Google
3420
2740
  execute_or_queue_command(command, &block)
3421
2741
  end
3422
2742
 
3423
- # Adds or updates a suggestion feature in a conversation profile. If the
3424
- # conversation profile contains the type of suggestion feature for the
3425
- # participant role, it will update it. Otherwise it will insert the suggestion
3426
- # feature. This method is a [long-running operation](https://cloud.google.com/
3427
- # dialogflow/es/docs/how/long-running-operations). The returned `Operation` type
3428
- # has the following method-specific fields: - `metadata`:
3429
- # SetSuggestionFeatureConfigOperationMetadata - `response`: ConversationProfile
3430
- # If a long running operation to add or update suggestion feature config for the
3431
- # same conversation profile, participant role and suggestion feature type exists,
3432
- # please cancel the existing long running operation before sending such request,
3433
- # otherwise the request will be rejected.
2743
+ #
3434
2744
  # @param [String] conversation_profile
3435
- # Required. The Conversation Profile to add or update the suggestion feature
3436
- # config. Format: `projects//locations//conversationProfiles/`.
3437
2745
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SetSuggestionFeatureConfigRequest] google_cloud_dialogflow_v2beta1_set_suggestion_feature_config_request_object
3438
2746
  # @param [String] fields
3439
2747
  # Selector specifying which fields to include in a partial response.
@@ -3464,11 +2772,8 @@ module Google
3464
2772
  execute_or_queue_command(command, &block)
3465
2773
  end
3466
2774
 
3467
- # Completes the specified conversation. Finished conversations are purged from
3468
- # the database after 30 days.
2775
+ #
3469
2776
  # @param [String] name
3470
- # Required. Resource identifier of the conversation to close. Format: `projects//
3471
- # locations//conversations/`.
3472
2777
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CompleteConversationRequest] google_cloud_dialogflow_v2beta1_complete_conversation_request_object
3473
2778
  # @param [String] fields
3474
2779
  # Selector specifying which fields to include in a partial response.
@@ -3499,28 +2804,10 @@ module Google
3499
2804
  execute_or_queue_command(command, &block)
3500
2805
  end
3501
2806
 
3502
- # Creates a new conversation. Conversations are auto-completed after 24 hours.
3503
- # Conversation Lifecycle: There are two stages during a conversation: Automated
3504
- # Agent Stage and Assist Stage. For Automated Agent Stage, there will be a
3505
- # dialogflow agent responding to user queries. For Assist Stage, there's no
3506
- # dialogflow agent responding to user queries. But we will provide suggestions
3507
- # which are generated from conversation. If Conversation.conversation_profile is
3508
- # configured for a dialogflow agent, conversation will start from `Automated
3509
- # Agent Stage`, otherwise, it will start from `Assist Stage`. And during `
3510
- # Automated Agent Stage`, once an Intent with Intent.live_agent_handoff is
3511
- # triggered, conversation will transfer to Assist Stage.
2807
+ #
3512
2808
  # @param [String] parent
3513
- # Required. Resource identifier of the project creating the conversation. Format:
3514
- # `projects//locations/`.
3515
2809
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Conversation] google_cloud_dialogflow_v2beta1_conversation_object
3516
2810
  # @param [String] conversation_id
3517
- # Optional. Identifier of the conversation. Generally it's auto generated by
3518
- # Google. Only set it if you cannot wait for the response to return a auto-
3519
- # generated one to you. The conversation ID must be compliant with the
3520
- # regression formula `a-zA-Z*` with the characters length in range of [3,64]. If
3521
- # the field is provided, the caller is responsible for 1. the uniqueness of the
3522
- # ID, otherwise the request will be rejected. 2. the consistency for whether to
3523
- # use custom ID or not under a project to better ensure uniqueness.
3524
2811
  # @param [String] fields
3525
2812
  # Selector specifying which fields to include in a partial response.
3526
2813
  # @param [String] quota_user
@@ -3551,10 +2838,8 @@ module Google
3551
2838
  execute_or_queue_command(command, &block)
3552
2839
  end
3553
2840
 
3554
- # Retrieves the specific conversation.
2841
+ #
3555
2842
  # @param [String] name
3556
- # Required. The name of the conversation. Format: `projects//locations//
3557
- # conversations/`.
3558
2843
  # @param [String] fields
3559
2844
  # Selector specifying which fields to include in a partial response.
3560
2845
  # @param [String] quota_user
@@ -3582,21 +2867,11 @@ module Google
3582
2867
  execute_or_queue_command(command, &block)
3583
2868
  end
3584
2869
 
3585
- # Returns the list of all conversations in the specified project.
2870
+ #
3586
2871
  # @param [String] parent
3587
- # Required. The project from which to list all conversation. Format: `projects//
3588
- # locations/`.
3589
2872
  # @param [String] filter
3590
- # Optional. A filter expression that filters conversations listed in the
3591
- # response. Only `lifecycle_state` can be filtered on in this way. For example,
3592
- # the following expression only returns `COMPLETED` conversations: `
3593
- # lifecycle_state = "COMPLETED"` For more information about filtering, see [API
3594
- # Filtering](https://aip.dev/160).
3595
2873
  # @param [Fixnum] page_size
3596
- # Optional. The maximum number of items to return in a single page. By default
3597
- # 100 and at most 1000.
3598
2874
  # @param [String] page_token
3599
- # Optional. The next_page_token value returned from a previous list request.
3600
2875
  # @param [String] fields
3601
2876
  # Selector specifying which fields to include in a partial response.
3602
2877
  # @param [String] quota_user
@@ -3627,11 +2902,8 @@ module Google
3627
2902
  execute_or_queue_command(command, &block)
3628
2903
  end
3629
2904
 
3630
- # Batch ingests messages to conversation. Customers can use this RPC to ingest
3631
- # historical messages to conversation.
2905
+ #
3632
2906
  # @param [String] parent
3633
- # Required. Resource identifier of the conversation to create message. Format: `
3634
- # projects//locations//conversations/`.
3635
2907
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchCreateMessagesRequest] google_cloud_dialogflow_v2beta1_batch_create_messages_request_object
3636
2908
  # @param [String] fields
3637
2909
  # Selector specifying which fields to include in a partial response.
@@ -3662,24 +2934,11 @@ module Google
3662
2934
  execute_or_queue_command(command, &block)
3663
2935
  end
3664
2936
 
3665
- # Lists messages that belong to a given conversation. `messages` are ordered by `
3666
- # create_time` in descending order. To fetch updates without duplication, send
3667
- # request with filter `create_time_epoch_microseconds > [first item's
3668
- # create_time of previous request]` and empty page_token.
2937
+ #
3669
2938
  # @param [String] parent
3670
- # Required. The name of the conversation to list messages for. Format: `projects/
3671
- # /locations//conversations/`
3672
2939
  # @param [String] filter
3673
- # Optional. Filter on message fields. Currently predicates on `create_time` and `
3674
- # create_time_epoch_microseconds` are supported. `create_time` only support
3675
- # milliseconds accuracy. E.g., `create_time_epoch_microseconds >
3676
- # 1551790877964485` or `create_time > "2017-01-15T01:30:15.01Z"`. For more
3677
- # information about filtering, see [API Filtering](https://aip.dev/160).
3678
2940
  # @param [Fixnum] page_size
3679
- # Optional. The maximum number of items to return in a single page. By default
3680
- # 100 and at most 1000.
3681
2941
  # @param [String] page_token
3682
- # Optional. The next_page_token value returned from a previous list request.
3683
2942
  # @param [String] fields
3684
2943
  # Selector specifying which fields to include in a partial response.
3685
2944
  # @param [String] quota_user
@@ -3710,13 +2969,8 @@ module Google
3710
2969
  execute_or_queue_command(command, &block)
3711
2970
  end
3712
2971
 
3713
- # Adds a text (chat, for example), or audio (phone recording, for example)
3714
- # message from a participant into the conversation. Note: Always use agent
3715
- # versions for production traffic sent to virtual agents. See [Versions and
3716
- # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
2972
+ #
3717
2973
  # @param [String] participant
3718
- # Required. The name of the participant this text comes from. Format: `projects//
3719
- # locations//conversations//participants/`.
3720
2974
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnalyzeContentRequest] google_cloud_dialogflow_v2beta1_analyze_content_request_object
3721
2975
  # @param [String] fields
3722
2976
  # Selector specifying which fields to include in a partial response.
@@ -3747,10 +3001,8 @@ module Google
3747
3001
  execute_or_queue_command(command, &block)
3748
3002
  end
3749
3003
 
3750
- # Creates a new participant in a conversation.
3004
+ #
3751
3005
  # @param [String] parent
3752
- # Required. Resource identifier of the conversation adding the participant.
3753
- # Format: `projects//locations//conversations/`.
3754
3006
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Participant] google_cloud_dialogflow_v2beta1_participant_object
3755
3007
  # @param [String] fields
3756
3008
  # Selector specifying which fields to include in a partial response.
@@ -3781,10 +3033,8 @@ module Google
3781
3033
  execute_or_queue_command(command, &block)
3782
3034
  end
3783
3035
 
3784
- # Retrieves a conversation participant.
3036
+ #
3785
3037
  # @param [String] name
3786
- # Required. The name of the participant. Format: `projects//locations//
3787
- # conversations//participants/`.
3788
3038
  # @param [String] fields
3789
3039
  # Selector specifying which fields to include in a partial response.
3790
3040
  # @param [String] quota_user
@@ -3812,15 +3062,10 @@ module Google
3812
3062
  execute_or_queue_command(command, &block)
3813
3063
  end
3814
3064
 
3815
- # Returns the list of all participants in the specified conversation.
3065
+ #
3816
3066
  # @param [String] parent
3817
- # Required. The conversation to list all participants from. Format: `projects//
3818
- # locations//conversations/`.
3819
3067
  # @param [Fixnum] page_size
3820
- # Optional. The maximum number of items to return in a single page. By default
3821
- # 100 and at most 1000.
3822
3068
  # @param [String] page_token
3823
- # Optional. The next_page_token value returned from a previous list request.
3824
3069
  # @param [String] fields
3825
3070
  # Selector specifying which fields to include in a partial response.
3826
3071
  # @param [String] quota_user
@@ -3850,13 +3095,10 @@ module Google
3850
3095
  execute_or_queue_command(command, &block)
3851
3096
  end
3852
3097
 
3853
- # Updates the specified participant.
3098
+ #
3854
3099
  # @param [String] name
3855
- # Optional. The unique identifier of this participant. Format: `projects//
3856
- # locations//conversations//participants/`.
3857
3100
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Participant] google_cloud_dialogflow_v2beta1_participant_object
3858
3101
  # @param [String] update_mask
3859
- # Required. The mask to specify which fields to update.
3860
3102
  # @param [String] fields
3861
3103
  # Selector specifying which fields to include in a partial response.
3862
3104
  # @param [String] quota_user
@@ -3887,14 +3129,8 @@ module Google
3887
3129
  execute_or_queue_command(command, &block)
3888
3130
  end
3889
3131
 
3890
- # Deprecated. use SuggestArticles and SuggestFaqAnswers instead. Gets
3891
- # suggestions for a participant based on specific historical messages. Note that
3892
- # ListSuggestions will only list the auto-generated suggestions, while
3893
- # CompileSuggestion will try to compile suggestion based on the provided
3894
- # conversation context in the real time.
3132
+ #
3895
3133
  # @param [String] parent
3896
- # Required. The name of the participant to fetch suggestion for. Format: `
3897
- # projects//locations//conversations//participants/`.
3898
3134
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CompileSuggestionRequest] google_cloud_dialogflow_v2beta1_compile_suggestion_request_object
3899
3135
  # @param [String] fields
3900
3136
  # Selector specifying which fields to include in a partial response.
@@ -3925,32 +3161,11 @@ module Google
3925
3161
  execute_or_queue_command(command, &block)
3926
3162
  end
3927
3163
 
3928
- # Deprecated: Use inline suggestion, event based suggestion or Suggestion* API
3929
- # instead. See HumanAgentAssistantConfig.name for more details. Removal Date:
3930
- # 2020-09-01. Retrieves suggestions for live agents. This method should be used
3931
- # by human agent client software to fetch auto generated suggestions in real-
3932
- # time, while the conversation with an end user is in progress. The
3933
- # functionality is implemented in terms of the [list pagination](https://cloud.
3934
- # google.com/apis/design/design_patterns#list_pagination) design pattern. The
3935
- # client app should use the `next_page_token` field to fetch the next batch of
3936
- # suggestions. `suggestions` are sorted by `create_time` in descending order. To
3937
- # fetch latest suggestion, just set `page_size` to 1. To fetch new suggestions
3938
- # without duplication, send request with filter `create_time_epoch_microseconds >
3939
- # [first item's create_time of previous request]` and empty page_token.
3164
+ #
3940
3165
  # @param [String] parent
3941
- # Required. The name of the participant to fetch suggestions for. Format: `
3942
- # projects//locations//conversations//participants/`.
3943
3166
  # @param [String] filter
3944
- # Optional. Filter on suggestions fields. Currently predicates on `create_time`
3945
- # and `create_time_epoch_microseconds` are supported. `create_time` only support
3946
- # milliseconds accuracy. E.g., `create_time_epoch_microseconds >
3947
- # 1551790877964485` or `create_time > "2017-01-15T01:30:15.01Z"` For more
3948
- # information about filtering, see [API Filtering](https://aip.dev/160).
3949
3167
  # @param [Fixnum] page_size
3950
- # Optional. The maximum number of items to return in a single page. The default
3951
- # value is 100; the maximum value is 1000.
3952
3168
  # @param [String] page_token
3953
- # Optional. The next_page_token value returned from a previous list request.
3954
3169
  # @param [String] fields
3955
3170
  # Selector specifying which fields to include in a partial response.
3956
3171
  # @param [String] quota_user
@@ -3981,13 +3196,8 @@ module Google
3981
3196
  execute_or_queue_command(command, &block)
3982
3197
  end
3983
3198
 
3984
- # Gets suggested articles for a participant based on specific historical
3985
- # messages. Note that ListSuggestions will only list the auto-generated
3986
- # suggestions, while CompileSuggestion will try to compile suggestion based on
3987
- # the provided conversation context in the real time.
3199
+ #
3988
3200
  # @param [String] parent
3989
- # Required. The name of the participant to fetch suggestion for. Format: `
3990
- # projects//locations//conversations//participants/`.
3991
3201
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestArticlesRequest] google_cloud_dialogflow_v2beta1_suggest_articles_request_object
3992
3202
  # @param [String] fields
3993
3203
  # Selector specifying which fields to include in a partial response.
@@ -4018,11 +3228,8 @@ module Google
4018
3228
  execute_or_queue_command(command, &block)
4019
3229
  end
4020
3230
 
4021
- # Gets suggested faq answers for a participant based on specific historical
4022
- # messages.
3231
+ #
4023
3232
  # @param [String] parent
4024
- # Required. The name of the participant to fetch suggestion for. Format: `
4025
- # projects//locations//conversations//participants/`.
4026
3233
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestFaqAnswersRequest] google_cloud_dialogflow_v2beta1_suggest_faq_answers_request_object
4027
3234
  # @param [String] fields
4028
3235
  # Selector specifying which fields to include in a partial response.
@@ -4053,10 +3260,8 @@ module Google
4053
3260
  execute_or_queue_command(command, &block)
4054
3261
  end
4055
3262
 
4056
- # Gets knowledge assist suggestions based on historical messages.
3263
+ #
4057
3264
  # @param [String] parent
4058
- # Required. The name of the participant to fetch suggestions for. Format: `
4059
- # projects//locations//conversations//participants/`.
4060
3265
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestKnowledgeAssistRequest] google_cloud_dialogflow_v2beta1_suggest_knowledge_assist_request_object
4061
3266
  # @param [String] fields
4062
3267
  # Selector specifying which fields to include in a partial response.
@@ -4087,10 +3292,8 @@ module Google
4087
3292
  execute_or_queue_command(command, &block)
4088
3293
  end
4089
3294
 
4090
- # Gets smart replies for a participant based on specific historical messages.
3295
+ #
4091
3296
  # @param [String] parent
4092
- # Required. The name of the participant to fetch suggestion for. Format: `
4093
- # projects//locations//conversations//participants/`.
4094
3297
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestSmartRepliesRequest] google_cloud_dialogflow_v2beta1_suggest_smart_replies_request_object
4095
3298
  # @param [String] fields
4096
3299
  # Selector specifying which fields to include in a partial response.
@@ -4121,13 +3324,8 @@ module Google
4121
3324
  execute_or_queue_command(command, &block)
4122
3325
  end
4123
3326
 
4124
- # Generates all the suggestions using generators configured in the conversation
4125
- # profile. A generator is used only if its trigger event is matched.
3327
+ #
4126
3328
  # @param [String] conversation
4127
- # Required. The conversation for which the suggestions are generated. Format: `
4128
- # projects//locations//conversations/`. The conversation must be created with a
4129
- # conversation profile which has generators configured in it to be able to get
4130
- # suggestions.
4131
3329
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1GenerateSuggestionsRequest] google_cloud_dialogflow_v2beta1_generate_suggestions_request_object
4132
3330
  # @param [String] fields
4133
3331
  # Selector specifying which fields to include in a partial response.
@@ -4158,10 +3356,8 @@ module Google
4158
3356
  execute_or_queue_command(command, &block)
4159
3357
  end
4160
3358
 
4161
- # Get answers for the given query based on knowledge documents.
3359
+ #
4162
3360
  # @param [String] conversation
4163
- # Optional. The conversation (between human agent and end user) where the search
4164
- # request is triggered. Format: `projects//locations//conversations/`.
4165
3361
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SearchKnowledgeRequest] google_cloud_dialogflow_v2beta1_search_knowledge_request_object
4166
3362
  # @param [String] fields
4167
3363
  # Selector specifying which fields to include in a partial response.
@@ -4192,11 +3388,8 @@ module Google
4192
3388
  execute_or_queue_command(command, &block)
4193
3389
  end
4194
3390
 
4195
- # Suggest summary for a conversation based on specific historical messages. The
4196
- # range of the messages to be used for summary can be specified in the request.
3391
+ #
4197
3392
  # @param [String] conversation
4198
- # Required. The conversation to fetch suggestion for. Format: `projects//
4199
- # locations//conversations/`.
4200
3393
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestConversationSummaryRequest] google_cloud_dialogflow_v2beta1_suggest_conversation_summary_request_object
4201
3394
  # @param [String] fields
4202
3395
  # Selector specifying which fields to include in a partial response.
@@ -4227,19 +3420,10 @@ module Google
4227
3420
  execute_or_queue_command(command, &block)
4228
3421
  end
4229
3422
 
4230
- # Creates a generator.
3423
+ #
4231
3424
  # @param [String] parent
4232
- # Required. The project/location to create generator for. Format: `projects//
4233
- # locations/`
4234
3425
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Generator] google_cloud_dialogflow_v2beta1_generator_object
4235
3426
  # @param [String] generator_id
4236
- # Optional. The ID to use for the generator, which will become the final
4237
- # component of the generator's resource name. The generator ID must be compliant
4238
- # with the regression formula `a-zA-Z*` with the characters length in range of [
4239
- # 3,64]. If the field is not provided, an Id will be auto-generated. If the
4240
- # field is provided, the caller is responsible for 1. the uniqueness of the ID,
4241
- # otherwise the request will be rejected. 2. the consistency for whether to use
4242
- # custom ID or not under a project to better ensure uniqueness.
4243
3427
  # @param [String] fields
4244
3428
  # Selector specifying which fields to include in a partial response.
4245
3429
  # @param [String] quota_user
@@ -4270,15 +3454,10 @@ module Google
4270
3454
  execute_or_queue_command(command, &block)
4271
3455
  end
4272
3456
 
4273
- # Lists generators.
3457
+ #
4274
3458
  # @param [String] parent
4275
- # Required. The project/location to list generators for. Format: `projects//
4276
- # locations/`
4277
3459
  # @param [Fixnum] page_size
4278
- # Optional. Maximum number of conversation models to return in a single page.
4279
- # Default to 10.
4280
3460
  # @param [String] page_token
4281
- # Optional. The next_page_token value returned from a previous list request.
4282
3461
  # @param [String] fields
4283
3462
  # Selector specifying which fields to include in a partial response.
4284
3463
  # @param [String] quota_user
@@ -4308,11 +3487,8 @@ module Google
4308
3487
  execute_or_queue_command(command, &block)
4309
3488
  end
4310
3489
 
4311
- # Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource
4312
- # is deprecated; only use `projects.knowledgeBases`.
3490
+ #
4313
3491
  # @param [String] parent
4314
- # Required. The project to create a knowledge base for. Format: `projects//
4315
- # locations/`.
4316
3492
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1KnowledgeBase] google_cloud_dialogflow_v2beta1_knowledge_base_object
4317
3493
  # @param [String] fields
4318
3494
  # Selector specifying which fields to include in a partial response.
@@ -4343,14 +3519,9 @@ module Google
4343
3519
  execute_or_queue_command(command, &block)
4344
3520
  end
4345
3521
 
4346
- # Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases`
4347
- # resource is deprecated; only use `projects.knowledgeBases`.
3522
+ #
4348
3523
  # @param [String] name
4349
- # Required. The name of the knowledge base to delete. Format: `projects//
4350
- # locations//knowledgeBases/`.
4351
3524
  # @param [Boolean] force
4352
- # Optional. Force deletes the knowledge base. When set to true, any documents in
4353
- # the knowledge base are also deleted.
4354
3525
  # @param [String] fields
4355
3526
  # Selector specifying which fields to include in a partial response.
4356
3527
  # @param [String] quota_user
@@ -4379,11 +3550,8 @@ module Google
4379
3550
  execute_or_queue_command(command, &block)
4380
3551
  end
4381
3552
 
4382
- # Retrieves the specified knowledge base. Note: The `projects.agent.
4383
- # knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
3553
+ #
4384
3554
  # @param [String] name
4385
- # Required. The name of the knowledge base to retrieve. Format `projects//
4386
- # locations//knowledgeBases/`.
4387
3555
  # @param [String] fields
4388
3556
  # Selector specifying which fields to include in a partial response.
4389
3557
  # @param [String] quota_user
@@ -4411,30 +3579,11 @@ module Google
4411
3579
  execute_or_queue_command(command, &block)
4412
3580
  end
4413
3581
 
4414
- # Returns the list of all knowledge bases of the specified agent. Note: The `
4415
- # projects.agent.knowledgeBases` resource is deprecated; only use `projects.
4416
- # knowledgeBases`.
3582
+ #
4417
3583
  # @param [String] parent
4418
- # Required. The project to list of knowledge bases for. Format: `projects//
4419
- # locations/`.
4420
3584
  # @param [String] filter
4421
- # The filter expression used to filter knowledge bases returned by the list
4422
- # method. The expression has the following syntax: [AND ] ... The following
4423
- # fields and operators are supported: * display_name with has(:) operator *
4424
- # language_code with equals(=) operator Examples: * 'language_code=en-us'
4425
- # matches knowledge bases with en-us language code. * 'display_name:articles'
4426
- # matches knowledge bases whose display name contains "articles". * '
4427
- # display_name:"Best Articles"' matches knowledge bases whose display name
4428
- # contains "Best Articles". * 'language_code=en-gb AND display_name=articles'
4429
- # matches all knowledge bases whose display name contains "articles" and whose
4430
- # language code is "en-gb". Note: An empty filter string (i.e. "") is a no-op
4431
- # and will result in no filtering. For more information about filtering, see [
4432
- # API Filtering](https://aip.dev/160).
4433
3585
  # @param [Fixnum] page_size
4434
- # The maximum number of items to return in a single page. By default 10 and at
4435
- # most 100.
4436
3586
  # @param [String] page_token
4437
- # The next_page_token value returned from a previous list request.
4438
3587
  # @param [String] fields
4439
3588
  # Selector specifying which fields to include in a partial response.
4440
3589
  # @param [String] quota_user
@@ -4465,16 +3614,10 @@ module Google
4465
3614
  execute_or_queue_command(command, &block)
4466
3615
  end
4467
3616
 
4468
- # Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases`
4469
- # resource is deprecated; only use `projects.knowledgeBases`.
3617
+ #
4470
3618
  # @param [String] name
4471
- # The knowledge base resource name. The name must be empty when creating a
4472
- # knowledge base. Format: `projects//locations//knowledgeBases/`.
4473
3619
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1KnowledgeBase] google_cloud_dialogflow_v2beta1_knowledge_base_object
4474
3620
  # @param [String] update_mask
4475
- # Optional. Not specified means `update all`. Currently, only `display_name` can
4476
- # be updated, an InvalidArgument will be returned for attempting to update other
4477
- # fields.
4478
3621
  # @param [String] fields
4479
3622
  # Selector specifying which fields to include in a partial response.
4480
3623
  # @param [String] quota_user
@@ -4505,19 +3648,10 @@ module Google
4505
3648
  execute_or_queue_command(command, &block)
4506
3649
  end
4507
3650
 
4508
- # Creates a new document. This method is a [long-running operation](https://
4509
- # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
4510
- # Operation` type has the following method-specific fields: - `metadata`:
4511
- # KnowledgeOperationMetadata - `response`: Document Note: The `projects.agent.
4512
- # knowledgeBases.documents` resource is deprecated; only use `projects.
4513
- # knowledgeBases.documents`.
3651
+ #
4514
3652
  # @param [String] parent
4515
- # Required. The knowledge base to create a document for. Format: `projects//
4516
- # locations//knowledgeBases/`.
4517
3653
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
4518
3654
  # @param [Boolean] import_gcs_custom_metadata
4519
- # Whether to import custom metadata from Google Cloud Storage. Only valid when
4520
- # the document source is Google Cloud Storage URI.
4521
3655
  # @param [String] fields
4522
3656
  # Selector specifying which fields to include in a partial response.
4523
3657
  # @param [String] quota_user
@@ -4548,16 +3682,8 @@ module Google
4548
3682
  execute_or_queue_command(command, &block)
4549
3683
  end
4550
3684
 
4551
- # Deletes the specified document. This method is a [long-running operation](
4552
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
4553
- # returned `Operation` type has the following method-specific fields: - `
4554
- # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
4555
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
4556
- # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
4557
- # only use `projects.knowledgeBases.documents`.
3685
+ #
4558
3686
  # @param [String] name
4559
- # Required. The name of the document to delete. Format: `projects//locations//
4560
- # knowledgeBases//documents/`.
4561
3687
  # @param [String] fields
4562
3688
  # Selector specifying which fields to include in a partial response.
4563
3689
  # @param [String] quota_user
@@ -4585,12 +3711,8 @@ module Google
4585
3711
  execute_or_queue_command(command, &block)
4586
3712
  end
4587
3713
 
4588
- # Retrieves the specified document. Note: The `projects.agent.knowledgeBases.
4589
- # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
4590
- # .
3714
+ #
4591
3715
  # @param [String] name
4592
- # Required. The name of the document to retrieve. Format `projects//locations//
4593
- # knowledgeBases//documents/`.
4594
3716
  # @param [String] fields
4595
3717
  # Selector specifying which fields to include in a partial response.
4596
3718
  # @param [String] quota_user
@@ -4618,15 +3740,8 @@ module Google
4618
3740
  execute_or_queue_command(command, &block)
4619
3741
  end
4620
3742
 
4621
- # Create documents by importing data from external sources. Dialogflow supports
4622
- # up to 350 documents in each request. If you try to import more, Dialogflow
4623
- # will return an error. This method is a [long-running operation](https://cloud.
4624
- # google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
4625
- # Operation` type has the following method-specific fields: - `metadata`:
4626
- # KnowledgeOperationMetadata - `response`: ImportDocumentsResponse
3743
+ #
4627
3744
  # @param [String] parent
4628
- # Required. The knowledge base to import documents into. Format: `projects//
4629
- # locations//knowledgeBases/`.
4630
3745
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ImportDocumentsRequest] google_cloud_dialogflow_v2beta1_import_documents_request_object
4631
3746
  # @param [String] fields
4632
3747
  # Selector specifying which fields to include in a partial response.
@@ -4657,27 +3772,11 @@ module Google
4657
3772
  execute_or_queue_command(command, &block)
4658
3773
  end
4659
3774
 
4660
- # Returns the list of all documents of the knowledge base. Note: The `projects.
4661
- # agent.knowledgeBases.documents` resource is deprecated; only use `projects.
4662
- # knowledgeBases.documents`.
3775
+ #
4663
3776
  # @param [String] parent
4664
- # Required. The knowledge base to list all documents for. Format: `projects//
4665
- # locations//knowledgeBases/`.
4666
3777
  # @param [String] filter
4667
- # The filter expression used to filter documents returned by the list method.
4668
- # The expression has the following syntax: [AND ] ... The following fields and
4669
- # operators are supported: * knowledge_types with has(:) operator * display_name
4670
- # with has(:) operator * state with equals(=) operator Examples: * "
4671
- # knowledge_types:FAQ" matches documents with FAQ knowledge type. * "
4672
- # display_name:customer" matches documents whose display name contains "customer"
4673
- # . * "state=ACTIVE" matches documents with ACTIVE state. * "knowledge_types:FAQ
4674
- # AND state=ACTIVE" matches all active FAQ documents. For more information about
4675
- # filtering, see [API Filtering](https://aip.dev/160).
4676
3778
  # @param [Fixnum] page_size
4677
- # The maximum number of items to return in a single page. By default 10 and at
4678
- # most 100.
4679
3779
  # @param [String] page_token
4680
- # The next_page_token value returned from a previous list request.
4681
3780
  # @param [String] fields
4682
3781
  # Selector specifying which fields to include in a partial response.
4683
3782
  # @param [String] quota_user
@@ -4708,20 +3807,10 @@ module Google
4708
3807
  execute_or_queue_command(command, &block)
4709
3808
  end
4710
3809
 
4711
- # Updates the specified document. This method is a [long-running operation](
4712
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
4713
- # returned `Operation` type has the following method-specific fields: - `
4714
- # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
4715
- # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
4716
- # projects.knowledgeBases.documents`.
3810
+ #
4717
3811
  # @param [String] name
4718
- # Optional. The document resource name. The name must be empty when creating a
4719
- # document. Format: `projects//locations//knowledgeBases//documents/`.
4720
3812
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
4721
3813
  # @param [String] update_mask
4722
- # Optional. Not specified means `update all`. Currently, only `display_name` can
4723
- # be updated, an InvalidArgument will be returned for attempting to update other
4724
- # fields.
4725
3814
  # @param [String] fields
4726
3815
  # Selector specifying which fields to include in a partial response.
4727
3816
  # @param [String] quota_user
@@ -4752,21 +3841,8 @@ module Google
4752
3841
  execute_or_queue_command(command, &block)
4753
3842
  end
4754
3843
 
4755
- # Reloads the specified document from its specified source, content_uri or
4756
- # content. The previously loaded content of the document will be deleted. Note:
4757
- # Even when the content of the document has not changed, there still may be side
4758
- # effects because of internal implementation changes. Note: If the document
4759
- # source is Google Cloud Storage URI, its metadata will be replaced with the
4760
- # custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata`
4761
- # field is set to true in the request. This method is a [long-running operation](
4762
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
4763
- # returned `Operation` type has the following method-specific fields: - `
4764
- # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
4765
- # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
4766
- # projects.knowledgeBases.documents`.
3844
+ #
4767
3845
  # @param [String] name
4768
- # Required. The name of the document to reload. Format: `projects//locations//
4769
- # knowledgeBases//documents/`
4770
3846
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ReloadDocumentRequest] google_cloud_dialogflow_v2beta1_reload_document_request_object
4771
3847
  # @param [String] fields
4772
3848
  # Selector specifying which fields to include in a partial response.
@@ -4797,10 +3873,8 @@ module Google
4797
3873
  execute_or_queue_command(command, &block)
4798
3874
  end
4799
3875
 
4800
- # Deletes the specified agent.
3876
+ #
4801
3877
  # @param [String] parent
4802
- # Required. The project that the agent to delete is associated with. Format: `
4803
- # projects/` or `projects//locations/`.
4804
3878
  # @param [String] fields
4805
3879
  # Selector specifying which fields to include in a partial response.
4806
3880
  # @param [String] quota_user
@@ -4828,9 +3902,8 @@ module Google
4828
3902
  execute_or_queue_command(command, &block)
4829
3903
  end
4830
3904
 
4831
- # Gets information about a location.
3905
+ #
4832
3906
  # @param [String] name
4833
- # Resource name for the location.
4834
3907
  # @param [String] fields
4835
3908
  # Selector specifying which fields to include in a partial response.
4836
3909
  # @param [String] quota_user
@@ -4858,10 +3931,8 @@ module Google
4858
3931
  execute_or_queue_command(command, &block)
4859
3932
  end
4860
3933
 
4861
- # Retrieves the specified agent.
3934
+ #
4862
3935
  # @param [String] parent
4863
- # Required. The project that the agent to fetch is associated with. Format: `
4864
- # projects/` or `projects//locations/`.
4865
3936
  # @param [String] fields
4866
3937
  # Selector specifying which fields to include in a partial response.
4867
3938
  # @param [String] quota_user
@@ -4889,9 +3960,8 @@ module Google
4889
3960
  execute_or_queue_command(command, &block)
4890
3961
  end
4891
3962
 
4892
- # Gets location-level encryption key specification.
3963
+ #
4893
3964
  # @param [String] name
4894
- # Required. The name of the encryption spec resource to get.
4895
3965
  # @param [String] fields
4896
3966
  # Selector specifying which fields to include in a partial response.
4897
3967
  # @param [String] quota_user
@@ -4919,22 +3989,12 @@ module Google
4919
3989
  execute_or_queue_command(command, &block)
4920
3990
  end
4921
3991
 
4922
- # Lists information about the supported locations for this service.
3992
+ #
4923
3993
  # @param [String] name
4924
- # The resource that owns the locations collection, if applicable.
4925
3994
  # @param [Array<String>, String] extra_location_types
4926
- # Optional. Do not use this field. It is unsupported and is ignored unless
4927
- # explicitly documented otherwise. This is primarily for internal usage.
4928
3995
  # @param [String] filter
4929
- # A filter to narrow down results to a preferred subset. The filtering language
4930
- # accepts strings like `"displayName=tokyo"`, and is documented in more detail
4931
- # in [AIP-160](https://google.aip.dev/160).
4932
3996
  # @param [Fixnum] page_size
4933
- # The maximum number of results to return. If not set, the service selects a
4934
- # default.
4935
3997
  # @param [String] page_token
4936
- # A page token received from the `next_page_token` field in the response. Send
4937
- # that page token to receive the subsequent page.
4938
3998
  # @param [String] fields
4939
3999
  # Selector specifying which fields to include in a partial response.
4940
4000
  # @param [String] quota_user
@@ -4966,15 +4026,10 @@ module Google
4966
4026
  execute_or_queue_command(command, &block)
4967
4027
  end
4968
4028
 
4969
- # Creates/updates the specified agent. Note: You should always train an agent
4970
- # prior to sending it queries. See the [training documentation](https://cloud.
4971
- # google.com/dialogflow/es/docs/training).
4029
+ #
4972
4030
  # @param [String] parent
4973
- # Required. The project of this agent. Format: `projects/` or `projects//
4974
- # locations/`
4975
4031
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Agent] google_cloud_dialogflow_v2beta1_agent_object
4976
4032
  # @param [String] update_mask
4977
- # Optional. The mask to control which fields get updated.
4978
4033
  # @param [String] fields
4979
4034
  # Selector specifying which fields to include in a partial response.
4980
4035
  # @param [String] quota_user
@@ -5005,15 +4060,8 @@ module Google
5005
4060
  execute_or_queue_command(command, &block)
5006
4061
  end
5007
4062
 
5008
- # Exports the specified agent to a ZIP file. This method is a [long-running
5009
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
5010
- # operations). The returned `Operation` type has the following method-specific
5011
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
5012
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`:
5013
- # ExportAgentResponse
4063
+ #
5014
4064
  # @param [String] parent
5015
- # Required. The project that the agent to export is associated with. Format: `
5016
- # projects/` or `projects//locations/`.
5017
4065
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ExportAgentRequest] google_cloud_dialogflow_v2beta1_export_agent_request_object
5018
4066
  # @param [String] fields
5019
4067
  # Selector specifying which fields to include in a partial response.
@@ -5044,10 +4092,8 @@ module Google
5044
4092
  execute_or_queue_command(command, &block)
5045
4093
  end
5046
4094
 
5047
- # Retrieves the fulfillment.
4095
+ #
5048
4096
  # @param [String] name
5049
- # Required. The name of the fulfillment. Supported formats: - `projects//agent/
5050
- # fulfillment` - `projects//locations//agent/fulfillment`
5051
4097
  # @param [String] fields
5052
4098
  # Selector specifying which fields to include in a partial response.
5053
4099
  # @param [String] quota_user
@@ -5075,16 +4121,9 @@ module Google
5075
4121
  execute_or_queue_command(command, &block)
5076
4122
  end
5077
4123
 
5078
- # Gets agent validation result. Agent validation is performed during training
5079
- # time and is updated automatically when training is completed.
4124
+ #
5080
4125
  # @param [String] parent
5081
- # Required. The project that the agent is associated with. Format: `projects/`
5082
- # or `projects//locations/`.
5083
4126
  # @param [String] language_code
5084
- # Optional. The language for which you want a validation result. If not
5085
- # specified, the agent's default language is used. [Many languages](https://
5086
- # cloud.google.com/dialogflow/docs/reference/language) are supported. Note:
5087
- # languages must be enabled in the agent before they can be used.
5088
4127
  # @param [String] fields
5089
4128
  # Selector specifying which fields to include in a partial response.
5090
4129
  # @param [String] quota_user
@@ -5113,25 +4152,8 @@ module Google
5113
4152
  execute_or_queue_command(command, &block)
5114
4153
  end
5115
4154
 
5116
- # Imports the specified agent from a ZIP file. Uploads new intents and entity
5117
- # types without deleting the existing ones. Intents and entity types with the
5118
- # same name are replaced with the new versions from ImportAgentRequest. After
5119
- # the import, the imported draft agent will be trained automatically (unless
5120
- # disabled in agent settings). However, once the import is done, training may
5121
- # not be completed yet. Please call TrainAgent and wait for the operation it
5122
- # returns in order to train explicitly. This method is a [long-running operation]
5123
- # (https://cloud.google.com/dialogflow/es/docs/how/long-running-operations). The
5124
- # returned `Operation` type has the following method-specific fields: - `
5125
- # metadata`: An empty [Struct message](https://developers.google.com/protocol-
5126
- # buffers/docs/reference/google.protobuf#struct) - `response`: An [Empty message]
5127
- # (https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
5128
- # empty) The operation only tracks when importing is complete, not when it is
5129
- # done training. Note: You should always train an agent prior to sending it
5130
- # queries. See the [training documentation](https://cloud.google.com/dialogflow/
5131
- # es/docs/training).
4155
+ #
5132
4156
  # @param [String] parent
5133
- # Required. The project that the agent to import is associated with. Format: `
5134
- # projects/` or `projects//locations/`.
5135
4157
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ImportAgentRequest] google_cloud_dialogflow_v2beta1_import_agent_request_object
5136
4158
  # @param [String] fields
5137
4159
  # Selector specifying which fields to include in a partial response.
@@ -5162,24 +4184,8 @@ module Google
5162
4184
  execute_or_queue_command(command, &block)
5163
4185
  end
5164
4186
 
5165
- # Restores the specified agent from a ZIP file. Replaces the current agent
5166
- # version with a new one. All the intents and entity types in the older version
5167
- # are deleted. After the restore, the restored draft agent will be trained
5168
- # automatically (unless disabled in agent settings). However, once the restore
5169
- # is done, training may not be completed yet. Please call TrainAgent and wait
5170
- # for the operation it returns in order to train explicitly. This method is a [
5171
- # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
5172
- # running-operations). The returned `Operation` type has the following method-
5173
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
5174
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
5175
- # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
5176
- # reference/google.protobuf#empty) The operation only tracks when restoring is
5177
- # complete, not when it is done training. Note: You should always train an agent
5178
- # prior to sending it queries. See the [training documentation](https://cloud.
5179
- # google.com/dialogflow/es/docs/training).
4187
+ #
5180
4188
  # @param [String] parent
5181
- # Required. The project that the agent to restore is associated with. Format: `
5182
- # projects/` or `projects//locations/`.
5183
4189
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1RestoreAgentRequest] google_cloud_dialogflow_v2beta1_restore_agent_request_object
5184
4190
  # @param [String] fields
5185
4191
  # Selector specifying which fields to include in a partial response.
@@ -5210,19 +4216,10 @@ module Google
5210
4216
  execute_or_queue_command(command, &block)
5211
4217
  end
5212
4218
 
5213
- # Returns the list of agents. Since there is at most one conversational agent
5214
- # per project, this method is useful primarily for listing all agents across
5215
- # projects the caller has access to. One can achieve that with a wildcard
5216
- # project collection id "-". Refer to [List Sub-Collections](https://cloud.
5217
- # google.com/apis/design/design_patterns#list_sub-collections).
4219
+ #
5218
4220
  # @param [String] parent
5219
- # Required. The project to list agents from. Format: `projects/` or `projects//
5220
- # locations/`.
5221
4221
  # @param [Fixnum] page_size
5222
- # Optional. The maximum number of items to return in a single page. By default
5223
- # 100 and at most 1000.
5224
4222
  # @param [String] page_token
5225
- # Optional. The next_page_token value returned from a previous list request.
5226
4223
  # @param [String] fields
5227
4224
  # Selector specifying which fields to include in a partial response.
5228
4225
  # @param [String] quota_user
@@ -5252,17 +4249,8 @@ module Google
5252
4249
  execute_or_queue_command(command, &block)
5253
4250
  end
5254
4251
 
5255
- # Trains the specified agent. This method is a [long-running operation](https://
5256
- # cloud.google.com/dialogflow/es/docs/how/long-running-operations). The returned
5257
- # `Operation` type has the following method-specific fields: - `metadata`: An
5258
- # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
5259
- # reference/google.protobuf#struct) - `response`: An [Empty message](https://
5260
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
5261
- # Note: You should always train an agent prior to sending it queries. See the [
5262
- # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
4252
+ #
5263
4253
  # @param [String] parent
5264
- # Required. The project that the agent to train is associated with. Format: `
5265
- # projects/` or `projects//locations/`.
5266
4254
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1TrainAgentRequest] google_cloud_dialogflow_v2beta1_train_agent_request_object
5267
4255
  # @param [String] fields
5268
4256
  # Selector specifying which fields to include in a partial response.
@@ -5293,15 +4281,10 @@ module Google
5293
4281
  execute_or_queue_command(command, &block)
5294
4282
  end
5295
4283
 
5296
- # Updates the fulfillment.
4284
+ #
5297
4285
  # @param [String] name
5298
- # Required. The unique identifier of the fulfillment. Supported formats: - `
5299
- # projects//agent/fulfillment` - `projects//locations//agent/fulfillment` This
5300
- # field is not used for Fulfillment in an Environment.
5301
4286
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Fulfillment] google_cloud_dialogflow_v2beta1_fulfillment_object
5302
4287
  # @param [String] update_mask
5303
- # Required. The mask to control which fields get updated. If the mask is not
5304
- # present, all fields will be updated.
5305
4288
  # @param [String] fields
5306
4289
  # Selector specifying which fields to include in a partial response.
5307
4290
  # @param [String] quota_user
@@ -5332,18 +4315,8 @@ module Google
5332
4315
  execute_or_queue_command(command, &block)
5333
4316
  end
5334
4317
 
5335
- # Deletes entity types in the specified agent. This method is a [long-running
5336
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
5337
- # operations). The returned `Operation` type has the following method-specific
5338
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
5339
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
5340
- # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
5341
- # google.protobuf#empty) Note: You should always train an agent prior to sending
5342
- # it queries. See the [training documentation](https://cloud.google.com/
5343
- # dialogflow/es/docs/training).
4318
+ #
5344
4319
  # @param [String] parent
5345
- # Required. The name of the agent to delete all entities types for. Supported
5346
- # formats: - `projects//agent`, - `projects//locations//agent`.
5347
4320
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchDeleteEntityTypesRequest] google_cloud_dialogflow_v2beta1_batch_delete_entity_types_request_object
5348
4321
  # @param [String] fields
5349
4322
  # Selector specifying which fields to include in a partial response.
@@ -5374,17 +4347,8 @@ module Google
5374
4347
  execute_or_queue_command(command, &block)
5375
4348
  end
5376
4349
 
5377
- # Updates/Creates multiple entity types in the specified agent. This method is a
5378
- # [long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
5379
- # running-operations). The returned `Operation` type has the following method-
5380
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
5381
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
5382
- # : BatchUpdateEntityTypesResponse Note: You should always train an agent prior
5383
- # to sending it queries. See the [training documentation](https://cloud.google.
5384
- # com/dialogflow/es/docs/training).
4350
+ #
5385
4351
  # @param [String] parent
5386
- # Required. The name of the agent to update or create entity types in. Supported
5387
- # formats: - `projects//agent` - `projects//locations//agent`
5388
4352
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesRequest] google_cloud_dialogflow_v2beta1_batch_update_entity_types_request_object
5389
4353
  # @param [String] fields
5390
4354
  # Selector specifying which fields to include in a partial response.
@@ -5415,18 +4379,10 @@ module Google
5415
4379
  execute_or_queue_command(command, &block)
5416
4380
  end
5417
4381
 
5418
- # Creates an entity type in the specified agent. Note: You should always train
5419
- # an agent prior to sending it queries. See the [training documentation](https://
5420
- # cloud.google.com/dialogflow/es/docs/training).
4382
+ #
5421
4383
  # @param [String] parent
5422
- # Required. The agent to create a entity type for. Supported formats: - `
5423
- # projects//agent` - `projects//locations//agent`
5424
4384
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EntityType] google_cloud_dialogflow_v2beta1_entity_type_object
5425
4385
  # @param [String] language_code
5426
- # Optional. The language used to access language-specific data. If not specified,
5427
- # the agent's default language is used. For more information, see [Multilingual
5428
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
5429
- # multilingual#intent-entity).
5430
4386
  # @param [String] fields
5431
4387
  # Selector specifying which fields to include in a partial response.
5432
4388
  # @param [String] quota_user
@@ -5457,12 +4413,8 @@ module Google
5457
4413
  execute_or_queue_command(command, &block)
5458
4414
  end
5459
4415
 
5460
- # Deletes the specified entity type. Note: You should always train an agent
5461
- # prior to sending it queries. See the [training documentation](https://cloud.
5462
- # google.com/dialogflow/es/docs/training).
4416
+ #
5463
4417
  # @param [String] name
5464
- # Required. The name of the entity type to delete. Supported formats: - `
5465
- # projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
5466
4418
  # @param [String] fields
5467
4419
  # Selector specifying which fields to include in a partial response.
5468
4420
  # @param [String] quota_user
@@ -5490,15 +4442,9 @@ module Google
5490
4442
  execute_or_queue_command(command, &block)
5491
4443
  end
5492
4444
 
5493
- # Retrieves the specified entity type.
4445
+ #
5494
4446
  # @param [String] name
5495
- # Required. The name of the entity type. Supported formats: - `projects//agent/
5496
- # entityTypes/` - `projects//locations//agent/entityTypes/`
5497
4447
  # @param [String] language_code
5498
- # Optional. The language used to access language-specific data. If not specified,
5499
- # the agent's default language is used. For more information, see [Multilingual
5500
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
5501
- # multilingual#intent-entity).
5502
4448
  # @param [String] fields
5503
4449
  # Selector specifying which fields to include in a partial response.
5504
4450
  # @param [String] quota_user
@@ -5527,20 +4473,11 @@ module Google
5527
4473
  execute_or_queue_command(command, &block)
5528
4474
  end
5529
4475
 
5530
- # Returns the list of all entity types in the specified agent.
4476
+ #
5531
4477
  # @param [String] parent
5532
- # Required. The agent to list all entity types from. Supported formats: - `
5533
- # projects//agent` - `projects//locations//agent`
5534
4478
  # @param [String] language_code
5535
- # Optional. The language used to access language-specific data. If not specified,
5536
- # the agent's default language is used. For more information, see [Multilingual
5537
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
5538
- # multilingual#intent-entity).
5539
4479
  # @param [Fixnum] page_size
5540
- # Optional. The maximum number of items to return in a single page. By default
5541
- # 100 and at most 1000.
5542
4480
  # @param [String] page_token
5543
- # Optional. The next_page_token value returned from a previous list request.
5544
4481
  # @param [String] fields
5545
4482
  # Selector specifying which fields to include in a partial response.
5546
4483
  # @param [String] quota_user
@@ -5571,22 +4508,11 @@ module Google
5571
4508
  execute_or_queue_command(command, &block)
5572
4509
  end
5573
4510
 
5574
- # Updates the specified entity type. Note: You should always train an agent
5575
- # prior to sending it queries. See the [training documentation](https://cloud.
5576
- # google.com/dialogflow/es/docs/training).
4511
+ #
5577
4512
  # @param [String] name
5578
- # The unique identifier of the entity type. Required for EntityTypes.
5579
- # UpdateEntityType and EntityTypes.BatchUpdateEntityTypes methods. Supported
5580
- # formats: - `projects//agent/entityTypes/` - `projects//locations//agent/
5581
- # entityTypes/`
5582
4513
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EntityType] google_cloud_dialogflow_v2beta1_entity_type_object
5583
4514
  # @param [String] language_code
5584
- # Optional. The language used to access language-specific data. If not specified,
5585
- # the agent's default language is used. For more information, see [Multilingual
5586
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
5587
- # multilingual#intent-entity).
5588
4515
  # @param [String] update_mask
5589
- # Optional. The mask to control which fields get updated.
5590
4516
  # @param [String] fields
5591
4517
  # Selector specifying which fields to include in a partial response.
5592
4518
  # @param [String] quota_user
@@ -5618,18 +4544,8 @@ module Google
5618
4544
  execute_or_queue_command(command, &block)
5619
4545
  end
5620
4546
 
5621
- # Creates multiple new entities in the specified entity type. This method is a [
5622
- # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
5623
- # running-operations). The returned `Operation` type has the following method-
5624
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
5625
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
5626
- # : An [Empty message](https://developers.google.com/protocol-buffers/docs/
5627
- # reference/google.protobuf#empty) Note: You should always train an agent prior
5628
- # to sending it queries. See the [training documentation](https://cloud.google.
5629
- # com/dialogflow/es/docs/training).
4547
+ #
5630
4548
  # @param [String] parent
5631
- # Required. The name of the entity type to create entities in. Supported formats:
5632
- # - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
5633
4549
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest] google_cloud_dialogflow_v2beta1_batch_create_entities_request_object
5634
4550
  # @param [String] fields
5635
4551
  # Selector specifying which fields to include in a partial response.
@@ -5660,18 +4576,8 @@ module Google
5660
4576
  execute_or_queue_command(command, &block)
5661
4577
  end
5662
4578
 
5663
- # Deletes entities in the specified entity type. This method is a [long-running
5664
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
5665
- # operations). The returned `Operation` type has the following method-specific
5666
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
5667
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
5668
- # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
5669
- # google.protobuf#empty) Note: You should always train an agent prior to sending
5670
- # it queries. See the [training documentation](https://cloud.google.com/
5671
- # dialogflow/es/docs/training).
4579
+ #
5672
4580
  # @param [String] parent
5673
- # Required. The name of the entity type to delete entries for. Supported formats:
5674
- # - `projects//agent/entityTypes/` - `projects//locations//agent/entityTypes/`
5675
4581
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchDeleteEntitiesRequest] google_cloud_dialogflow_v2beta1_batch_delete_entities_request_object
5676
4582
  # @param [String] fields
5677
4583
  # Selector specifying which fields to include in a partial response.
@@ -5702,20 +4608,8 @@ module Google
5702
4608
  execute_or_queue_command(command, &block)
5703
4609
  end
5704
4610
 
5705
- # Updates or creates multiple entities in the specified entity type. This method
5706
- # does not affect entities in the entity type that aren't explicitly specified
5707
- # in the request. Note: You should always train an agent prior to sending it
5708
- # queries. See the [training documentation](https://cloud.google.com/dialogflow/
5709
- # es/docs/training). This method is a [long-running operation](https://cloud.
5710
- # google.com/dialogflow/es/docs/how/long-running-operations). The returned `
5711
- # Operation` type has the following method-specific fields: - `metadata`: An
5712
- # empty [Struct message](https://developers.google.com/protocol-buffers/docs/
5713
- # reference/google.protobuf#struct) - `response`: An [Empty message](https://
5714
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
4611
+ #
5715
4612
  # @param [String] parent
5716
- # Required. The name of the entity type to update or create entities in.
5717
- # Supported formats: - `projects//agent/entityTypes/` - `projects//locations//
5718
- # agent/entityTypes/`
5719
4613
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchUpdateEntitiesRequest] google_cloud_dialogflow_v2beta1_batch_update_entities_request_object
5720
4614
  # @param [String] fields
5721
4615
  # Selector specifying which fields to include in a partial response.
@@ -5746,13 +4640,10 @@ module Google
5746
4640
  execute_or_queue_command(command, &block)
5747
4641
  end
5748
4642
 
5749
- # Creates an agent environment.
4643
+ #
5750
4644
  # @param [String] parent
5751
- # Required. The agent to create an environment for. Supported formats: - `
5752
- # projects//agent` - `projects//locations//agent`
5753
4645
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
5754
4646
  # @param [String] environment_id
5755
- # Required. The unique id of the new environment.
5756
4647
  # @param [String] fields
5757
4648
  # Selector specifying which fields to include in a partial response.
5758
4649
  # @param [String] quota_user
@@ -5783,10 +4674,8 @@ module Google
5783
4674
  execute_or_queue_command(command, &block)
5784
4675
  end
5785
4676
 
5786
- # Deletes the specified agent environment.
4677
+ #
5787
4678
  # @param [String] name
5788
- # Required. The name of the environment to delete. / Format: - `projects//agent/
5789
- # environments/` - `projects//locations//agent/environments/`
5790
4679
  # @param [String] fields
5791
4680
  # Selector specifying which fields to include in a partial response.
5792
4681
  # @param [String] quota_user
@@ -5814,10 +4703,8 @@ module Google
5814
4703
  execute_or_queue_command(command, &block)
5815
4704
  end
5816
4705
 
5817
- # Retrieves the specified agent environment.
4706
+ #
5818
4707
  # @param [String] name
5819
- # Required. The name of the environment. Supported formats: - `projects//agent/
5820
- # environments/` - `projects//locations//agent/environments/`
5821
4708
  # @param [String] fields
5822
4709
  # Selector specifying which fields to include in a partial response.
5823
4710
  # @param [String] quota_user
@@ -5845,16 +4732,10 @@ module Google
5845
4732
  execute_or_queue_command(command, &block)
5846
4733
  end
5847
4734
 
5848
- # Gets the history of the specified environment.
4735
+ #
5849
4736
  # @param [String] parent
5850
- # Required. The name of the environment to retrieve history for. Supported
5851
- # formats: - `projects//agent/environments/` - `projects//locations//agent/
5852
- # environments/`
5853
4737
  # @param [Fixnum] page_size
5854
- # Optional. The maximum number of items to return in a single page. By default
5855
- # 100 and at most 1000.
5856
4738
  # @param [String] page_token
5857
- # Optional. The next_page_token value returned from a previous list request.
5858
4739
  # @param [String] fields
5859
4740
  # Selector specifying which fields to include in a partial response.
5860
4741
  # @param [String] quota_user
@@ -5884,15 +4765,10 @@ module Google
5884
4765
  execute_or_queue_command(command, &block)
5885
4766
  end
5886
4767
 
5887
- # Returns the list of all non-draft environments of the specified agent.
4768
+ #
5888
4769
  # @param [String] parent
5889
- # Required. The agent to list all environments from. Format: - `projects//agent`
5890
- # - `projects//locations//agent`
5891
4770
  # @param [Fixnum] page_size
5892
- # Optional. The maximum number of items to return in a single page. By default
5893
- # 100 and at most 1000.
5894
4771
  # @param [String] page_token
5895
- # Optional. The next_page_token value returned from a previous list request.
5896
4772
  # @param [String] fields
5897
4773
  # Selector specifying which fields to include in a partial response.
5898
4774
  # @param [String] quota_user
@@ -5922,28 +4798,11 @@ module Google
5922
4798
  execute_or_queue_command(command, &block)
5923
4799
  end
5924
4800
 
5925
- # Updates the specified agent environment. This method allows you to deploy new
5926
- # agent versions into the environment. When an environment is pointed to a new
5927
- # agent version by setting `environment.agent_version`, the environment is
5928
- # temporarily set to the `LOADING` state. During that time, the environment
5929
- # keeps on serving the previous version of the agent. After the new agent
5930
- # version is done loading, the environment is set back to the `RUNNING` state.
5931
- # You can use "-" as Environment ID in environment name to update version in "
5932
- # draft" environment. WARNING: this will negate all recent changes to draft and
5933
- # can't be undone. You may want to save the draft to a version before calling
5934
- # this function.
4801
+ #
5935
4802
  # @param [String] name
5936
- # Output only. The unique identifier of this agent environment. Supported
5937
- # formats: - `projects//agent/environments/` - `projects//locations//agent/
5938
- # environments/`
5939
4803
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
5940
4804
  # @param [Boolean] allow_load_to_draft_and_discard_changes
5941
- # Optional. This field is used to prevent accidental overwrite of the draft
5942
- # environment, which is an operation that cannot be undone. To confirm that the
5943
- # caller desires this overwrite, this field must be explicitly set to true when
5944
- # updating the draft environment (environment ID = `-`).
5945
4805
  # @param [String] update_mask
5946
- # Required. The mask to control which fields get updated.
5947
4806
  # @param [String] fields
5948
4807
  # Selector specifying which fields to include in a partial response.
5949
4808
  # @param [String] quota_user
@@ -5975,25 +4834,12 @@ module Google
5975
4834
  execute_or_queue_command(command, &block)
5976
4835
  end
5977
4836
 
5978
- # Returns the list of all intents in the specified agent.
4837
+ #
5979
4838
  # @param [String] parent
5980
- # Required. The agent to list all intents from. Format: `projects//agent` or `
5981
- # projects//locations//agent`. Alternatively, you can specify the environment to
5982
- # list intents for. Format: `projects//agent/environments/` or `projects//
5983
- # locations//agent/environments/`. Note: training phrases of the intents will
5984
- # not be returned for non-draft environment.
5985
4839
  # @param [String] intent_view
5986
- # Optional. The resource view to apply to the returned intent.
5987
4840
  # @param [String] language_code
5988
- # Optional. The language used to access language-specific data. If not specified,
5989
- # the agent's default language is used. For more information, see [Multilingual
5990
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
5991
- # multilingual#intent-entity).
5992
4841
  # @param [Fixnum] page_size
5993
- # Optional. The maximum number of items to return in a single page. By default
5994
- # 100 and at most 1000.
5995
4842
  # @param [String] page_token
5996
- # Optional. The next_page_token value returned from a previous list request.
5997
4843
  # @param [String] fields
5998
4844
  # Selector specifying which fields to include in a partial response.
5999
4845
  # @param [String] quota_user
@@ -6025,15 +4871,8 @@ module Google
6025
4871
  execute_or_queue_command(command, &block)
6026
4872
  end
6027
4873
 
6028
- # Deletes all active contexts in the specified session.
4874
+ #
6029
4875
  # @param [String] parent
6030
- # Required. The name of the session to delete all contexts from. Supported
6031
- # formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`
6032
- # , - `projects//agent/environments//users//sessions/`, - `projects//locations//
6033
- # agent/environments//users//sessions/`, If `Location ID` is not specified we
6034
- # assume default 'us' location. If `Environment ID` is not specified we assume
6035
- # default 'draft' environment. If `User ID` is not specified, we assume default '
6036
- # -' user.
6037
4876
  # @param [String] fields
6038
4877
  # Selector specifying which fields to include in a partial response.
6039
4878
  # @param [String] quota_user
@@ -6061,30 +4900,8 @@ module Google
6061
4900
  execute_or_queue_command(command, &block)
6062
4901
  end
6063
4902
 
6064
- # Processes a natural language query and returns structured, actionable data as
6065
- # a result. This method is not idempotent, because it may cause contexts and
6066
- # session entity types to be updated, which in turn might affect results of
6067
- # future queries. If you might use [Agent Assist](https://cloud.google.com/
6068
- # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
6069
- # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
6070
- # additional functionality for Agent Assist and other CCAI products. Note:
6071
- # Always use agent versions for production traffic. See [Versions and
6072
- # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
4903
+ #
6073
4904
  # @param [String] session
6074
- # Required. The name of the session this query is sent to. Supported formats: - `
6075
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
6076
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
6077
- # environments//users//sessions/`, If `Location ID` is not specified we assume
6078
- # default 'us' location. If `Environment ID` is not specified, we assume default
6079
- # 'draft' environment (`Environment ID` might be referred to as environment name
6080
- # at some places). If `User ID` is not specified, we are using "-". It's up to
6081
- # the API caller to choose an appropriate `Session ID` and `User Id`. They can
6082
- # be a random number or some type of user and session identifiers (preferably
6083
- # hashed). The length of the `Session ID` and `User ID` must not exceed 36
6084
- # characters. For more information, see the [API interactions guide](https://
6085
- # cloud.google.com/dialogflow/docs/api-overview). Note: Always use agent
6086
- # versions for production traffic. See [Versions and environments](https://cloud.
6087
- # google.com/dialogflow/es/docs/agents-versions).
6088
4905
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1DetectIntentRequest] google_cloud_dialogflow_v2beta1_detect_intent_request_object
6089
4906
  # @param [String] fields
6090
4907
  # Selector specifying which fields to include in a partial response.
@@ -6115,15 +4932,8 @@ module Google
6115
4932
  execute_or_queue_command(command, &block)
6116
4933
  end
6117
4934
 
6118
- # Creates a context. If the specified context already exists, overrides the
6119
- # context.
4935
+ #
6120
4936
  # @param [String] parent
6121
- # Required. The session to create a context for. Supported formats: - `projects//
6122
- # agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/
6123
- # environments//users//sessions/`, - `projects//locations//agent/environments//
6124
- # users//sessions/`, If `Location ID` is not specified we assume default 'us'
6125
- # location. If `Environment ID` is not specified, we assume default 'draft'
6126
- # environment. If `User ID` is not specified, we assume default '-' user.
6127
4937
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
6128
4938
  # @param [String] fields
6129
4939
  # Selector specifying which fields to include in a partial response.
@@ -6154,15 +4964,8 @@ module Google
6154
4964
  execute_or_queue_command(command, &block)
6155
4965
  end
6156
4966
 
6157
- # Deletes the specified context.
4967
+ #
6158
4968
  # @param [String] name
6159
- # Required. The name of the context to delete. Supported formats: - `projects//
6160
- # agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`,
6161
- # - `projects//agent/environments//users//sessions//contexts/`, - `projects//
6162
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
6163
- # is not specified we assume default 'us' location. If `Environment ID` is not
6164
- # specified, we assume default 'draft' environment. If `User ID` is not
6165
- # specified, we assume default '-' user.
6166
4969
  # @param [String] fields
6167
4970
  # Selector specifying which fields to include in a partial response.
6168
4971
  # @param [String] quota_user
@@ -6190,15 +4993,8 @@ module Google
6190
4993
  execute_or_queue_command(command, &block)
6191
4994
  end
6192
4995
 
6193
- # Retrieves the specified context.
4996
+ #
6194
4997
  # @param [String] name
6195
- # Required. The name of the context. Supported formats: - `projects//agent/
6196
- # sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `
6197
- # projects//agent/environments//users//sessions//contexts/`, - `projects//
6198
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
6199
- # is not specified we assume default 'us' location. If `Environment ID` is not
6200
- # specified, we assume default 'draft' environment. If `User ID` is not
6201
- # specified, we assume default '-' user.
6202
4998
  # @param [String] fields
6203
4999
  # Selector specifying which fields to include in a partial response.
6204
5000
  # @param [String] quota_user
@@ -6226,19 +5022,10 @@ module Google
6226
5022
  execute_or_queue_command(command, &block)
6227
5023
  end
6228
5024
 
6229
- # Returns the list of all contexts in the specified session.
5025
+ #
6230
5026
  # @param [String] parent
6231
- # Required. The session to list all contexts from. Supported formats: - `
6232
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
6233
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
6234
- # environments//users//sessions/`, If `Location ID` is not specified we assume
6235
- # default 'us' location. If `Environment ID` is not specified, we assume default
6236
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
6237
5027
  # @param [Fixnum] page_size
6238
- # Optional. The maximum number of items to return in a single page. By default
6239
- # 100 and at most 1000.
6240
5028
  # @param [String] page_token
6241
- # Optional. The next_page_token value returned from a previous list request.
6242
5029
  # @param [String] fields
6243
5030
  # Selector specifying which fields to include in a partial response.
6244
5031
  # @param [String] quota_user
@@ -6268,21 +5055,10 @@ module Google
6268
5055
  execute_or_queue_command(command, &block)
6269
5056
  end
6270
5057
 
6271
- # Updates the specified context.
5058
+ #
6272
5059
  # @param [String] name
6273
- # Required. The unique identifier of the context. Supported formats: - `projects/
6274
- # /agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`
6275
- # , - `projects//agent/environments//users//sessions//contexts/`, - `projects//
6276
- # locations//agent/environments//users//sessions//contexts/`, The `Context ID`
6277
- # is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%`
6278
- # and may be at most 250 bytes long. If `Environment ID` is not specified, we
6279
- # assume default 'draft' environment. If `User ID` is not specified, we assume
6280
- # default '-' user. The following context names are reserved for internal use by
6281
- # Dialogflow. You should not use these contexts or create contexts with these
6282
- # names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`
6283
5060
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
6284
5061
  # @param [String] update_mask
6285
- # Optional. The mask to control which fields get updated.
6286
5062
  # @param [String] fields
6287
5063
  # Selector specifying which fields to include in a partial response.
6288
5064
  # @param [String] quota_user
@@ -6313,17 +5089,8 @@ module Google
6313
5089
  execute_or_queue_command(command, &block)
6314
5090
  end
6315
5091
 
6316
- # Creates a session entity type. If the specified session entity type already
6317
- # exists, overrides the session entity type. This method doesn't work with
6318
- # Google Assistant integration. Contact Dialogflow support if you need to use
6319
- # session entities with Google Assistant integration.
5092
+ #
6320
5093
  # @param [String] parent
6321
- # Required. The session to create a session entity type for. Supported formats: -
6322
- # `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
6323
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
6324
- # environments//users//sessions/`, If `Location ID` is not specified we assume
6325
- # default 'us' location. If `Environment ID` is not specified, we assume default
6326
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
6327
5094
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
6328
5095
  # @param [String] fields
6329
5096
  # Selector specifying which fields to include in a partial response.
@@ -6354,17 +5121,8 @@ module Google
6354
5121
  execute_or_queue_command(command, &block)
6355
5122
  end
6356
5123
 
6357
- # Deletes the specified session entity type. This method doesn't work with
6358
- # Google Assistant integration. Contact Dialogflow support if you need to use
6359
- # session entities with Google Assistant integration.
5124
+ #
6360
5125
  # @param [String] name
6361
- # Required. The name of the entity type to delete. Supported formats: - `
6362
- # projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions/
6363
- # /entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/`
6364
- # - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If
6365
- # `Location ID` is not specified we assume default 'us' location. If `
6366
- # Environment ID` is not specified, we assume default 'draft' environment. If `
6367
- # User ID` is not specified, we assume default '-' user.
6368
5126
  # @param [String] fields
6369
5127
  # Selector specifying which fields to include in a partial response.
6370
5128
  # @param [String] quota_user
@@ -6392,17 +5150,8 @@ module Google
6392
5150
  execute_or_queue_command(command, &block)
6393
5151
  end
6394
5152
 
6395
- # Retrieves the specified session entity type. This method doesn't work with
6396
- # Google Assistant integration. Contact Dialogflow support if you need to use
6397
- # session entities with Google Assistant integration.
5153
+ #
6398
5154
  # @param [String] name
6399
- # Required. The name of the session entity type. Supported formats: - `projects//
6400
- # agent/sessions//entityTypes/` - `projects//locations//agent/sessions//
6401
- # entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` -
6402
- # `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `
6403
- # Location ID` is not specified we assume default 'us' location. If `Environment
6404
- # ID` is not specified, we assume default 'draft' environment. If `User ID` is
6405
- # not specified, we assume default '-' user.
6406
5155
  # @param [String] fields
6407
5156
  # Selector specifying which fields to include in a partial response.
6408
5157
  # @param [String] quota_user
@@ -6430,21 +5179,10 @@ module Google
6430
5179
  execute_or_queue_command(command, &block)
6431
5180
  end
6432
5181
 
6433
- # Returns the list of all session entity types in the specified session. This
6434
- # method doesn't work with Google Assistant integration. Contact Dialogflow
6435
- # support if you need to use session entities with Google Assistant integration.
5182
+ #
6436
5183
  # @param [String] parent
6437
- # Required. The session to list all session entity types from. Supported formats:
6438
- # - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
6439
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
6440
- # environments//users//sessions/`, If `Location ID` is not specified we assume
6441
- # default 'us' location. If `Environment ID` is not specified, we assume default
6442
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
6443
5184
  # @param [Fixnum] page_size
6444
- # Optional. The maximum number of items to return in a single page. By default
6445
- # 100 and at most 1000.
6446
5185
  # @param [String] page_token
6447
- # Optional. The next_page_token value returned from a previous list request.
6448
5186
  # @param [String] fields
6449
5187
  # Selector specifying which fields to include in a partial response.
6450
5188
  # @param [String] quota_user
@@ -6474,22 +5212,10 @@ module Google
6474
5212
  execute_or_queue_command(command, &block)
6475
5213
  end
6476
5214
 
6477
- # Updates the specified session entity type. This method doesn't work with
6478
- # Google Assistant integration. Contact Dialogflow support if you need to use
6479
- # session entities with Google Assistant integration.
5215
+ #
6480
5216
  # @param [String] name
6481
- # Required. The unique identifier of this session entity type. Supported formats:
6482
- # - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/
6483
- # sessions//entityTypes/` - `projects//agent/environments//users//sessions//
6484
- # entityTypes/` - `projects//locations//agent/environments/ /users//sessions//
6485
- # entityTypes/` If `Location ID` is not specified we assume default 'us'
6486
- # location. If `Environment ID` is not specified, we assume default 'draft'
6487
- # environment. If `User ID` is not specified, we assume default '-' user. ``
6488
- # must be the display name of an existing entity type in the same agent that
6489
- # will be overridden or supplemented.
6490
5217
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
6491
5218
  # @param [String] update_mask
6492
- # Optional. The mask to control which fields get updated.
6493
5219
  # @param [String] fields
6494
5220
  # Selector specifying which fields to include in a partial response.
6495
5221
  # @param [String] quota_user
@@ -6520,18 +5246,8 @@ module Google
6520
5246
  execute_or_queue_command(command, &block)
6521
5247
  end
6522
5248
 
6523
- # Deletes intents in the specified agent. This method is a [long-running
6524
- # operation](https://cloud.google.com/dialogflow/es/docs/how/long-running-
6525
- # operations). The returned `Operation` type has the following method-specific
6526
- # fields: - `metadata`: An empty [Struct message](https://developers.google.com/
6527
- # protocol-buffers/docs/reference/google.protobuf#struct) - `response`: An [
6528
- # Empty message](https://developers.google.com/protocol-buffers/docs/reference/
6529
- # google.protobuf#empty) Note: You should always train an agent prior to sending
6530
- # it queries. See the [training documentation](https://cloud.google.com/
6531
- # dialogflow/es/docs/training).
5249
+ #
6532
5250
  # @param [String] parent
6533
- # Required. The name of the agent to delete all entities types for. Supported
6534
- # formats: - `projects//agent` - `projects//locations//agent`
6535
5251
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchDeleteIntentsRequest] google_cloud_dialogflow_v2beta1_batch_delete_intents_request_object
6536
5252
  # @param [String] fields
6537
5253
  # Selector specifying which fields to include in a partial response.
@@ -6562,17 +5278,8 @@ module Google
6562
5278
  execute_or_queue_command(command, &block)
6563
5279
  end
6564
5280
 
6565
- # Updates/Creates multiple intents in the specified agent. This method is a [
6566
- # long-running operation](https://cloud.google.com/dialogflow/es/docs/how/long-
6567
- # running-operations). The returned `Operation` type has the following method-
6568
- # specific fields: - `metadata`: An empty [Struct message](https://developers.
6569
- # google.com/protocol-buffers/docs/reference/google.protobuf#struct) - `response`
6570
- # : BatchUpdateIntentsResponse Note: You should always train an agent prior to
6571
- # sending it queries. See the [training documentation](https://cloud.google.com/
6572
- # dialogflow/es/docs/training).
5281
+ #
6573
5282
  # @param [String] parent
6574
- # Required. The name of the agent to update or create intents in. Supported
6575
- # formats: - `projects//agent` - `projects//locations//agent`
6576
5283
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchUpdateIntentsRequest] google_cloud_dialogflow_v2beta1_batch_update_intents_request_object
6577
5284
  # @param [String] fields
6578
5285
  # Selector specifying which fields to include in a partial response.
@@ -6603,20 +5310,11 @@ module Google
6603
5310
  execute_or_queue_command(command, &block)
6604
5311
  end
6605
5312
 
6606
- # Creates an intent in the specified agent. Note: You should always train an
6607
- # agent prior to sending it queries. See the [training documentation](https://
6608
- # cloud.google.com/dialogflow/es/docs/training).
5313
+ #
6609
5314
  # @param [String] parent
6610
- # Required. The agent to create a intent for. Supported formats: - `projects//
6611
- # agent` - `projects//locations//agent`
6612
5315
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Intent] google_cloud_dialogflow_v2beta1_intent_object
6613
5316
  # @param [String] intent_view
6614
- # Optional. The resource view to apply to the returned intent.
6615
5317
  # @param [String] language_code
6616
- # Optional. The language used to access language-specific data. If not specified,
6617
- # the agent's default language is used. For more information, see [Multilingual
6618
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
6619
- # multilingual#intent-entity).
6620
5318
  # @param [String] fields
6621
5319
  # Selector specifying which fields to include in a partial response.
6622
5320
  # @param [String] quota_user
@@ -6648,13 +5346,8 @@ module Google
6648
5346
  execute_or_queue_command(command, &block)
6649
5347
  end
6650
5348
 
6651
- # Deletes the specified intent and its direct or indirect followup intents. Note:
6652
- # You should always train an agent prior to sending it queries. See the [
6653
- # training documentation](https://cloud.google.com/dialogflow/es/docs/training).
5349
+ #
6654
5350
  # @param [String] name
6655
- # Required. The name of the intent to delete. If this intent has direct or
6656
- # indirect followup intents, we also delete them. Supported formats: - `projects/
6657
- # /agent/intents/` - `projects//locations//agent/intents/`
6658
5351
  # @param [String] fields
6659
5352
  # Selector specifying which fields to include in a partial response.
6660
5353
  # @param [String] quota_user
@@ -6682,17 +5375,10 @@ module Google
6682
5375
  execute_or_queue_command(command, &block)
6683
5376
  end
6684
5377
 
6685
- # Retrieves the specified intent.
5378
+ #
6686
5379
  # @param [String] name
6687
- # Required. The name of the intent. Supported formats: - `projects//agent/
6688
- # intents/` - `projects//locations//agent/intents/`
6689
5380
  # @param [String] intent_view
6690
- # Optional. The resource view to apply to the returned intent.
6691
5381
  # @param [String] language_code
6692
- # Optional. The language used to access language-specific data. If not specified,
6693
- # the agent's default language is used. For more information, see [Multilingual
6694
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
6695
- # multilingual#intent-entity).
6696
5382
  # @param [String] fields
6697
5383
  # Selector specifying which fields to include in a partial response.
6698
5384
  # @param [String] quota_user
@@ -6722,25 +5408,12 @@ module Google
6722
5408
  execute_or_queue_command(command, &block)
6723
5409
  end
6724
5410
 
6725
- # Returns the list of all intents in the specified agent.
5411
+ #
6726
5412
  # @param [String] parent
6727
- # Required. The agent to list all intents from. Format: `projects//agent` or `
6728
- # projects//locations//agent`. Alternatively, you can specify the environment to
6729
- # list intents for. Format: `projects//agent/environments/` or `projects//
6730
- # locations//agent/environments/`. Note: training phrases of the intents will
6731
- # not be returned for non-draft environment.
6732
5413
  # @param [String] intent_view
6733
- # Optional. The resource view to apply to the returned intent.
6734
5414
  # @param [String] language_code
6735
- # Optional. The language used to access language-specific data. If not specified,
6736
- # the agent's default language is used. For more information, see [Multilingual
6737
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
6738
- # multilingual#intent-entity).
6739
5415
  # @param [Fixnum] page_size
6740
- # Optional. The maximum number of items to return in a single page. By default
6741
- # 100 and at most 1000.
6742
5416
  # @param [String] page_token
6743
- # Optional. The next_page_token value returned from a previous list request.
6744
5417
  # @param [String] fields
6745
5418
  # Selector specifying which fields to include in a partial response.
6746
5419
  # @param [String] quota_user
@@ -6772,23 +5445,12 @@ module Google
6772
5445
  execute_or_queue_command(command, &block)
6773
5446
  end
6774
5447
 
6775
- # Updates the specified intent. Note: You should always train an agent prior to
6776
- # sending it queries. See the [training documentation](https://cloud.google.com/
6777
- # dialogflow/es/docs/training).
5448
+ #
6778
5449
  # @param [String] name
6779
- # Optional. The unique identifier of this intent. Required for Intents.
6780
- # UpdateIntent and Intents.BatchUpdateIntents methods. Supported formats: - `
6781
- # projects//agent/intents/` - `projects//locations//agent/intents/`
6782
5450
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Intent] google_cloud_dialogflow_v2beta1_intent_object
6783
5451
  # @param [String] intent_view
6784
- # Optional. The resource view to apply to the returned intent.
6785
5452
  # @param [String] language_code
6786
- # Optional. The language used to access language-specific data. If not specified,
6787
- # the agent's default language is used. For more information, see [Multilingual
6788
- # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
6789
- # multilingual#intent-entity).
6790
5453
  # @param [String] update_mask
6791
- # Optional. The mask to control which fields get updated.
6792
5454
  # @param [String] fields
6793
5455
  # Selector specifying which fields to include in a partial response.
6794
5456
  # @param [String] quota_user
@@ -6821,15 +5483,8 @@ module Google
6821
5483
  execute_or_queue_command(command, &block)
6822
5484
  end
6823
5485
 
6824
- # Deletes all active contexts in the specified session.
5486
+ #
6825
5487
  # @param [String] parent
6826
- # Required. The name of the session to delete all contexts from. Supported
6827
- # formats: - `projects//agent/sessions/, - `projects//locations//agent/sessions/`
6828
- # , - `projects//agent/environments//users//sessions/`, - `projects//locations//
6829
- # agent/environments//users//sessions/`, If `Location ID` is not specified we
6830
- # assume default 'us' location. If `Environment ID` is not specified we assume
6831
- # default 'draft' environment. If `User ID` is not specified, we assume default '
6832
- # -' user.
6833
5488
  # @param [String] fields
6834
5489
  # Selector specifying which fields to include in a partial response.
6835
5490
  # @param [String] quota_user
@@ -6857,30 +5512,8 @@ module Google
6857
5512
  execute_or_queue_command(command, &block)
6858
5513
  end
6859
5514
 
6860
- # Processes a natural language query and returns structured, actionable data as
6861
- # a result. This method is not idempotent, because it may cause contexts and
6862
- # session entity types to be updated, which in turn might affect results of
6863
- # future queries. If you might use [Agent Assist](https://cloud.google.com/
6864
- # dialogflow/docs/#aa) or other CCAI products now or in the future, consider
6865
- # using AnalyzeContent instead of `DetectIntent`. `AnalyzeContent` has
6866
- # additional functionality for Agent Assist and other CCAI products. Note:
6867
- # Always use agent versions for production traffic. See [Versions and
6868
- # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
5515
+ #
6869
5516
  # @param [String] session
6870
- # Required. The name of the session this query is sent to. Supported formats: - `
6871
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
6872
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
6873
- # environments//users//sessions/`, If `Location ID` is not specified we assume
6874
- # default 'us' location. If `Environment ID` is not specified, we assume default
6875
- # 'draft' environment (`Environment ID` might be referred to as environment name
6876
- # at some places). If `User ID` is not specified, we are using "-". It's up to
6877
- # the API caller to choose an appropriate `Session ID` and `User Id`. They can
6878
- # be a random number or some type of user and session identifiers (preferably
6879
- # hashed). The length of the `Session ID` and `User ID` must not exceed 36
6880
- # characters. For more information, see the [API interactions guide](https://
6881
- # cloud.google.com/dialogflow/docs/api-overview). Note: Always use agent
6882
- # versions for production traffic. See [Versions and environments](https://cloud.
6883
- # google.com/dialogflow/es/docs/agents-versions).
6884
5517
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1DetectIntentRequest] google_cloud_dialogflow_v2beta1_detect_intent_request_object
6885
5518
  # @param [String] fields
6886
5519
  # Selector specifying which fields to include in a partial response.
@@ -6911,15 +5544,8 @@ module Google
6911
5544
  execute_or_queue_command(command, &block)
6912
5545
  end
6913
5546
 
6914
- # Creates a context. If the specified context already exists, overrides the
6915
- # context.
5547
+ #
6916
5548
  # @param [String] parent
6917
- # Required. The session to create a context for. Supported formats: - `projects//
6918
- # agent/sessions/, - `projects//locations//agent/sessions/`, - `projects//agent/
6919
- # environments//users//sessions/`, - `projects//locations//agent/environments//
6920
- # users//sessions/`, If `Location ID` is not specified we assume default 'us'
6921
- # location. If `Environment ID` is not specified, we assume default 'draft'
6922
- # environment. If `User ID` is not specified, we assume default '-' user.
6923
5549
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
6924
5550
  # @param [String] fields
6925
5551
  # Selector specifying which fields to include in a partial response.
@@ -6950,15 +5576,8 @@ module Google
6950
5576
  execute_or_queue_command(command, &block)
6951
5577
  end
6952
5578
 
6953
- # Deletes the specified context.
5579
+ #
6954
5580
  # @param [String] name
6955
- # Required. The name of the context to delete. Supported formats: - `projects//
6956
- # agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`,
6957
- # - `projects//agent/environments//users//sessions//contexts/`, - `projects//
6958
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
6959
- # is not specified we assume default 'us' location. If `Environment ID` is not
6960
- # specified, we assume default 'draft' environment. If `User ID` is not
6961
- # specified, we assume default '-' user.
6962
5581
  # @param [String] fields
6963
5582
  # Selector specifying which fields to include in a partial response.
6964
5583
  # @param [String] quota_user
@@ -6986,15 +5605,8 @@ module Google
6986
5605
  execute_or_queue_command(command, &block)
6987
5606
  end
6988
5607
 
6989
- # Retrieves the specified context.
5608
+ #
6990
5609
  # @param [String] name
6991
- # Required. The name of the context. Supported formats: - `projects//agent/
6992
- # sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`, - `
6993
- # projects//agent/environments//users//sessions//contexts/`, - `projects//
6994
- # locations//agent/environments//users//sessions//contexts/`, If `Location ID`
6995
- # is not specified we assume default 'us' location. If `Environment ID` is not
6996
- # specified, we assume default 'draft' environment. If `User ID` is not
6997
- # specified, we assume default '-' user.
6998
5610
  # @param [String] fields
6999
5611
  # Selector specifying which fields to include in a partial response.
7000
5612
  # @param [String] quota_user
@@ -7022,19 +5634,10 @@ module Google
7022
5634
  execute_or_queue_command(command, &block)
7023
5635
  end
7024
5636
 
7025
- # Returns the list of all contexts in the specified session.
5637
+ #
7026
5638
  # @param [String] parent
7027
- # Required. The session to list all contexts from. Supported formats: - `
7028
- # projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
7029
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
7030
- # environments//users//sessions/`, If `Location ID` is not specified we assume
7031
- # default 'us' location. If `Environment ID` is not specified, we assume default
7032
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
7033
5639
  # @param [Fixnum] page_size
7034
- # Optional. The maximum number of items to return in a single page. By default
7035
- # 100 and at most 1000.
7036
5640
  # @param [String] page_token
7037
- # Optional. The next_page_token value returned from a previous list request.
7038
5641
  # @param [String] fields
7039
5642
  # Selector specifying which fields to include in a partial response.
7040
5643
  # @param [String] quota_user
@@ -7064,21 +5667,10 @@ module Google
7064
5667
  execute_or_queue_command(command, &block)
7065
5668
  end
7066
5669
 
7067
- # Updates the specified context.
5670
+ #
7068
5671
  # @param [String] name
7069
- # Required. The unique identifier of the context. Supported formats: - `projects/
7070
- # /agent/sessions//contexts/`, - `projects//locations//agent/sessions//contexts/`
7071
- # , - `projects//agent/environments//users//sessions//contexts/`, - `projects//
7072
- # locations//agent/environments//users//sessions//contexts/`, The `Context ID`
7073
- # is always converted to lowercase, may only contain characters in `a-zA-Z0-9_-%`
7074
- # and may be at most 250 bytes long. If `Environment ID` is not specified, we
7075
- # assume default 'draft' environment. If `User ID` is not specified, we assume
7076
- # default '-' user. The following context names are reserved for internal use by
7077
- # Dialogflow. You should not use these contexts or create contexts with these
7078
- # names: * `__system_counters__` * `*_id_dialog_context` * `*_dialog_params_size`
7079
5672
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context] google_cloud_dialogflow_v2beta1_context_object
7080
5673
  # @param [String] update_mask
7081
- # Optional. The mask to control which fields get updated.
7082
5674
  # @param [String] fields
7083
5675
  # Selector specifying which fields to include in a partial response.
7084
5676
  # @param [String] quota_user
@@ -7109,17 +5701,8 @@ module Google
7109
5701
  execute_or_queue_command(command, &block)
7110
5702
  end
7111
5703
 
7112
- # Creates a session entity type. If the specified session entity type already
7113
- # exists, overrides the session entity type. This method doesn't work with
7114
- # Google Assistant integration. Contact Dialogflow support if you need to use
7115
- # session entities with Google Assistant integration.
5704
+ #
7116
5705
  # @param [String] parent
7117
- # Required. The session to create a session entity type for. Supported formats: -
7118
- # `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
7119
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
7120
- # environments//users//sessions/`, If `Location ID` is not specified we assume
7121
- # default 'us' location. If `Environment ID` is not specified, we assume default
7122
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
7123
5706
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
7124
5707
  # @param [String] fields
7125
5708
  # Selector specifying which fields to include in a partial response.
@@ -7150,17 +5733,8 @@ module Google
7150
5733
  execute_or_queue_command(command, &block)
7151
5734
  end
7152
5735
 
7153
- # Deletes the specified session entity type. This method doesn't work with
7154
- # Google Assistant integration. Contact Dialogflow support if you need to use
7155
- # session entities with Google Assistant integration.
5736
+ #
7156
5737
  # @param [String] name
7157
- # Required. The name of the entity type to delete. Supported formats: - `
7158
- # projects//agent/sessions//entityTypes/` - `projects//locations//agent/sessions/
7159
- # /entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/`
7160
- # - `projects//locations//agent/environments/ /users//sessions//entityTypes/` If
7161
- # `Location ID` is not specified we assume default 'us' location. If `
7162
- # Environment ID` is not specified, we assume default 'draft' environment. If `
7163
- # User ID` is not specified, we assume default '-' user.
7164
5738
  # @param [String] fields
7165
5739
  # Selector specifying which fields to include in a partial response.
7166
5740
  # @param [String] quota_user
@@ -7188,17 +5762,8 @@ module Google
7188
5762
  execute_or_queue_command(command, &block)
7189
5763
  end
7190
5764
 
7191
- # Retrieves the specified session entity type. This method doesn't work with
7192
- # Google Assistant integration. Contact Dialogflow support if you need to use
7193
- # session entities with Google Assistant integration.
5765
+ #
7194
5766
  # @param [String] name
7195
- # Required. The name of the session entity type. Supported formats: - `projects//
7196
- # agent/sessions//entityTypes/` - `projects//locations//agent/sessions//
7197
- # entityTypes/` - `projects//agent/environments//users//sessions//entityTypes/` -
7198
- # `projects//locations//agent/environments/ /users//sessions//entityTypes/` If `
7199
- # Location ID` is not specified we assume default 'us' location. If `Environment
7200
- # ID` is not specified, we assume default 'draft' environment. If `User ID` is
7201
- # not specified, we assume default '-' user.
7202
5767
  # @param [String] fields
7203
5768
  # Selector specifying which fields to include in a partial response.
7204
5769
  # @param [String] quota_user
@@ -7226,21 +5791,10 @@ module Google
7226
5791
  execute_or_queue_command(command, &block)
7227
5792
  end
7228
5793
 
7229
- # Returns the list of all session entity types in the specified session. This
7230
- # method doesn't work with Google Assistant integration. Contact Dialogflow
7231
- # support if you need to use session entities with Google Assistant integration.
5794
+ #
7232
5795
  # @param [String] parent
7233
- # Required. The session to list all session entity types from. Supported formats:
7234
- # - `projects//agent/sessions/, - `projects//locations//agent/sessions/`, - `
7235
- # projects//agent/environments//users//sessions/`, - `projects//locations//agent/
7236
- # environments//users//sessions/`, If `Location ID` is not specified we assume
7237
- # default 'us' location. If `Environment ID` is not specified, we assume default
7238
- # 'draft' environment. If `User ID` is not specified, we assume default '-' user.
7239
5796
  # @param [Fixnum] page_size
7240
- # Optional. The maximum number of items to return in a single page. By default
7241
- # 100 and at most 1000.
7242
5797
  # @param [String] page_token
7243
- # Optional. The next_page_token value returned from a previous list request.
7244
5798
  # @param [String] fields
7245
5799
  # Selector specifying which fields to include in a partial response.
7246
5800
  # @param [String] quota_user
@@ -7270,22 +5824,10 @@ module Google
7270
5824
  execute_or_queue_command(command, &block)
7271
5825
  end
7272
5826
 
7273
- # Updates the specified session entity type. This method doesn't work with
7274
- # Google Assistant integration. Contact Dialogflow support if you need to use
7275
- # session entities with Google Assistant integration.
5827
+ #
7276
5828
  # @param [String] name
7277
- # Required. The unique identifier of this session entity type. Supported formats:
7278
- # - `projects//agent/sessions//entityTypes/` - `projects//locations//agent/
7279
- # sessions//entityTypes/` - `projects//agent/environments//users//sessions//
7280
- # entityTypes/` - `projects//locations//agent/environments/ /users//sessions//
7281
- # entityTypes/` If `Location ID` is not specified we assume default 'us'
7282
- # location. If `Environment ID` is not specified, we assume default 'draft'
7283
- # environment. If `User ID` is not specified, we assume default '-' user. ``
7284
- # must be the display name of an existing entity type in the same agent that
7285
- # will be overridden or supplemented.
7286
5829
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType] google_cloud_dialogflow_v2beta1_session_entity_type_object
7287
5830
  # @param [String] update_mask
7288
- # Optional. The mask to control which fields get updated.
7289
5831
  # @param [String] fields
7290
5832
  # Selector specifying which fields to include in a partial response.
7291
5833
  # @param [String] quota_user
@@ -7316,11 +5858,8 @@ module Google
7316
5858
  execute_or_queue_command(command, &block)
7317
5859
  end
7318
5860
 
7319
- # Creates an agent version. The new version points to the agent instance in the "
7320
- # default" environment.
5861
+ #
7321
5862
  # @param [String] parent
7322
- # Required. The agent to create a version for. Supported formats: - `projects//
7323
- # agent` - `projects//locations//agent`
7324
5863
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
7325
5864
  # @param [String] fields
7326
5865
  # Selector specifying which fields to include in a partial response.
@@ -7351,10 +5890,8 @@ module Google
7351
5890
  execute_or_queue_command(command, &block)
7352
5891
  end
7353
5892
 
7354
- # Delete the specified agent version.
5893
+ #
7355
5894
  # @param [String] name
7356
- # Required. The name of the version to delete. Supported formats: - `projects//
7357
- # agent/versions/` - `projects//locations//agent/versions/`
7358
5895
  # @param [String] fields
7359
5896
  # Selector specifying which fields to include in a partial response.
7360
5897
  # @param [String] quota_user
@@ -7382,10 +5919,8 @@ module Google
7382
5919
  execute_or_queue_command(command, &block)
7383
5920
  end
7384
5921
 
7385
- # Retrieves the specified agent version.
5922
+ #
7386
5923
  # @param [String] name
7387
- # Required. The name of the version. Supported formats: - `projects//agent/
7388
- # versions/` - `projects//locations//agent/versions/`
7389
5924
  # @param [String] fields
7390
5925
  # Selector specifying which fields to include in a partial response.
7391
5926
  # @param [String] quota_user
@@ -7413,15 +5948,10 @@ module Google
7413
5948
  execute_or_queue_command(command, &block)
7414
5949
  end
7415
5950
 
7416
- # Returns the list of all versions of the specified agent.
5951
+ #
7417
5952
  # @param [String] parent
7418
- # Required. The agent to list all versions from. Supported formats: - `projects//
7419
- # agent` - `projects//locations//agent`
7420
5953
  # @param [Fixnum] page_size
7421
- # Optional. The maximum number of items to return in a single page. By default
7422
- # 100 and at most 1000.
7423
5954
  # @param [String] page_token
7424
- # Optional. The next_page_token value returned from a previous list request.
7425
5955
  # @param [String] fields
7426
5956
  # Selector specifying which fields to include in a partial response.
7427
5957
  # @param [String] quota_user
@@ -7451,15 +5981,10 @@ module Google
7451
5981
  execute_or_queue_command(command, &block)
7452
5982
  end
7453
5983
 
7454
- # Updates the specified agent version. Note that this method does not allow you
7455
- # to update the state of the agent the given version points to. It allows you to
7456
- # update only mutable properties of the version resource.
5984
+ #
7457
5985
  # @param [String] name
7458
- # Output only. The unique identifier of this agent version. Supported formats: -
7459
- # `projects//agent/versions/` - `projects//locations//agent/versions/`
7460
5986
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
7461
5987
  # @param [String] update_mask
7462
- # Required. The mask to control which fields get updated.
7463
5988
  # @param [String] fields
7464
5989
  # Selector specifying which fields to include in a partial response.
7465
5990
  # @param [String] quota_user
@@ -7490,10 +6015,8 @@ module Google
7490
6015
  execute_or_queue_command(command, &block)
7491
6016
  end
7492
6017
 
7493
- # Deprecated. Retrieves a specific answer record.
6018
+ #
7494
6019
  # @param [String] name
7495
- # Required. The name of the answer record to retrieve. Format: `projects//
7496
- # locations//answerRecords/`.
7497
6020
  # @param [String] fields
7498
6021
  # Selector specifying which fields to include in a partial response.
7499
6022
  # @param [String] quota_user
@@ -7521,26 +6044,11 @@ module Google
7521
6044
  execute_or_queue_command(command, &block)
7522
6045
  end
7523
6046
 
7524
- # Returns the list of all answer records in the specified project in reverse
7525
- # chronological order.
6047
+ #
7526
6048
  # @param [String] parent
7527
- # Required. The project to list all answer records for in reverse chronological
7528
- # order. Format: `projects//locations/`.
7529
6049
  # @param [String] filter
7530
- # Optional. Filters to restrict results to specific answer records. The
7531
- # expression has the following syntax: [AND ] ... The following fields and
7532
- # operators are supported: * conversation_id with equals(=) operator Examples: *
7533
- # "conversation_id=bar" matches answer records in the projects/foo/locations/
7534
- # global/conversations/bar conversation (assuming the parent is projects/foo/
7535
- # locations/global). For more information about filtering, see [API Filtering](
7536
- # https://aip.dev/160).
7537
6050
  # @param [Fixnum] page_size
7538
- # Optional. The maximum number of records to return in a single page. The server
7539
- # may return fewer records than this. If unspecified, we use 10. The maximum is
7540
- # 100.
7541
6051
  # @param [String] page_token
7542
- # Optional. The ListAnswerRecordsResponse.next_page_token value returned from a
7543
- # previous list request used to continue listing on the next page.
7544
6052
  # @param [String] fields
7545
6053
  # Selector specifying which fields to include in a partial response.
7546
6054
  # @param [String] quota_user
@@ -7571,13 +6079,10 @@ module Google
7571
6079
  execute_or_queue_command(command, &block)
7572
6080
  end
7573
6081
 
7574
- # Updates the specified answer record.
6082
+ #
7575
6083
  # @param [String] name
7576
- # The unique identifier of this answer record. Required for AnswerRecords.
7577
- # UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`.
7578
6084
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] google_cloud_dialogflow_v2beta1_answer_record_object
7579
6085
  # @param [String] update_mask
7580
- # Required. The mask to control which fields get updated.
7581
6086
  # @param [String] fields
7582
6087
  # Selector specifying which fields to include in a partial response.
7583
6088
  # @param [String] quota_user
@@ -7608,15 +6113,8 @@ module Google
7608
6113
  execute_or_queue_command(command, &block)
7609
6114
  end
7610
6115
 
7611
- # Clears a suggestion feature from a conversation profile for the given
7612
- # participant role. This method is a [long-running operation](https://cloud.
7613
- # google.com/dialogflow/es/docs/how/long-running-operations). The returned `
7614
- # Operation` type has the following method-specific fields: - `metadata`:
7615
- # ClearSuggestionFeatureConfigOperationMetadata - `response`:
7616
- # ConversationProfile
6116
+ #
7617
6117
  # @param [String] conversation_profile
7618
- # Required. The Conversation Profile to add or update the suggestion feature
7619
- # config. Format: `projects//locations//conversationProfiles/`.
7620
6118
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ClearSuggestionFeatureConfigRequest] google_cloud_dialogflow_v2beta1_clear_suggestion_feature_config_request_object
7621
6119
  # @param [String] fields
7622
6120
  # Selector specifying which fields to include in a partial response.
@@ -7647,12 +6145,8 @@ module Google
7647
6145
  execute_or_queue_command(command, &block)
7648
6146
  end
7649
6147
 
7650
- # Creates a conversation profile in the specified project. ConversationProfile.
7651
- # CreateTime and ConversationProfile.UpdateTime aren't populated in the response.
7652
- # You can retrieve them via GetConversationProfile API.
6148
+ #
7653
6149
  # @param [String] parent
7654
- # Required. The project to create a conversation profile for. Format: `projects//
7655
- # locations/`.
7656
6150
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] google_cloud_dialogflow_v2beta1_conversation_profile_object
7657
6151
  # @param [String] fields
7658
6152
  # Selector specifying which fields to include in a partial response.
@@ -7683,10 +6177,8 @@ module Google
7683
6177
  execute_or_queue_command(command, &block)
7684
6178
  end
7685
6179
 
7686
- # Deletes the specified conversation profile.
6180
+ #
7687
6181
  # @param [String] name
7688
- # Required. The name of the conversation profile to delete. Format: `projects//
7689
- # locations//conversationProfiles/`.
7690
6182
  # @param [String] fields
7691
6183
  # Selector specifying which fields to include in a partial response.
7692
6184
  # @param [String] quota_user
@@ -7714,10 +6206,8 @@ module Google
7714
6206
  execute_or_queue_command(command, &block)
7715
6207
  end
7716
6208
 
7717
- # Retrieves the specified conversation profile.
6209
+ #
7718
6210
  # @param [String] name
7719
- # Required. The resource name of the conversation profile. Format: `projects//
7720
- # locations//conversationProfiles/`.
7721
6211
  # @param [String] fields
7722
6212
  # Selector specifying which fields to include in a partial response.
7723
6213
  # @param [String] quota_user
@@ -7745,15 +6235,10 @@ module Google
7745
6235
  execute_or_queue_command(command, &block)
7746
6236
  end
7747
6237
 
7748
- # Returns the list of all conversation profiles in the specified project.
6238
+ #
7749
6239
  # @param [String] parent
7750
- # Required. The project to list all conversation profiles from. Format: `
7751
- # projects//locations/`.
7752
6240
  # @param [Fixnum] page_size
7753
- # The maximum number of items to return in a single page. By default 100 and at
7754
- # most 1000.
7755
6241
  # @param [String] page_token
7756
- # The next_page_token value returned from a previous list request.
7757
6242
  # @param [String] fields
7758
6243
  # Selector specifying which fields to include in a partial response.
7759
6244
  # @param [String] quota_user
@@ -7783,15 +6268,10 @@ module Google
7783
6268
  execute_or_queue_command(command, &block)
7784
6269
  end
7785
6270
 
7786
- # Updates the specified conversation profile. ConversationProfile.CreateTime and
7787
- # ConversationProfile.UpdateTime aren't populated in the response. You can
7788
- # retrieve them via GetConversationProfile API.
6271
+ #
7789
6272
  # @param [String] name
7790
- # The unique identifier of this conversation profile. Format: `projects//
7791
- # locations//conversationProfiles/`.
7792
6273
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] google_cloud_dialogflow_v2beta1_conversation_profile_object
7793
6274
  # @param [String] update_mask
7794
- # Required. The mask to control which fields to update.
7795
6275
  # @param [String] fields
7796
6276
  # Selector specifying which fields to include in a partial response.
7797
6277
  # @param [String] quota_user
@@ -7822,20 +6302,8 @@ module Google
7822
6302
  execute_or_queue_command(command, &block)
7823
6303
  end
7824
6304
 
7825
- # Adds or updates a suggestion feature in a conversation profile. If the
7826
- # conversation profile contains the type of suggestion feature for the
7827
- # participant role, it will update it. Otherwise it will insert the suggestion
7828
- # feature. This method is a [long-running operation](https://cloud.google.com/
7829
- # dialogflow/es/docs/how/long-running-operations). The returned `Operation` type
7830
- # has the following method-specific fields: - `metadata`:
7831
- # SetSuggestionFeatureConfigOperationMetadata - `response`: ConversationProfile
7832
- # If a long running operation to add or update suggestion feature config for the
7833
- # same conversation profile, participant role and suggestion feature type exists,
7834
- # please cancel the existing long running operation before sending such request,
7835
- # otherwise the request will be rejected.
6305
+ #
7836
6306
  # @param [String] conversation_profile
7837
- # Required. The Conversation Profile to add or update the suggestion feature
7838
- # config. Format: `projects//locations//conversationProfiles/`.
7839
6307
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SetSuggestionFeatureConfigRequest] google_cloud_dialogflow_v2beta1_set_suggestion_feature_config_request_object
7840
6308
  # @param [String] fields
7841
6309
  # Selector specifying which fields to include in a partial response.
@@ -7866,11 +6334,8 @@ module Google
7866
6334
  execute_or_queue_command(command, &block)
7867
6335
  end
7868
6336
 
7869
- # Completes the specified conversation. Finished conversations are purged from
7870
- # the database after 30 days.
6337
+ #
7871
6338
  # @param [String] name
7872
- # Required. Resource identifier of the conversation to close. Format: `projects//
7873
- # locations//conversations/`.
7874
6339
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CompleteConversationRequest] google_cloud_dialogflow_v2beta1_complete_conversation_request_object
7875
6340
  # @param [String] fields
7876
6341
  # Selector specifying which fields to include in a partial response.
@@ -7901,28 +6366,10 @@ module Google
7901
6366
  execute_or_queue_command(command, &block)
7902
6367
  end
7903
6368
 
7904
- # Creates a new conversation. Conversations are auto-completed after 24 hours.
7905
- # Conversation Lifecycle: There are two stages during a conversation: Automated
7906
- # Agent Stage and Assist Stage. For Automated Agent Stage, there will be a
7907
- # dialogflow agent responding to user queries. For Assist Stage, there's no
7908
- # dialogflow agent responding to user queries. But we will provide suggestions
7909
- # which are generated from conversation. If Conversation.conversation_profile is
7910
- # configured for a dialogflow agent, conversation will start from `Automated
7911
- # Agent Stage`, otherwise, it will start from `Assist Stage`. And during `
7912
- # Automated Agent Stage`, once an Intent with Intent.live_agent_handoff is
7913
- # triggered, conversation will transfer to Assist Stage.
6369
+ #
7914
6370
  # @param [String] parent
7915
- # Required. Resource identifier of the project creating the conversation. Format:
7916
- # `projects//locations/`.
7917
6371
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Conversation] google_cloud_dialogflow_v2beta1_conversation_object
7918
6372
  # @param [String] conversation_id
7919
- # Optional. Identifier of the conversation. Generally it's auto generated by
7920
- # Google. Only set it if you cannot wait for the response to return a auto-
7921
- # generated one to you. The conversation ID must be compliant with the
7922
- # regression formula `a-zA-Z*` with the characters length in range of [3,64]. If
7923
- # the field is provided, the caller is responsible for 1. the uniqueness of the
7924
- # ID, otherwise the request will be rejected. 2. the consistency for whether to
7925
- # use custom ID or not under a project to better ensure uniqueness.
7926
6373
  # @param [String] fields
7927
6374
  # Selector specifying which fields to include in a partial response.
7928
6375
  # @param [String] quota_user
@@ -7953,10 +6400,8 @@ module Google
7953
6400
  execute_or_queue_command(command, &block)
7954
6401
  end
7955
6402
 
7956
- # Retrieves the specific conversation.
6403
+ #
7957
6404
  # @param [String] name
7958
- # Required. The name of the conversation. Format: `projects//locations//
7959
- # conversations/`.
7960
6405
  # @param [String] fields
7961
6406
  # Selector specifying which fields to include in a partial response.
7962
6407
  # @param [String] quota_user
@@ -7984,10 +6429,8 @@ module Google
7984
6429
  execute_or_queue_command(command, &block)
7985
6430
  end
7986
6431
 
7987
- # Data ingestion API. Ingests context references for an existing conversation.
6432
+ #
7988
6433
  # @param [String] conversation
7989
- # Required. Resource identifier of the conversation to ingest context
7990
- # information for. Format: `projects//locations//conversations/`.
7991
6434
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1IngestContextReferencesRequest] google_cloud_dialogflow_v2beta1_ingest_context_references_request_object
7992
6435
  # @param [String] fields
7993
6436
  # Selector specifying which fields to include in a partial response.
@@ -8018,21 +6461,11 @@ module Google
8018
6461
  execute_or_queue_command(command, &block)
8019
6462
  end
8020
6463
 
8021
- # Returns the list of all conversations in the specified project.
6464
+ #
8022
6465
  # @param [String] parent
8023
- # Required. The project from which to list all conversation. Format: `projects//
8024
- # locations/`.
8025
6466
  # @param [String] filter
8026
- # Optional. A filter expression that filters conversations listed in the
8027
- # response. Only `lifecycle_state` can be filtered on in this way. For example,
8028
- # the following expression only returns `COMPLETED` conversations: `
8029
- # lifecycle_state = "COMPLETED"` For more information about filtering, see [API
8030
- # Filtering](https://aip.dev/160).
8031
6467
  # @param [Fixnum] page_size
8032
- # Optional. The maximum number of items to return in a single page. By default
8033
- # 100 and at most 1000.
8034
6468
  # @param [String] page_token
8035
- # Optional. The next_page_token value returned from a previous list request.
8036
6469
  # @param [String] fields
8037
6470
  # Selector specifying which fields to include in a partial response.
8038
6471
  # @param [String] quota_user
@@ -8063,11 +6496,8 @@ module Google
8063
6496
  execute_or_queue_command(command, &block)
8064
6497
  end
8065
6498
 
8066
- # Batch ingests messages to conversation. Customers can use this RPC to ingest
8067
- # historical messages to conversation.
6499
+ #
8068
6500
  # @param [String] parent
8069
- # Required. Resource identifier of the conversation to create message. Format: `
8070
- # projects//locations//conversations/`.
8071
6501
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1BatchCreateMessagesRequest] google_cloud_dialogflow_v2beta1_batch_create_messages_request_object
8072
6502
  # @param [String] fields
8073
6503
  # Selector specifying which fields to include in a partial response.
@@ -8098,24 +6528,11 @@ module Google
8098
6528
  execute_or_queue_command(command, &block)
8099
6529
  end
8100
6530
 
8101
- # Lists messages that belong to a given conversation. `messages` are ordered by `
8102
- # create_time` in descending order. To fetch updates without duplication, send
8103
- # request with filter `create_time_epoch_microseconds > [first item's
8104
- # create_time of previous request]` and empty page_token.
6531
+ #
8105
6532
  # @param [String] parent
8106
- # Required. The name of the conversation to list messages for. Format: `projects/
8107
- # /locations//conversations/`
8108
6533
  # @param [String] filter
8109
- # Optional. Filter on message fields. Currently predicates on `create_time` and `
8110
- # create_time_epoch_microseconds` are supported. `create_time` only support
8111
- # milliseconds accuracy. E.g., `create_time_epoch_microseconds >
8112
- # 1551790877964485` or `create_time > "2017-01-15T01:30:15.01Z"`. For more
8113
- # information about filtering, see [API Filtering](https://aip.dev/160).
8114
6534
  # @param [Fixnum] page_size
8115
- # Optional. The maximum number of items to return in a single page. By default
8116
- # 100 and at most 1000.
8117
6535
  # @param [String] page_token
8118
- # Optional. The next_page_token value returned from a previous list request.
8119
6536
  # @param [String] fields
8120
6537
  # Selector specifying which fields to include in a partial response.
8121
6538
  # @param [String] quota_user
@@ -8146,13 +6563,8 @@ module Google
8146
6563
  execute_or_queue_command(command, &block)
8147
6564
  end
8148
6565
 
8149
- # Adds a text (chat, for example), or audio (phone recording, for example)
8150
- # message from a participant into the conversation. Note: Always use agent
8151
- # versions for production traffic sent to virtual agents. See [Versions and
8152
- # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
6566
+ #
8153
6567
  # @param [String] participant
8154
- # Required. The name of the participant this text comes from. Format: `projects//
8155
- # locations//conversations//participants/`.
8156
6568
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnalyzeContentRequest] google_cloud_dialogflow_v2beta1_analyze_content_request_object
8157
6569
  # @param [String] fields
8158
6570
  # Selector specifying which fields to include in a partial response.
@@ -8183,10 +6595,8 @@ module Google
8183
6595
  execute_or_queue_command(command, &block)
8184
6596
  end
8185
6597
 
8186
- # Creates a new participant in a conversation.
6598
+ #
8187
6599
  # @param [String] parent
8188
- # Required. Resource identifier of the conversation adding the participant.
8189
- # Format: `projects//locations//conversations/`.
8190
6600
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Participant] google_cloud_dialogflow_v2beta1_participant_object
8191
6601
  # @param [String] fields
8192
6602
  # Selector specifying which fields to include in a partial response.
@@ -8217,10 +6627,8 @@ module Google
8217
6627
  execute_or_queue_command(command, &block)
8218
6628
  end
8219
6629
 
8220
- # Retrieves a conversation participant.
6630
+ #
8221
6631
  # @param [String] name
8222
- # Required. The name of the participant. Format: `projects//locations//
8223
- # conversations//participants/`.
8224
6632
  # @param [String] fields
8225
6633
  # Selector specifying which fields to include in a partial response.
8226
6634
  # @param [String] quota_user
@@ -8248,15 +6656,10 @@ module Google
8248
6656
  execute_or_queue_command(command, &block)
8249
6657
  end
8250
6658
 
8251
- # Returns the list of all participants in the specified conversation.
6659
+ #
8252
6660
  # @param [String] parent
8253
- # Required. The conversation to list all participants from. Format: `projects//
8254
- # locations//conversations/`.
8255
6661
  # @param [Fixnum] page_size
8256
- # Optional. The maximum number of items to return in a single page. By default
8257
- # 100 and at most 1000.
8258
6662
  # @param [String] page_token
8259
- # Optional. The next_page_token value returned from a previous list request.
8260
6663
  # @param [String] fields
8261
6664
  # Selector specifying which fields to include in a partial response.
8262
6665
  # @param [String] quota_user
@@ -8286,13 +6689,10 @@ module Google
8286
6689
  execute_or_queue_command(command, &block)
8287
6690
  end
8288
6691
 
8289
- # Updates the specified participant.
6692
+ #
8290
6693
  # @param [String] name
8291
- # Optional. The unique identifier of this participant. Format: `projects//
8292
- # locations//conversations//participants/`.
8293
6694
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Participant] google_cloud_dialogflow_v2beta1_participant_object
8294
6695
  # @param [String] update_mask
8295
- # Required. The mask to specify which fields to update.
8296
6696
  # @param [String] fields
8297
6697
  # Selector specifying which fields to include in a partial response.
8298
6698
  # @param [String] quota_user
@@ -8323,13 +6723,8 @@ module Google
8323
6723
  execute_or_queue_command(command, &block)
8324
6724
  end
8325
6725
 
8326
- # Gets suggested articles for a participant based on specific historical
8327
- # messages. Note that ListSuggestions will only list the auto-generated
8328
- # suggestions, while CompileSuggestion will try to compile suggestion based on
8329
- # the provided conversation context in the real time.
6726
+ #
8330
6727
  # @param [String] parent
8331
- # Required. The name of the participant to fetch suggestion for. Format: `
8332
- # projects//locations//conversations//participants/`.
8333
6728
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestArticlesRequest] google_cloud_dialogflow_v2beta1_suggest_articles_request_object
8334
6729
  # @param [String] fields
8335
6730
  # Selector specifying which fields to include in a partial response.
@@ -8360,11 +6755,8 @@ module Google
8360
6755
  execute_or_queue_command(command, &block)
8361
6756
  end
8362
6757
 
8363
- # Gets suggested faq answers for a participant based on specific historical
8364
- # messages.
6758
+ #
8365
6759
  # @param [String] parent
8366
- # Required. The name of the participant to fetch suggestion for. Format: `
8367
- # projects//locations//conversations//participants/`.
8368
6760
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestFaqAnswersRequest] google_cloud_dialogflow_v2beta1_suggest_faq_answers_request_object
8369
6761
  # @param [String] fields
8370
6762
  # Selector specifying which fields to include in a partial response.
@@ -8395,10 +6787,8 @@ module Google
8395
6787
  execute_or_queue_command(command, &block)
8396
6788
  end
8397
6789
 
8398
- # Gets knowledge assist suggestions based on historical messages.
6790
+ #
8399
6791
  # @param [String] parent
8400
- # Required. The name of the participant to fetch suggestions for. Format: `
8401
- # projects//locations//conversations//participants/`.
8402
6792
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestKnowledgeAssistRequest] google_cloud_dialogflow_v2beta1_suggest_knowledge_assist_request_object
8403
6793
  # @param [String] fields
8404
6794
  # Selector specifying which fields to include in a partial response.
@@ -8429,10 +6819,8 @@ module Google
8429
6819
  execute_or_queue_command(command, &block)
8430
6820
  end
8431
6821
 
8432
- # Gets smart replies for a participant based on specific historical messages.
6822
+ #
8433
6823
  # @param [String] parent
8434
- # Required. The name of the participant to fetch suggestion for. Format: `
8435
- # projects//locations//conversations//participants/`.
8436
6824
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestSmartRepliesRequest] google_cloud_dialogflow_v2beta1_suggest_smart_replies_request_object
8437
6825
  # @param [String] fields
8438
6826
  # Selector specifying which fields to include in a partial response.
@@ -8463,13 +6851,8 @@ module Google
8463
6851
  execute_or_queue_command(command, &block)
8464
6852
  end
8465
6853
 
8466
- # Generates all the suggestions using generators configured in the conversation
8467
- # profile. A generator is used only if its trigger event is matched.
6854
+ #
8468
6855
  # @param [String] conversation
8469
- # Required. The conversation for which the suggestions are generated. Format: `
8470
- # projects//locations//conversations/`. The conversation must be created with a
8471
- # conversation profile which has generators configured in it to be able to get
8472
- # suggestions.
8473
6856
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1GenerateSuggestionsRequest] google_cloud_dialogflow_v2beta1_generate_suggestions_request_object
8474
6857
  # @param [String] fields
8475
6858
  # Selector specifying which fields to include in a partial response.
@@ -8500,10 +6883,8 @@ module Google
8500
6883
  execute_or_queue_command(command, &block)
8501
6884
  end
8502
6885
 
8503
- # Get answers for the given query based on knowledge documents.
6886
+ #
8504
6887
  # @param [String] conversation
8505
- # Optional. The conversation (between human agent and end user) where the search
8506
- # request is triggered. Format: `projects//locations//conversations/`.
8507
6888
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SearchKnowledgeRequest] google_cloud_dialogflow_v2beta1_search_knowledge_request_object
8508
6889
  # @param [String] fields
8509
6890
  # Selector specifying which fields to include in a partial response.
@@ -8534,11 +6915,8 @@ module Google
8534
6915
  execute_or_queue_command(command, &block)
8535
6916
  end
8536
6917
 
8537
- # Suggest summary for a conversation based on specific historical messages. The
8538
- # range of the messages to be used for summary can be specified in the request.
6918
+ #
8539
6919
  # @param [String] conversation
8540
- # Required. The conversation to fetch suggestion for. Format: `projects//
8541
- # locations//conversations/`.
8542
6920
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SuggestConversationSummaryRequest] google_cloud_dialogflow_v2beta1_suggest_conversation_summary_request_object
8543
6921
  # @param [String] fields
8544
6922
  # Selector specifying which fields to include in a partial response.
@@ -8569,14 +6947,8 @@ module Google
8569
6947
  execute_or_queue_command(command, &block)
8570
6948
  end
8571
6949
 
8572
- # Initializes a location-level encryption key specification. An error will be
8573
- # thrown if the location has resources already created before the initialization.
8574
- # Once the encryption specification is initialized at a location, it is
8575
- # immutable and all newly created resources under the location will be encrypted
8576
- # with the existing specification.
6950
+ #
8577
6951
  # @param [String] name
8578
- # Immutable. The resource name of the encryption key specification resource.
8579
- # Format: projects/`project`/locations/`location`/encryptionSpec
8580
6952
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1InitializeEncryptionSpecRequest] google_cloud_dialogflow_v2beta1_initialize_encryption_spec_request_object
8581
6953
  # @param [String] fields
8582
6954
  # Selector specifying which fields to include in a partial response.
@@ -8607,19 +6979,10 @@ module Google
8607
6979
  execute_or_queue_command(command, &block)
8608
6980
  end
8609
6981
 
8610
- # Creates a generator.
6982
+ #
8611
6983
  # @param [String] parent
8612
- # Required. The project/location to create generator for. Format: `projects//
8613
- # locations/`
8614
6984
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Generator] google_cloud_dialogflow_v2beta1_generator_object
8615
6985
  # @param [String] generator_id
8616
- # Optional. The ID to use for the generator, which will become the final
8617
- # component of the generator's resource name. The generator ID must be compliant
8618
- # with the regression formula `a-zA-Z*` with the characters length in range of [
8619
- # 3,64]. If the field is not provided, an Id will be auto-generated. If the
8620
- # field is provided, the caller is responsible for 1. the uniqueness of the ID,
8621
- # otherwise the request will be rejected. 2. the consistency for whether to use
8622
- # custom ID or not under a project to better ensure uniqueness.
8623
6986
  # @param [String] fields
8624
6987
  # Selector specifying which fields to include in a partial response.
8625
6988
  # @param [String] quota_user
@@ -8650,10 +7013,8 @@ module Google
8650
7013
  execute_or_queue_command(command, &block)
8651
7014
  end
8652
7015
 
8653
- # Deletes a generator.
7016
+ #
8654
7017
  # @param [String] name
8655
- # Required. The generator resource name to delete. Format: `projects//locations//
8656
- # generators/`
8657
7018
  # @param [String] fields
8658
7019
  # Selector specifying which fields to include in a partial response.
8659
7020
  # @param [String] quota_user
@@ -8681,10 +7042,8 @@ module Google
8681
7042
  execute_or_queue_command(command, &block)
8682
7043
  end
8683
7044
 
8684
- # Retrieves a generator.
7045
+ #
8685
7046
  # @param [String] name
8686
- # Required. The generator resource name to retrieve. Format: `projects//
8687
- # locations/`/generators/`
8688
7047
  # @param [String] fields
8689
7048
  # Selector specifying which fields to include in a partial response.
8690
7049
  # @param [String] quota_user
@@ -8712,15 +7071,10 @@ module Google
8712
7071
  execute_or_queue_command(command, &block)
8713
7072
  end
8714
7073
 
8715
- # Lists generators.
7074
+ #
8716
7075
  # @param [String] parent
8717
- # Required. The project/location to list generators for. Format: `projects//
8718
- # locations/`
8719
7076
  # @param [Fixnum] page_size
8720
- # Optional. Maximum number of conversation models to return in a single page.
8721
- # Default to 10.
8722
7077
  # @param [String] page_token
8723
- # Optional. The next_page_token value returned from a previous list request.
8724
7078
  # @param [String] fields
8725
7079
  # Selector specifying which fields to include in a partial response.
8726
7080
  # @param [String] quota_user
@@ -8750,13 +7104,10 @@ module Google
8750
7104
  execute_or_queue_command(command, &block)
8751
7105
  end
8752
7106
 
8753
- # Updates a generator.
7107
+ #
8754
7108
  # @param [String] name
8755
- # Output only. Identifier. The resource name of the generator. Format: `projects/
8756
- # /locations//generators/`
8757
7109
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Generator] google_cloud_dialogflow_v2beta1_generator_object
8758
7110
  # @param [String] update_mask
8759
- # Optional. The list of fields to update.
8760
7111
  # @param [String] fields
8761
7112
  # Selector specifying which fields to include in a partial response.
8762
7113
  # @param [String] quota_user
@@ -8787,10 +7138,8 @@ module Google
8787
7138
  execute_or_queue_command(command, &block)
8788
7139
  end
8789
7140
 
8790
- # Creates evaluation of a generator.
7141
+ #
8791
7142
  # @param [String] parent
8792
- # Required. The generator resource name. Format: `projects//locations//
8793
- # generators/`
8794
7143
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1GeneratorEvaluation] google_cloud_dialogflow_v2beta1_generator_evaluation_object
8795
7144
  # @param [String] fields
8796
7145
  # Selector specifying which fields to include in a partial response.
@@ -8821,10 +7170,8 @@ module Google
8821
7170
  execute_or_queue_command(command, &block)
8822
7171
  end
8823
7172
 
8824
- # Deletes an evaluation of generator.
7173
+ #
8825
7174
  # @param [String] name
8826
- # Required. The generator evaluation resource name. Format: `projects//locations/
8827
- # /generators// evaluations/`
8828
7175
  # @param [String] fields
8829
7176
  # Selector specifying which fields to include in a partial response.
8830
7177
  # @param [String] quota_user
@@ -8852,10 +7199,8 @@ module Google
8852
7199
  execute_or_queue_command(command, &block)
8853
7200
  end
8854
7201
 
8855
- # Gets an evaluation of generator.
7202
+ #
8856
7203
  # @param [String] name
8857
- # Required. The generator evaluation resource name. Format: `projects//locations/
8858
- # /generators//evaluations/`
8859
7204
  # @param [String] fields
8860
7205
  # Selector specifying which fields to include in a partial response.
8861
7206
  # @param [String] quota_user
@@ -8883,16 +7228,10 @@ module Google
8883
7228
  execute_or_queue_command(command, &block)
8884
7229
  end
8885
7230
 
8886
- # Lists evaluations of generator.
7231
+ #
8887
7232
  # @param [String] parent
8888
- # Required. The generator resource name. Format: `projects//locations//
8889
- # generators/` Wildcard value `-` is supported on generator_id to list
8890
- # evaluations across all generators under same project.
8891
7233
  # @param [Fixnum] page_size
8892
- # Optional. Maximum number of evaluations to return in a single page. By default
8893
- # 100 and at most 1000.
8894
7234
  # @param [String] page_token
8895
- # Optional. The next_page_token value returned from a previous list request.
8896
7235
  # @param [String] fields
8897
7236
  # Selector specifying which fields to include in a partial response.
8898
7237
  # @param [String] quota_user
@@ -8922,11 +7261,8 @@ module Google
8922
7261
  execute_or_queue_command(command, &block)
8923
7262
  end
8924
7263
 
8925
- # Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource
8926
- # is deprecated; only use `projects.knowledgeBases`.
7264
+ #
8927
7265
  # @param [String] parent
8928
- # Required. The project to create a knowledge base for. Format: `projects//
8929
- # locations/`.
8930
7266
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1KnowledgeBase] google_cloud_dialogflow_v2beta1_knowledge_base_object
8931
7267
  # @param [String] fields
8932
7268
  # Selector specifying which fields to include in a partial response.
@@ -8957,14 +7293,9 @@ module Google
8957
7293
  execute_or_queue_command(command, &block)
8958
7294
  end
8959
7295
 
8960
- # Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases`
8961
- # resource is deprecated; only use `projects.knowledgeBases`.
7296
+ #
8962
7297
  # @param [String] name
8963
- # Required. The name of the knowledge base to delete. Format: `projects//
8964
- # locations//knowledgeBases/`.
8965
7298
  # @param [Boolean] force
8966
- # Optional. Force deletes the knowledge base. When set to true, any documents in
8967
- # the knowledge base are also deleted.
8968
7299
  # @param [String] fields
8969
7300
  # Selector specifying which fields to include in a partial response.
8970
7301
  # @param [String] quota_user
@@ -8993,11 +7324,8 @@ module Google
8993
7324
  execute_or_queue_command(command, &block)
8994
7325
  end
8995
7326
 
8996
- # Retrieves the specified knowledge base. Note: The `projects.agent.
8997
- # knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
7327
+ #
8998
7328
  # @param [String] name
8999
- # Required. The name of the knowledge base to retrieve. Format `projects//
9000
- # locations//knowledgeBases/`.
9001
7329
  # @param [String] fields
9002
7330
  # Selector specifying which fields to include in a partial response.
9003
7331
  # @param [String] quota_user
@@ -9025,30 +7353,11 @@ module Google
9025
7353
  execute_or_queue_command(command, &block)
9026
7354
  end
9027
7355
 
9028
- # Returns the list of all knowledge bases of the specified agent. Note: The `
9029
- # projects.agent.knowledgeBases` resource is deprecated; only use `projects.
9030
- # knowledgeBases`.
7356
+ #
9031
7357
  # @param [String] parent
9032
- # Required. The project to list of knowledge bases for. Format: `projects//
9033
- # locations/`.
9034
7358
  # @param [String] filter
9035
- # The filter expression used to filter knowledge bases returned by the list
9036
- # method. The expression has the following syntax: [AND ] ... The following
9037
- # fields and operators are supported: * display_name with has(:) operator *
9038
- # language_code with equals(=) operator Examples: * 'language_code=en-us'
9039
- # matches knowledge bases with en-us language code. * 'display_name:articles'
9040
- # matches knowledge bases whose display name contains "articles". * '
9041
- # display_name:"Best Articles"' matches knowledge bases whose display name
9042
- # contains "Best Articles". * 'language_code=en-gb AND display_name=articles'
9043
- # matches all knowledge bases whose display name contains "articles" and whose
9044
- # language code is "en-gb". Note: An empty filter string (i.e. "") is a no-op
9045
- # and will result in no filtering. For more information about filtering, see [
9046
- # API Filtering](https://aip.dev/160).
9047
7359
  # @param [Fixnum] page_size
9048
- # The maximum number of items to return in a single page. By default 10 and at
9049
- # most 100.
9050
7360
  # @param [String] page_token
9051
- # The next_page_token value returned from a previous list request.
9052
7361
  # @param [String] fields
9053
7362
  # Selector specifying which fields to include in a partial response.
9054
7363
  # @param [String] quota_user
@@ -9079,16 +7388,10 @@ module Google
9079
7388
  execute_or_queue_command(command, &block)
9080
7389
  end
9081
7390
 
9082
- # Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases`
9083
- # resource is deprecated; only use `projects.knowledgeBases`.
7391
+ #
9084
7392
  # @param [String] name
9085
- # The knowledge base resource name. The name must be empty when creating a
9086
- # knowledge base. Format: `projects//locations//knowledgeBases/`.
9087
7393
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1KnowledgeBase] google_cloud_dialogflow_v2beta1_knowledge_base_object
9088
7394
  # @param [String] update_mask
9089
- # Optional. Not specified means `update all`. Currently, only `display_name` can
9090
- # be updated, an InvalidArgument will be returned for attempting to update other
9091
- # fields.
9092
7395
  # @param [String] fields
9093
7396
  # Selector specifying which fields to include in a partial response.
9094
7397
  # @param [String] quota_user
@@ -9119,19 +7422,10 @@ module Google
9119
7422
  execute_or_queue_command(command, &block)
9120
7423
  end
9121
7424
 
9122
- # Creates a new document. This method is a [long-running operation](https://
9123
- # cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
9124
- # Operation` type has the following method-specific fields: - `metadata`:
9125
- # KnowledgeOperationMetadata - `response`: Document Note: The `projects.agent.
9126
- # knowledgeBases.documents` resource is deprecated; only use `projects.
9127
- # knowledgeBases.documents`.
7425
+ #
9128
7426
  # @param [String] parent
9129
- # Required. The knowledge base to create a document for. Format: `projects//
9130
- # locations//knowledgeBases/`.
9131
7427
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
9132
7428
  # @param [Boolean] import_gcs_custom_metadata
9133
- # Whether to import custom metadata from Google Cloud Storage. Only valid when
9134
- # the document source is Google Cloud Storage URI.
9135
7429
  # @param [String] fields
9136
7430
  # Selector specifying which fields to include in a partial response.
9137
7431
  # @param [String] quota_user
@@ -9162,16 +7456,8 @@ module Google
9162
7456
  execute_or_queue_command(command, &block)
9163
7457
  end
9164
7458
 
9165
- # Deletes the specified document. This method is a [long-running operation](
9166
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
9167
- # returned `Operation` type has the following method-specific fields: - `
9168
- # metadata`: KnowledgeOperationMetadata - `response`: An [Empty message](https://
9169
- # developers.google.com/protocol-buffers/docs/reference/google.protobuf#empty)
9170
- # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
9171
- # only use `projects.knowledgeBases.documents`.
7459
+ #
9172
7460
  # @param [String] name
9173
- # Required. The name of the document to delete. Format: `projects//locations//
9174
- # knowledgeBases//documents/`.
9175
7461
  # @param [String] fields
9176
7462
  # Selector specifying which fields to include in a partial response.
9177
7463
  # @param [String] quota_user
@@ -9199,12 +7485,8 @@ module Google
9199
7485
  execute_or_queue_command(command, &block)
9200
7486
  end
9201
7487
 
9202
- # Retrieves the specified document. Note: The `projects.agent.knowledgeBases.
9203
- # documents` resource is deprecated; only use `projects.knowledgeBases.documents`
9204
- # .
7488
+ #
9205
7489
  # @param [String] name
9206
- # Required. The name of the document to retrieve. Format `projects//locations//
9207
- # knowledgeBases//documents/`.
9208
7490
  # @param [String] fields
9209
7491
  # Selector specifying which fields to include in a partial response.
9210
7492
  # @param [String] quota_user
@@ -9232,15 +7514,8 @@ module Google
9232
7514
  execute_or_queue_command(command, &block)
9233
7515
  end
9234
7516
 
9235
- # Create documents by importing data from external sources. Dialogflow supports
9236
- # up to 350 documents in each request. If you try to import more, Dialogflow
9237
- # will return an error. This method is a [long-running operation](https://cloud.
9238
- # google.com/dialogflow/cx/docs/how/long-running-operation). The returned `
9239
- # Operation` type has the following method-specific fields: - `metadata`:
9240
- # KnowledgeOperationMetadata - `response`: ImportDocumentsResponse
7517
+ #
9241
7518
  # @param [String] parent
9242
- # Required. The knowledge base to import documents into. Format: `projects//
9243
- # locations//knowledgeBases/`.
9244
7519
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ImportDocumentsRequest] google_cloud_dialogflow_v2beta1_import_documents_request_object
9245
7520
  # @param [String] fields
9246
7521
  # Selector specifying which fields to include in a partial response.
@@ -9271,27 +7546,11 @@ module Google
9271
7546
  execute_or_queue_command(command, &block)
9272
7547
  end
9273
7548
 
9274
- # Returns the list of all documents of the knowledge base. Note: The `projects.
9275
- # agent.knowledgeBases.documents` resource is deprecated; only use `projects.
9276
- # knowledgeBases.documents`.
7549
+ #
9277
7550
  # @param [String] parent
9278
- # Required. The knowledge base to list all documents for. Format: `projects//
9279
- # locations//knowledgeBases/`.
9280
7551
  # @param [String] filter
9281
- # The filter expression used to filter documents returned by the list method.
9282
- # The expression has the following syntax: [AND ] ... The following fields and
9283
- # operators are supported: * knowledge_types with has(:) operator * display_name
9284
- # with has(:) operator * state with equals(=) operator Examples: * "
9285
- # knowledge_types:FAQ" matches documents with FAQ knowledge type. * "
9286
- # display_name:customer" matches documents whose display name contains "customer"
9287
- # . * "state=ACTIVE" matches documents with ACTIVE state. * "knowledge_types:FAQ
9288
- # AND state=ACTIVE" matches all active FAQ documents. For more information about
9289
- # filtering, see [API Filtering](https://aip.dev/160).
9290
7552
  # @param [Fixnum] page_size
9291
- # The maximum number of items to return in a single page. By default 10 and at
9292
- # most 100.
9293
7553
  # @param [String] page_token
9294
- # The next_page_token value returned from a previous list request.
9295
7554
  # @param [String] fields
9296
7555
  # Selector specifying which fields to include in a partial response.
9297
7556
  # @param [String] quota_user
@@ -9322,20 +7581,10 @@ module Google
9322
7581
  execute_or_queue_command(command, &block)
9323
7582
  end
9324
7583
 
9325
- # Updates the specified document. This method is a [long-running operation](
9326
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
9327
- # returned `Operation` type has the following method-specific fields: - `
9328
- # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
9329
- # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
9330
- # projects.knowledgeBases.documents`.
7584
+ #
9331
7585
  # @param [String] name
9332
- # Optional. The document resource name. The name must be empty when creating a
9333
- # document. Format: `projects//locations//knowledgeBases//documents/`.
9334
7586
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Document] google_cloud_dialogflow_v2beta1_document_object
9335
7587
  # @param [String] update_mask
9336
- # Optional. Not specified means `update all`. Currently, only `display_name` can
9337
- # be updated, an InvalidArgument will be returned for attempting to update other
9338
- # fields.
9339
7588
  # @param [String] fields
9340
7589
  # Selector specifying which fields to include in a partial response.
9341
7590
  # @param [String] quota_user
@@ -9366,21 +7615,8 @@ module Google
9366
7615
  execute_or_queue_command(command, &block)
9367
7616
  end
9368
7617
 
9369
- # Reloads the specified document from its specified source, content_uri or
9370
- # content. The previously loaded content of the document will be deleted. Note:
9371
- # Even when the content of the document has not changed, there still may be side
9372
- # effects because of internal implementation changes. Note: If the document
9373
- # source is Google Cloud Storage URI, its metadata will be replaced with the
9374
- # custom metadata from Google Cloud Storage if the `import_gcs_custom_metadata`
9375
- # field is set to true in the request. This method is a [long-running operation](
9376
- # https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation). The
9377
- # returned `Operation` type has the following method-specific fields: - `
9378
- # metadata`: KnowledgeOperationMetadata - `response`: Document Note: The `
9379
- # projects.agent.knowledgeBases.documents` resource is deprecated; only use `
9380
- # projects.knowledgeBases.documents`.
7618
+ #
9381
7619
  # @param [String] name
9382
- # Required. The name of the document to reload. Format: `projects//locations//
9383
- # knowledgeBases//documents/`
9384
7620
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ReloadDocumentRequest] google_cloud_dialogflow_v2beta1_reload_document_request_object
9385
7621
  # @param [String] fields
9386
7622
  # Selector specifying which fields to include in a partial response.
@@ -9411,16 +7647,8 @@ module Google
9411
7647
  execute_or_queue_command(command, &block)
9412
7648
  end
9413
7649
 
9414
- # Starts asynchronous cancellation on a long-running operation. The server makes
9415
- # a best effort to cancel the operation, but success is not guaranteed. If the
9416
- # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
9417
- # Clients can use Operations.GetOperation or other methods to check whether the
9418
- # cancellation succeeded or whether the operation completed despite cancellation.
9419
- # On successful cancellation, the operation is not deleted; instead, it becomes
9420
- # an operation with an Operation.error value with a google.rpc.Status.code of `1`
9421
- # , corresponding to `Code.CANCELLED`.
7650
+ #
9422
7651
  # @param [String] name
9423
- # The name of the operation resource to be cancelled.
9424
7652
  # @param [String] fields
9425
7653
  # Selector specifying which fields to include in a partial response.
9426
7654
  # @param [String] quota_user
@@ -9448,10 +7676,8 @@ module Google
9448
7676
  execute_or_queue_command(command, &block)
9449
7677
  end
9450
7678
 
9451
- # Gets the latest state of a long-running operation. Clients can use this method
9452
- # to poll the operation result at intervals as recommended by the API service.
7679
+ #
9453
7680
  # @param [String] name
9454
- # The name of the operation resource.
9455
7681
  # @param [String] fields
9456
7682
  # Selector specifying which fields to include in a partial response.
9457
7683
  # @param [String] quota_user
@@ -9479,23 +7705,12 @@ module Google
9479
7705
  execute_or_queue_command(command, &block)
9480
7706
  end
9481
7707
 
9482
- # Lists operations that match the specified filter in the request. If the server
9483
- # doesn't support this method, it returns `UNIMPLEMENTED`.
7708
+ #
9484
7709
  # @param [String] name
9485
- # The name of the operation's parent resource.
9486
7710
  # @param [String] filter
9487
- # The standard list filter.
9488
7711
  # @param [Fixnum] page_size
9489
- # The standard list page size.
9490
7712
  # @param [String] page_token
9491
- # The standard list page token.
9492
7713
  # @param [Boolean] return_partial_success
9493
- # When set to `true`, operations that are reachable are returned as normal, and
9494
- # those that are unreachable are returned in the [ListOperationsResponse.
9495
- # unreachable] field. This can only be `true` when reading across collections e.
9496
- # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
9497
- # by default supported and will result in an `UNIMPLEMENTED` error if set unless
9498
- # explicitly documented otherwise in service or product specific documentation.
9499
7714
  # @param [String] fields
9500
7715
  # Selector specifying which fields to include in a partial response.
9501
7716
  # @param [String] quota_user
@@ -9527,12 +7742,8 @@ module Google
9527
7742
  execute_or_queue_command(command, &block)
9528
7743
  end
9529
7744
 
9530
- # Requests deletion of a `PhoneNumber`. The `PhoneNumber` is moved into the
9531
- # DELETE_REQUESTED state immediately, and is deleted approximately 30 days later.
9532
- # This method may only be called on a `PhoneNumber` in the ACTIVE state.
7745
+ #
9533
7746
  # @param [String] name
9534
- # Required. The unique identifier of the `PhoneNumber` to delete. Format: `
9535
- # projects//phoneNumbers/`. Format: `projects//locations//phoneNumbers/`.
9536
7747
  # @param [String] fields
9537
7748
  # Selector specifying which fields to include in a partial response.
9538
7749
  # @param [String] quota_user
@@ -9560,18 +7771,11 @@ module Google
9560
7771
  execute_or_queue_command(command, &block)
9561
7772
  end
9562
7773
 
9563
- # Returns the list of all phone numbers in the specified project.
7774
+ #
9564
7775
  # @param [String] parent
9565
- # Required. The project to list all `PhoneNumber` resources from. Format: `
9566
- # projects/`. Format: `projects//locations/`.
9567
7776
  # @param [Fixnum] page_size
9568
- # Optional. The maximum number of items to return in a single page. The default
9569
- # value is 100. The maximum value is 1000.
9570
7777
  # @param [String] page_token
9571
- # Optional. The next_page_token value returned from a previous list request.
9572
7778
  # @param [Boolean] show_deleted
9573
- # Optional. Controls whether `PhoneNumber` resources in the DELETE_REQUESTED
9574
- # state should be returned. Defaults to false.
9575
7779
  # @param [String] fields
9576
7780
  # Selector specifying which fields to include in a partial response.
9577
7781
  # @param [String] quota_user
@@ -9602,14 +7806,10 @@ module Google
9602
7806
  execute_or_queue_command(command, &block)
9603
7807
  end
9604
7808
 
9605
- # Updates the specified `PhoneNumber`.
7809
+ #
9606
7810
  # @param [String] name
9607
- # Optional. The unique identifier of this phone number. Required for
9608
- # PhoneNumbers.UpdatePhoneNumber method. Format: `projects//phoneNumbers/`.
9609
- # Format: `projects//locations//phoneNumbers/`.
9610
7811
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1PhoneNumber] google_cloud_dialogflow_v2beta1_phone_number_object
9611
7812
  # @param [String] update_mask
9612
- # Optional. The mask to control which fields get updated.
9613
7813
  # @param [String] fields
9614
7814
  # Selector specifying which fields to include in a partial response.
9615
7815
  # @param [String] quota_user
@@ -9640,11 +7840,8 @@ module Google
9640
7840
  execute_or_queue_command(command, &block)
9641
7841
  end
9642
7842
 
9643
- # Cancels the deletion request for a `PhoneNumber`. This method may only be
9644
- # called on a `PhoneNumber` in the DELETE_REQUESTED state.
7843
+ #
9645
7844
  # @param [String] name
9646
- # Required. The unique identifier of the `PhoneNumber` to delete. Format: `
9647
- # projects//phoneNumbers/`. Format: `projects//locations//phoneNumbers/`.
9648
7845
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1UndeletePhoneNumberRequest] google_cloud_dialogflow_v2beta1_undelete_phone_number_request_object
9649
7846
  # @param [String] fields
9650
7847
  # Selector specifying which fields to include in a partial response.
@@ -9675,10 +7872,8 @@ module Google
9675
7872
  execute_or_queue_command(command, &block)
9676
7873
  end
9677
7874
 
9678
- # Creates a SipTrunk for a specified location.
7875
+ #
9679
7876
  # @param [String] parent
9680
- # Required. The location to create a SIP trunk for. Format: `projects//locations/
9681
- # `.
9682
7877
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SipTrunk] google_cloud_dialogflow_v2beta1_sip_trunk_object
9683
7878
  # @param [String] fields
9684
7879
  # Selector specifying which fields to include in a partial response.
@@ -9709,10 +7904,8 @@ module Google
9709
7904
  execute_or_queue_command(command, &block)
9710
7905
  end
9711
7906
 
9712
- # Deletes a specified SipTrunk.
7907
+ #
9713
7908
  # @param [String] name
9714
- # Required. The name of the SIP trunk to delete. Format: `projects//locations//
9715
- # sipTrunks/`.
9716
7909
  # @param [String] fields
9717
7910
  # Selector specifying which fields to include in a partial response.
9718
7911
  # @param [String] quota_user
@@ -9740,10 +7933,8 @@ module Google
9740
7933
  execute_or_queue_command(command, &block)
9741
7934
  end
9742
7935
 
9743
- # Retrieves the specified SipTrunk.
7936
+ #
9744
7937
  # @param [String] name
9745
- # Required. The name of the SIP trunk to delete. Format: `projects//locations//
9746
- # sipTrunks/`.
9747
7938
  # @param [String] fields
9748
7939
  # Selector specifying which fields to include in a partial response.
9749
7940
  # @param [String] quota_user
@@ -9771,14 +7962,10 @@ module Google
9771
7962
  execute_or_queue_command(command, &block)
9772
7963
  end
9773
7964
 
9774
- # Returns a list of SipTrunks in the specified location.
7965
+ #
9775
7966
  # @param [String] parent
9776
- # Required. The location to list SIP trunks from. Format: `projects//locations/`.
9777
7967
  # @param [Fixnum] page_size
9778
- # Optional. The maximum number of items to return in a single page. By default
9779
- # 100 and at most 1000.
9780
7968
  # @param [String] page_token
9781
- # Optional. The next_page_token value returned from a previous list request.
9782
7969
  # @param [String] fields
9783
7970
  # Selector specifying which fields to include in a partial response.
9784
7971
  # @param [String] quota_user
@@ -9808,14 +7995,10 @@ module Google
9808
7995
  execute_or_queue_command(command, &block)
9809
7996
  end
9810
7997
 
9811
- # Updates the specified SipTrunk.
7998
+ #
9812
7999
  # @param [String] name
9813
- # Identifier. The unique identifier of the SIP trunk. Format: `projects//
9814
- # locations//sipTrunks/`.
9815
8000
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SipTrunk] google_cloud_dialogflow_v2beta1_sip_trunk_object
9816
8001
  # @param [String] update_mask
9817
- # Optional. The mask to control which fields get updated. If the mask is not
9818
- # present, all fields will be updated.
9819
8002
  # @param [String] fields
9820
8003
  # Selector specifying which fields to include in a partial response.
9821
8004
  # @param [String] quota_user
@@ -9846,11 +8029,8 @@ module Google
9846
8029
  execute_or_queue_command(command, &block)
9847
8030
  end
9848
8031
 
9849
- # Generates and returns a suggestion for a conversation that does not have a
9850
- # resource created for it.
8032
+ #
9851
8033
  # @param [String] parent
9852
- # Required. The parent resource to charge for the Suggestion's generation.
9853
- # Format: `projects//locations/`.
9854
8034
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1GenerateStatelessSuggestionRequest] google_cloud_dialogflow_v2beta1_generate_stateless_suggestion_request_object
9855
8035
  # @param [String] fields
9856
8036
  # Selector specifying which fields to include in a partial response.
@@ -9881,11 +8061,8 @@ module Google
9881
8061
  execute_or_queue_command(command, &block)
9882
8062
  end
9883
8063
 
9884
- # Generates and returns a summary for a conversation that does not have a
9885
- # resource created for it.
8064
+ #
9886
8065
  # @param [String] parent
9887
- # Required. The parent resource to charge for the Summary's generation. Format: `
9888
- # projects//locations/`.
9889
8066
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1GenerateStatelessSummaryRequest] google_cloud_dialogflow_v2beta1_generate_stateless_summary_request_object
9890
8067
  # @param [String] fields
9891
8068
  # Selector specifying which fields to include in a partial response.
@@ -9916,10 +8093,8 @@ module Google
9916
8093
  execute_or_queue_command(command, &block)
9917
8094
  end
9918
8095
 
9919
- # Get answers for the given query based on knowledge documents.
8096
+ #
9920
8097
  # @param [String] parent
9921
- # Required. The parent resource contains the conversation profile Format: '
9922
- # projects/' or `projects//locations/`.
9923
8098
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SearchKnowledgeRequest] google_cloud_dialogflow_v2beta1_search_knowledge_request_object
9924
8099
  # @param [String] fields
9925
8100
  # Selector specifying which fields to include in a partial response.
@@ -9950,19 +8125,10 @@ module Google
9950
8125
  execute_or_queue_command(command, &block)
9951
8126
  end
9952
8127
 
9953
- # Creates a tool.
8128
+ #
9954
8129
  # @param [String] parent
9955
- # Required. The project/location to create tool for. Format: `projects//
9956
- # locations/`
9957
8130
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Tool] google_cloud_dialogflow_v2beta1_tool_object
9958
8131
  # @param [String] tool_id
9959
- # Optional. The ID to use for the tool, which will become the final component of
9960
- # the tool's resource name. The tool ID must be compliant with the regression
9961
- # formula `a-zA-Z*` with the characters length in range of [3,64]. If the field
9962
- # is not provide, an Id will be auto-generated. If the field is provided, the
9963
- # caller is responsible for 1. the uniqueness of the ID, otherwise the request
9964
- # will be rejected. 2. the consistency for whether to use custom ID or not under
9965
- # a project to better ensure uniqueness.
9966
8132
  # @param [String] fields
9967
8133
  # Selector specifying which fields to include in a partial response.
9968
8134
  # @param [String] quota_user
@@ -9993,10 +8159,8 @@ module Google
9993
8159
  execute_or_queue_command(command, &block)
9994
8160
  end
9995
8161
 
9996
- # Deletes a tool.
8162
+ #
9997
8163
  # @param [String] name
9998
- # Required. The tool resource name to delete. Format: `projects//locations//
9999
- # tools/`
10000
8164
  # @param [String] fields
10001
8165
  # Selector specifying which fields to include in a partial response.
10002
8166
  # @param [String] quota_user
@@ -10024,10 +8188,8 @@ module Google
10024
8188
  execute_or_queue_command(command, &block)
10025
8189
  end
10026
8190
 
10027
- # Retrieves a tool.
8191
+ #
10028
8192
  # @param [String] name
10029
- # Required. The tool resource name to retrieve. Format: `projects//locations//
10030
- # tools/`
10031
8193
  # @param [String] fields
10032
8194
  # Selector specifying which fields to include in a partial response.
10033
8195
  # @param [String] quota_user
@@ -10055,15 +8217,10 @@ module Google
10055
8217
  execute_or_queue_command(command, &block)
10056
8218
  end
10057
8219
 
10058
- # Lists tools.
8220
+ #
10059
8221
  # @param [String] parent
10060
- # Required. The project/location to list tools for. Format: `projects//locations/
10061
- # `
10062
8222
  # @param [Fixnum] page_size
10063
- # Optional. Maximum number of conversation models to return in a single page.
10064
- # Default to 10.
10065
8223
  # @param [String] page_token
10066
- # Optional. The next_page_token value returned from a previous list request.
10067
8224
  # @param [String] fields
10068
8225
  # Selector specifying which fields to include in a partial response.
10069
8226
  # @param [String] quota_user
@@ -10093,13 +8250,10 @@ module Google
10093
8250
  execute_or_queue_command(command, &block)
10094
8251
  end
10095
8252
 
10096
- # Updates a tool.
8253
+ #
10097
8254
  # @param [String] name
10098
- # Output only. Identifier. The resource name of the tool. Format: `projects//
10099
- # locations//tools/`.
10100
8255
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Tool] google_cloud_dialogflow_v2beta1_tool_object
10101
8256
  # @param [String] update_mask
10102
- # Optional. The list of fields to update.
10103
8257
  # @param [String] fields
10104
8258
  # Selector specifying which fields to include in a partial response.
10105
8259
  # @param [String] quota_user
@@ -10130,16 +8284,8 @@ module Google
10130
8284
  execute_or_queue_command(command, &block)
10131
8285
  end
10132
8286
 
10133
- # Starts asynchronous cancellation on a long-running operation. The server makes
10134
- # a best effort to cancel the operation, but success is not guaranteed. If the
10135
- # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
10136
- # Clients can use Operations.GetOperation or other methods to check whether the
10137
- # cancellation succeeded or whether the operation completed despite cancellation.
10138
- # On successful cancellation, the operation is not deleted; instead, it becomes
10139
- # an operation with an Operation.error value with a google.rpc.Status.code of `1`
10140
- # , corresponding to `Code.CANCELLED`.
8287
+ #
10141
8288
  # @param [String] name
10142
- # The name of the operation resource to be cancelled.
10143
8289
  # @param [String] fields
10144
8290
  # Selector specifying which fields to include in a partial response.
10145
8291
  # @param [String] quota_user
@@ -10167,10 +8313,8 @@ module Google
10167
8313
  execute_or_queue_command(command, &block)
10168
8314
  end
10169
8315
 
10170
- # Gets the latest state of a long-running operation. Clients can use this method
10171
- # to poll the operation result at intervals as recommended by the API service.
8316
+ #
10172
8317
  # @param [String] name
10173
- # The name of the operation resource.
10174
8318
  # @param [String] fields
10175
8319
  # Selector specifying which fields to include in a partial response.
10176
8320
  # @param [String] quota_user
@@ -10198,23 +8342,12 @@ module Google
10198
8342
  execute_or_queue_command(command, &block)
10199
8343
  end
10200
8344
 
10201
- # Lists operations that match the specified filter in the request. If the server
10202
- # doesn't support this method, it returns `UNIMPLEMENTED`.
8345
+ #
10203
8346
  # @param [String] name
10204
- # The name of the operation's parent resource.
10205
8347
  # @param [String] filter
10206
- # The standard list filter.
10207
8348
  # @param [Fixnum] page_size
10208
- # The standard list page size.
10209
8349
  # @param [String] page_token
10210
- # The standard list page token.
10211
8350
  # @param [Boolean] return_partial_success
10212
- # When set to `true`, operations that are reachable are returned as normal, and
10213
- # those that are unreachable are returned in the [ListOperationsResponse.
10214
- # unreachable] field. This can only be `true` when reading across collections e.
10215
- # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
10216
- # by default supported and will result in an `UNIMPLEMENTED` error if set unless
10217
- # explicitly documented otherwise in service or product specific documentation.
10218
8351
  # @param [String] fields
10219
8352
  # Selector specifying which fields to include in a partial response.
10220
8353
  # @param [String] quota_user
@@ -10246,12 +8379,8 @@ module Google
10246
8379
  execute_or_queue_command(command, &block)
10247
8380
  end
10248
8381
 
10249
- # Requests deletion of a `PhoneNumber`. The `PhoneNumber` is moved into the
10250
- # DELETE_REQUESTED state immediately, and is deleted approximately 30 days later.
10251
- # This method may only be called on a `PhoneNumber` in the ACTIVE state.
8382
+ #
10252
8383
  # @param [String] name
10253
- # Required. The unique identifier of the `PhoneNumber` to delete. Format: `
10254
- # projects//phoneNumbers/`. Format: `projects//locations//phoneNumbers/`.
10255
8384
  # @param [String] fields
10256
8385
  # Selector specifying which fields to include in a partial response.
10257
8386
  # @param [String] quota_user
@@ -10279,18 +8408,11 @@ module Google
10279
8408
  execute_or_queue_command(command, &block)
10280
8409
  end
10281
8410
 
10282
- # Returns the list of all phone numbers in the specified project.
8411
+ #
10283
8412
  # @param [String] parent
10284
- # Required. The project to list all `PhoneNumber` resources from. Format: `
10285
- # projects/`. Format: `projects//locations/`.
10286
8413
  # @param [Fixnum] page_size
10287
- # Optional. The maximum number of items to return in a single page. The default
10288
- # value is 100. The maximum value is 1000.
10289
8414
  # @param [String] page_token
10290
- # Optional. The next_page_token value returned from a previous list request.
10291
8415
  # @param [Boolean] show_deleted
10292
- # Optional. Controls whether `PhoneNumber` resources in the DELETE_REQUESTED
10293
- # state should be returned. Defaults to false.
10294
8416
  # @param [String] fields
10295
8417
  # Selector specifying which fields to include in a partial response.
10296
8418
  # @param [String] quota_user
@@ -10321,14 +8443,10 @@ module Google
10321
8443
  execute_or_queue_command(command, &block)
10322
8444
  end
10323
8445
 
10324
- # Updates the specified `PhoneNumber`.
8446
+ #
10325
8447
  # @param [String] name
10326
- # Optional. The unique identifier of this phone number. Required for
10327
- # PhoneNumbers.UpdatePhoneNumber method. Format: `projects//phoneNumbers/`.
10328
- # Format: `projects//locations//phoneNumbers/`.
10329
8448
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1PhoneNumber] google_cloud_dialogflow_v2beta1_phone_number_object
10330
8449
  # @param [String] update_mask
10331
- # Optional. The mask to control which fields get updated.
10332
8450
  # @param [String] fields
10333
8451
  # Selector specifying which fields to include in a partial response.
10334
8452
  # @param [String] quota_user
@@ -10359,11 +8477,8 @@ module Google
10359
8477
  execute_or_queue_command(command, &block)
10360
8478
  end
10361
8479
 
10362
- # Cancels the deletion request for a `PhoneNumber`. This method may only be
10363
- # called on a `PhoneNumber` in the DELETE_REQUESTED state.
8480
+ #
10364
8481
  # @param [String] name
10365
- # Required. The unique identifier of the `PhoneNumber` to delete. Format: `
10366
- # projects//phoneNumbers/`. Format: `projects//locations//phoneNumbers/`.
10367
8482
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1UndeletePhoneNumberRequest] google_cloud_dialogflow_v2beta1_undelete_phone_number_request_object
10368
8483
  # @param [String] fields
10369
8484
  # Selector specifying which fields to include in a partial response.
@@ -10394,11 +8509,8 @@ module Google
10394
8509
  execute_or_queue_command(command, &block)
10395
8510
  end
10396
8511
 
10397
- # Generates and returns a summary for a conversation that does not have a
10398
- # resource created for it.
8512
+ #
10399
8513
  # @param [String] parent
10400
- # Required. The parent resource to charge for the Summary's generation. Format: `
10401
- # projects//locations/`.
10402
8514
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1GenerateStatelessSummaryRequest] google_cloud_dialogflow_v2beta1_generate_stateless_summary_request_object
10403
8515
  # @param [String] fields
10404
8516
  # Selector specifying which fields to include in a partial response.
@@ -10429,10 +8541,8 @@ module Google
10429
8541
  execute_or_queue_command(command, &block)
10430
8542
  end
10431
8543
 
10432
- # Get answers for the given query based on knowledge documents.
8544
+ #
10433
8545
  # @param [String] parent
10434
- # Required. The parent resource contains the conversation profile Format: '
10435
- # projects/' or `projects//locations/`.
10436
8546
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SearchKnowledgeRequest] google_cloud_dialogflow_v2beta1_search_knowledge_request_object
10437
8547
  # @param [String] fields
10438
8548
  # Selector specifying which fields to include in a partial response.