google-apis-dialogflow_v2 0.10.0 → 0.11.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.
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module DialogflowV2
18
18
  # Version of the google-apis-dialogflow_v2 gem
19
- GEM_VERSION = "0.10.0"
19
+ GEM_VERSION = "0.11.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.2.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210329"
25
+ REVISION = "20210426"
26
26
  end
27
27
  end
28
28
  end
@@ -100,6 +100,12 @@ module Google
100
100
  include Google::Apis::Core::JsonObjectSupport
101
101
  end
102
102
 
103
+ class GoogleCloudDialogflowCxV3ExportFlowResponse
104
+ class Representation < Google::Apis::Core::JsonRepresentation; end
105
+
106
+ include Google::Apis::Core::JsonObjectSupport
107
+ end
108
+
103
109
  class GoogleCloudDialogflowCxV3ExportTestCasesMetadata
104
110
  class Representation < Google::Apis::Core::JsonRepresentation; end
105
111
 
@@ -178,6 +184,12 @@ module Google
178
184
  include Google::Apis::Core::JsonObjectSupport
179
185
  end
180
186
 
187
+ class GoogleCloudDialogflowCxV3ImportFlowResponse
188
+ class Representation < Google::Apis::Core::JsonRepresentation; end
189
+
190
+ include Google::Apis::Core::JsonObjectSupport
191
+ end
192
+
181
193
  class GoogleCloudDialogflowCxV3ImportTestCasesMetadata
182
194
  class Representation < Google::Apis::Core::JsonRepresentation; end
183
195
 
@@ -508,6 +520,12 @@ module Google
508
520
  include Google::Apis::Core::JsonObjectSupport
509
521
  end
510
522
 
523
+ class GoogleCloudDialogflowCxV3beta1ExportFlowResponse
524
+ class Representation < Google::Apis::Core::JsonRepresentation; end
525
+
526
+ include Google::Apis::Core::JsonObjectSupport
527
+ end
528
+
511
529
  class GoogleCloudDialogflowCxV3beta1ExportTestCasesMetadata
512
530
  class Representation < Google::Apis::Core::JsonRepresentation; end
513
531
 
@@ -586,6 +604,12 @@ module Google
586
604
  include Google::Apis::Core::JsonObjectSupport
587
605
  end
588
606
 
607
+ class GoogleCloudDialogflowCxV3beta1ImportFlowResponse
608
+ class Representation < Google::Apis::Core::JsonRepresentation; end
609
+
610
+ include Google::Apis::Core::JsonObjectSupport
611
+ end
612
+
589
613
  class GoogleCloudDialogflowCxV3beta1ImportTestCasesMetadata
590
614
  class Representation < Google::Apis::Core::JsonRepresentation; end
591
615
 
@@ -1048,6 +1072,18 @@ module Google
1048
1072
  include Google::Apis::Core::JsonObjectSupport
1049
1073
  end
1050
1074
 
1075
+ class GoogleCloudDialogflowV2EnvironmentHistory
1076
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1077
+
1078
+ include Google::Apis::Core::JsonObjectSupport
1079
+ end
1080
+
1081
+ class GoogleCloudDialogflowV2EnvironmentHistoryEntry
1082
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1083
+
1084
+ include Google::Apis::Core::JsonObjectSupport
1085
+ end
1086
+
1051
1087
  class GoogleCloudDialogflowV2EventInput
1052
1088
  class Representation < Google::Apis::Core::JsonRepresentation; end
1053
1089
 
@@ -1480,6 +1516,12 @@ module Google
1480
1516
  include Google::Apis::Core::JsonObjectSupport
1481
1517
  end
1482
1518
 
1519
+ class GoogleCloudDialogflowV2ListVersionsResponse
1520
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1521
+
1522
+ include Google::Apis::Core::JsonObjectSupport
1523
+ end
1524
+
1483
1525
  class GoogleCloudDialogflowV2LoggingConfig
1484
1526
  class Representation < Google::Apis::Core::JsonRepresentation; end
1485
1527
 
@@ -1648,6 +1690,12 @@ module Google
1648
1690
  include Google::Apis::Core::JsonObjectSupport
1649
1691
  end
1650
1692
 
1693
+ class GoogleCloudDialogflowV2TextToSpeechSettings
1694
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1695
+
1696
+ include Google::Apis::Core::JsonObjectSupport
1697
+ end
1698
+
1651
1699
  class GoogleCloudDialogflowV2TrainAgentRequest
1652
1700
  class Representation < Google::Apis::Core::JsonRepresentation; end
1653
1701
 
@@ -1666,6 +1714,12 @@ module Google
1666
1714
  include Google::Apis::Core::JsonObjectSupport
1667
1715
  end
1668
1716
 
1717
+ class GoogleCloudDialogflowV2Version
1718
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1719
+
1720
+ include Google::Apis::Core::JsonObjectSupport
1721
+ end
1722
+
1669
1723
  class GoogleCloudDialogflowV2VoiceSelectionParams
1670
1724
  class Representation < Google::Apis::Core::JsonRepresentation; end
1671
1725
 
@@ -2339,6 +2393,14 @@ module Google
2339
2393
  end
2340
2394
  end
2341
2395
 
2396
+ class GoogleCloudDialogflowCxV3ExportFlowResponse
2397
+ # @private
2398
+ class Representation < Google::Apis::Core::JsonRepresentation
2399
+ property :flow_content, :base64 => true, as: 'flowContent'
2400
+ property :flow_uri, as: 'flowUri'
2401
+ end
2402
+ end
2403
+
2342
2404
  class GoogleCloudDialogflowCxV3ExportTestCasesMetadata
2343
2405
  # @private
2344
2406
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2457,6 +2519,13 @@ module Google
2457
2519
  end
2458
2520
  end
2459
2521
 
2522
+ class GoogleCloudDialogflowCxV3ImportFlowResponse
2523
+ # @private
2524
+ class Representation < Google::Apis::Core::JsonRepresentation
2525
+ property :flow, as: 'flow'
2526
+ end
2527
+ end
2528
+
2460
2529
  class GoogleCloudDialogflowCxV3ImportTestCasesMetadata
2461
2530
  # @private
2462
2531
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2812,6 +2881,7 @@ module Google
2812
2881
 
2813
2882
  property :intent_info, as: 'intentInfo', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3WebhookRequestIntentInfo, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3WebhookRequestIntentInfo::Representation
2814
2883
 
2884
+ property :language_code, as: 'languageCode'
2815
2885
  collection :messages, as: 'messages', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3ResponseMessage, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3ResponseMessage::Representation
2816
2886
 
2817
2887
  property :page_info, as: 'pageInfo', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3PageInfo, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3PageInfo::Representation
@@ -3007,6 +3077,14 @@ module Google
3007
3077
  end
3008
3078
  end
3009
3079
 
3080
+ class GoogleCloudDialogflowCxV3beta1ExportFlowResponse
3081
+ # @private
3082
+ class Representation < Google::Apis::Core::JsonRepresentation
3083
+ property :flow_content, :base64 => true, as: 'flowContent'
3084
+ property :flow_uri, as: 'flowUri'
3085
+ end
3086
+ end
3087
+
3010
3088
  class GoogleCloudDialogflowCxV3beta1ExportTestCasesMetadata
3011
3089
  # @private
3012
3090
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -3125,6 +3203,13 @@ module Google
3125
3203
  end
3126
3204
  end
3127
3205
 
3206
+ class GoogleCloudDialogflowCxV3beta1ImportFlowResponse
3207
+ # @private
3208
+ class Representation < Google::Apis::Core::JsonRepresentation
3209
+ property :flow, as: 'flow'
3210
+ end
3211
+ end
3212
+
3128
3213
  class GoogleCloudDialogflowCxV3beta1ImportTestCasesMetadata
3129
3214
  # @private
3130
3215
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -3480,6 +3565,7 @@ module Google
3480
3565
 
3481
3566
  property :intent_info, as: 'intentInfo', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1WebhookRequestIntentInfo::Representation
3482
3567
 
3568
+ property :language_code, as: 'languageCode'
3483
3569
  collection :messages, as: 'messages', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessage, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessage::Representation
3484
3570
 
3485
3571
  property :page_info, as: 'pageInfo', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1PageInfo, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1PageInfo::Representation
@@ -3933,12 +4019,35 @@ module Google
3933
4019
  class Representation < Google::Apis::Core::JsonRepresentation
3934
4020
  property :agent_version, as: 'agentVersion'
3935
4021
  property :description, as: 'description'
4022
+ property :fulfillment, as: 'fulfillment', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Fulfillment, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Fulfillment::Representation
4023
+
3936
4024
  property :name, as: 'name'
3937
4025
  property :state, as: 'state'
4026
+ property :text_to_speech_settings, as: 'textToSpeechSettings', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2TextToSpeechSettings, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2TextToSpeechSettings::Representation
4027
+
3938
4028
  property :update_time, as: 'updateTime'
3939
4029
  end
3940
4030
  end
3941
4031
 
4032
+ class GoogleCloudDialogflowV2EnvironmentHistory
4033
+ # @private
4034
+ class Representation < Google::Apis::Core::JsonRepresentation
4035
+ collection :entries, as: 'entries', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistoryEntry, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistoryEntry::Representation
4036
+
4037
+ property :next_page_token, as: 'nextPageToken'
4038
+ property :parent, as: 'parent'
4039
+ end
4040
+ end
4041
+
4042
+ class GoogleCloudDialogflowV2EnvironmentHistoryEntry
4043
+ # @private
4044
+ class Representation < Google::Apis::Core::JsonRepresentation
4045
+ property :agent_version, as: 'agentVersion'
4046
+ property :create_time, as: 'createTime'
4047
+ property :description, as: 'description'
4048
+ end
4049
+ end
4050
+
3942
4051
  class GoogleCloudDialogflowV2EventInput
3943
4052
  # @private
3944
4053
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -4668,6 +4777,15 @@ module Google
4668
4777
  end
4669
4778
  end
4670
4779
 
4780
+ class GoogleCloudDialogflowV2ListVersionsResponse
4781
+ # @private
4782
+ class Representation < Google::Apis::Core::JsonRepresentation
4783
+ property :next_page_token, as: 'nextPageToken'
4784
+ collection :versions, as: 'versions', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
4785
+
4786
+ end
4787
+ end
4788
+
4671
4789
  class GoogleCloudDialogflowV2LoggingConfig
4672
4790
  # @private
4673
4791
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -4945,6 +5063,17 @@ module Google
4945
5063
  end
4946
5064
  end
4947
5065
 
5066
+ class GoogleCloudDialogflowV2TextToSpeechSettings
5067
+ # @private
5068
+ class Representation < Google::Apis::Core::JsonRepresentation
5069
+ property :enable_text_to_speech, as: 'enableTextToSpeech'
5070
+ property :output_audio_encoding, as: 'outputAudioEncoding'
5071
+ property :sample_rate_hertz, as: 'sampleRateHertz'
5072
+ hash :synthesize_speech_configs, as: 'synthesizeSpeechConfigs', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SynthesizeSpeechConfig, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SynthesizeSpeechConfig::Representation
5073
+
5074
+ end
5075
+ end
5076
+
4948
5077
  class GoogleCloudDialogflowV2TrainAgentRequest
4949
5078
  # @private
4950
5079
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -4968,6 +5097,17 @@ module Google
4968
5097
  end
4969
5098
  end
4970
5099
 
5100
+ class GoogleCloudDialogflowV2Version
5101
+ # @private
5102
+ class Representation < Google::Apis::Core::JsonRepresentation
5103
+ property :create_time, as: 'createTime'
5104
+ property :description, as: 'description'
5105
+ property :name, as: 'name'
5106
+ property :status, as: 'status'
5107
+ property :version_number, as: 'versionNumber'
5108
+ end
5109
+ end
5110
+
4971
5111
  class GoogleCloudDialogflowV2VoiceSelectionParams
4972
5112
  # @private
4973
5113
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -409,8 +409,9 @@ module Google
409
409
 
410
410
  # Updates the fulfillment.
411
411
  # @param [String] name
412
- # Required. The unique identifier of the fulfillment. Format: `projects//agent/
413
- # fulfillment`.
412
+ # Required. The unique identifier of the fulfillment. Supported formats: - `
413
+ # projects//agent/fulfillment` - `projects//locations//agent/fulfillment` This
414
+ # field is not used for Fulfillment in an Environment.
414
415
  # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Fulfillment] google_cloud_dialogflow_v2_fulfillment_object
415
416
  # @param [String] update_mask
416
417
  # Required. The mask to control which fields get updated. If the mask is not
@@ -810,9 +811,148 @@ module Google
810
811
  execute_or_queue_command(command, &block)
811
812
  end
812
813
 
814
+ # Creates an agent environment.
815
+ # @param [String] parent
816
+ # Required. The agent to create an environment for. Supported formats: - `
817
+ # projects//agent` - `projects//locations//agent`
818
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] google_cloud_dialogflow_v2_environment_object
819
+ # @param [String] environment_id
820
+ # Required. The unique id of the new environment.
821
+ # @param [String] fields
822
+ # Selector specifying which fields to include in a partial response.
823
+ # @param [String] quota_user
824
+ # Available to use for quota purposes for server-side applications. Can be any
825
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
826
+ # @param [Google::Apis::RequestOptions] options
827
+ # Request-specific options
828
+ #
829
+ # @yield [result, err] Result & error if block supplied
830
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] parsed result object
831
+ # @yieldparam err [StandardError] error object if request failed
832
+ #
833
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment]
834
+ #
835
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
836
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
837
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
838
+ def create_project_agent_environment(parent, google_cloud_dialogflow_v2_environment_object = nil, environment_id: nil, fields: nil, quota_user: nil, options: nil, &block)
839
+ command = make_simple_command(:post, 'v2/{+parent}/environments', options)
840
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
841
+ command.request_object = google_cloud_dialogflow_v2_environment_object
842
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
843
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment
844
+ command.params['parent'] = parent unless parent.nil?
845
+ command.query['environmentId'] = environment_id unless environment_id.nil?
846
+ command.query['fields'] = fields unless fields.nil?
847
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
848
+ execute_or_queue_command(command, &block)
849
+ end
850
+
851
+ # Deletes the specified agent environment.
852
+ # @param [String] name
853
+ # Required. The name of the environment to delete. / Format: - `projects//agent/
854
+ # environments/` - `projects//locations//agent/environments/`
855
+ # @param [String] fields
856
+ # Selector specifying which fields to include in a partial response.
857
+ # @param [String] quota_user
858
+ # Available to use for quota purposes for server-side applications. Can be any
859
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
860
+ # @param [Google::Apis::RequestOptions] options
861
+ # Request-specific options
862
+ #
863
+ # @yield [result, err] Result & error if block supplied
864
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleProtobufEmpty] parsed result object
865
+ # @yieldparam err [StandardError] error object if request failed
866
+ #
867
+ # @return [Google::Apis::DialogflowV2::GoogleProtobufEmpty]
868
+ #
869
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
870
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
871
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
872
+ def delete_project_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
873
+ command = make_simple_command(:delete, 'v2/{+name}', options)
874
+ command.response_representation = Google::Apis::DialogflowV2::GoogleProtobufEmpty::Representation
875
+ command.response_class = Google::Apis::DialogflowV2::GoogleProtobufEmpty
876
+ command.params['name'] = name unless name.nil?
877
+ command.query['fields'] = fields unless fields.nil?
878
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
879
+ execute_or_queue_command(command, &block)
880
+ end
881
+
882
+ # Retrieves the specified agent environment.
883
+ # @param [String] name
884
+ # Required. The name of the environment. Supported formats: - `projects//agent/
885
+ # environments/` - `projects//locations//agent/environments/`
886
+ # @param [String] fields
887
+ # Selector specifying which fields to include in a partial response.
888
+ # @param [String] quota_user
889
+ # Available to use for quota purposes for server-side applications. Can be any
890
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
891
+ # @param [Google::Apis::RequestOptions] options
892
+ # Request-specific options
893
+ #
894
+ # @yield [result, err] Result & error if block supplied
895
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] parsed result object
896
+ # @yieldparam err [StandardError] error object if request failed
897
+ #
898
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment]
899
+ #
900
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
901
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
902
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
903
+ def get_project_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
904
+ command = make_simple_command(:get, 'v2/{+name}', options)
905
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
906
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment
907
+ command.params['name'] = name unless name.nil?
908
+ command.query['fields'] = fields unless fields.nil?
909
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
910
+ execute_or_queue_command(command, &block)
911
+ end
912
+
913
+ # Gets the history of the specified environment.
914
+ # @param [String] parent
915
+ # Required. The name of the environment to retrieve history for. Supported
916
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
917
+ # environments/`
918
+ # @param [Fixnum] page_size
919
+ # Optional. The maximum number of items to return in a single page. By default
920
+ # 100 and at most 1000.
921
+ # @param [String] page_token
922
+ # Optional. The next_page_token value returned from a previous list request.
923
+ # @param [String] fields
924
+ # Selector specifying which fields to include in a partial response.
925
+ # @param [String] quota_user
926
+ # Available to use for quota purposes for server-side applications. Can be any
927
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
928
+ # @param [Google::Apis::RequestOptions] options
929
+ # Request-specific options
930
+ #
931
+ # @yield [result, err] Result & error if block supplied
932
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory] parsed result object
933
+ # @yieldparam err [StandardError] error object if request failed
934
+ #
935
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory]
936
+ #
937
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
938
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
939
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
940
+ def get_project_agent_environment_history(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
941
+ command = make_simple_command(:get, 'v2/{+parent}/history', options)
942
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory::Representation
943
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory
944
+ command.params['parent'] = parent unless parent.nil?
945
+ command.query['pageSize'] = page_size unless page_size.nil?
946
+ command.query['pageToken'] = page_token unless page_token.nil?
947
+ command.query['fields'] = fields unless fields.nil?
948
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
949
+ execute_or_queue_command(command, &block)
950
+ end
951
+
813
952
  # Returns the list of all non-draft environments of the specified agent.
814
953
  # @param [String] parent
815
- # Required. The agent to list all environments from. Format: `projects//agent`.
954
+ # Required. The agent to list all environments from. Format: - `projects//agent`
955
+ # - `projects//locations//agent`
816
956
  # @param [Fixnum] page_size
817
957
  # Optional. The maximum number of items to return in a single page. By default
818
958
  # 100 and at most 1000.
@@ -847,6 +987,59 @@ module Google
847
987
  execute_or_queue_command(command, &block)
848
988
  end
849
989
 
990
+ # Updates the specified agent environment. This method allows you to deploy new
991
+ # agent versions into the environment. When an environment is pointed to a new
992
+ # agent version by setting `environment.agent_version`, the environment is
993
+ # temporarily set to the `LOADING` state. During that time, the environment
994
+ # keeps on serving the previous version of the agent. After the new agent
995
+ # version is done loading, the environment is set back to the `RUNNING` state.
996
+ # You can use "-" as Environment ID in environment name to update version in "
997
+ # draft" environment. WARNING: this will negate all recent changes to draft and
998
+ # can't be undone. You may want to save the draft to a version before calling
999
+ # this function.
1000
+ # @param [String] name
1001
+ # Output only. The unique identifier of this agent environment. Supported
1002
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
1003
+ # environments/`
1004
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] google_cloud_dialogflow_v2_environment_object
1005
+ # @param [Boolean] allow_load_to_draft_and_discard_changes
1006
+ # Optional. This field is used to prevent accidental overwrite of the draft
1007
+ # environment, which is an operation that cannot be undone. To confirm that the
1008
+ # caller desires this overwrite, this field must be explicitly set to true when
1009
+ # updating the draft environment (environment ID = `-`).
1010
+ # @param [String] update_mask
1011
+ # Required. The mask to control which fields get updated.
1012
+ # @param [String] fields
1013
+ # Selector specifying which fields to include in a partial response.
1014
+ # @param [String] quota_user
1015
+ # Available to use for quota purposes for server-side applications. Can be any
1016
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1017
+ # @param [Google::Apis::RequestOptions] options
1018
+ # Request-specific options
1019
+ #
1020
+ # @yield [result, err] Result & error if block supplied
1021
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] parsed result object
1022
+ # @yieldparam err [StandardError] error object if request failed
1023
+ #
1024
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment]
1025
+ #
1026
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1027
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1028
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1029
+ def patch_project_agent_environment(name, google_cloud_dialogflow_v2_environment_object = nil, allow_load_to_draft_and_discard_changes: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1030
+ command = make_simple_command(:patch, 'v2/{+name}', options)
1031
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
1032
+ command.request_object = google_cloud_dialogflow_v2_environment_object
1033
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
1034
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment
1035
+ command.params['name'] = name unless name.nil?
1036
+ command.query['allowLoadToDraftAndDiscardChanges'] = allow_load_to_draft_and_discard_changes unless allow_load_to_draft_and_discard_changes.nil?
1037
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1038
+ command.query['fields'] = fields unless fields.nil?
1039
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1040
+ execute_or_queue_command(command, &block)
1041
+ end
1042
+
850
1043
  # Returns the list of all intents in the specified agent.
851
1044
  # @param [String] parent
852
1045
  # Required. The agent to list all intents from. Format: `projects//agent`.
@@ -2482,6 +2675,180 @@ module Google
2482
2675
  execute_or_queue_command(command, &block)
2483
2676
  end
2484
2677
 
2678
+ # Creates an agent version. The new version points to the agent instance in the "
2679
+ # default" environment.
2680
+ # @param [String] parent
2681
+ # Required. The agent to create a version for. Supported formats: - `projects//
2682
+ # agent` - `projects//locations//agent`
2683
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] google_cloud_dialogflow_v2_version_object
2684
+ # @param [String] fields
2685
+ # Selector specifying which fields to include in a partial response.
2686
+ # @param [String] quota_user
2687
+ # Available to use for quota purposes for server-side applications. Can be any
2688
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2689
+ # @param [Google::Apis::RequestOptions] options
2690
+ # Request-specific options
2691
+ #
2692
+ # @yield [result, err] Result & error if block supplied
2693
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] parsed result object
2694
+ # @yieldparam err [StandardError] error object if request failed
2695
+ #
2696
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version]
2697
+ #
2698
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2699
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2700
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2701
+ def create_project_agent_version(parent, google_cloud_dialogflow_v2_version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2702
+ command = make_simple_command(:post, 'v2/{+parent}/versions', options)
2703
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
2704
+ command.request_object = google_cloud_dialogflow_v2_version_object
2705
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
2706
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version
2707
+ command.params['parent'] = parent unless parent.nil?
2708
+ command.query['fields'] = fields unless fields.nil?
2709
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2710
+ execute_or_queue_command(command, &block)
2711
+ end
2712
+
2713
+ # Delete the specified agent version.
2714
+ # @param [String] name
2715
+ # Required. The name of the version to delete. Supported formats: - `projects//
2716
+ # agent/versions/` - `projects//locations//agent/versions/`
2717
+ # @param [String] fields
2718
+ # Selector specifying which fields to include in a partial response.
2719
+ # @param [String] quota_user
2720
+ # Available to use for quota purposes for server-side applications. Can be any
2721
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2722
+ # @param [Google::Apis::RequestOptions] options
2723
+ # Request-specific options
2724
+ #
2725
+ # @yield [result, err] Result & error if block supplied
2726
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleProtobufEmpty] parsed result object
2727
+ # @yieldparam err [StandardError] error object if request failed
2728
+ #
2729
+ # @return [Google::Apis::DialogflowV2::GoogleProtobufEmpty]
2730
+ #
2731
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2732
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2733
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2734
+ def delete_project_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
2735
+ command = make_simple_command(:delete, 'v2/{+name}', options)
2736
+ command.response_representation = Google::Apis::DialogflowV2::GoogleProtobufEmpty::Representation
2737
+ command.response_class = Google::Apis::DialogflowV2::GoogleProtobufEmpty
2738
+ command.params['name'] = name unless name.nil?
2739
+ command.query['fields'] = fields unless fields.nil?
2740
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2741
+ execute_or_queue_command(command, &block)
2742
+ end
2743
+
2744
+ # Retrieves the specified agent version.
2745
+ # @param [String] name
2746
+ # Required. The name of the version. Supported formats: - `projects//agent/
2747
+ # versions/` - `projects//locations//agent/versions/`
2748
+ # @param [String] fields
2749
+ # Selector specifying which fields to include in a partial response.
2750
+ # @param [String] quota_user
2751
+ # Available to use for quota purposes for server-side applications. Can be any
2752
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2753
+ # @param [Google::Apis::RequestOptions] options
2754
+ # Request-specific options
2755
+ #
2756
+ # @yield [result, err] Result & error if block supplied
2757
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] parsed result object
2758
+ # @yieldparam err [StandardError] error object if request failed
2759
+ #
2760
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version]
2761
+ #
2762
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2763
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2764
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2765
+ def get_project_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
2766
+ command = make_simple_command(:get, 'v2/{+name}', options)
2767
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
2768
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version
2769
+ command.params['name'] = name unless name.nil?
2770
+ command.query['fields'] = fields unless fields.nil?
2771
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2772
+ execute_or_queue_command(command, &block)
2773
+ end
2774
+
2775
+ # Returns the list of all versions of the specified agent.
2776
+ # @param [String] parent
2777
+ # Required. The agent to list all versions from. Supported formats: - `projects//
2778
+ # agent` - `projects//locations//agent`
2779
+ # @param [Fixnum] page_size
2780
+ # Optional. The maximum number of items to return in a single page. By default
2781
+ # 100 and at most 1000.
2782
+ # @param [String] page_token
2783
+ # Optional. The next_page_token value returned from a previous list request.
2784
+ # @param [String] fields
2785
+ # Selector specifying which fields to include in a partial response.
2786
+ # @param [String] quota_user
2787
+ # Available to use for quota purposes for server-side applications. Can be any
2788
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2789
+ # @param [Google::Apis::RequestOptions] options
2790
+ # Request-specific options
2791
+ #
2792
+ # @yield [result, err] Result & error if block supplied
2793
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse] parsed result object
2794
+ # @yieldparam err [StandardError] error object if request failed
2795
+ #
2796
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse]
2797
+ #
2798
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2799
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2800
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2801
+ def list_project_agent_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2802
+ command = make_simple_command(:get, 'v2/{+parent}/versions', options)
2803
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse::Representation
2804
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse
2805
+ command.params['parent'] = parent unless parent.nil?
2806
+ command.query['pageSize'] = page_size unless page_size.nil?
2807
+ command.query['pageToken'] = page_token unless page_token.nil?
2808
+ command.query['fields'] = fields unless fields.nil?
2809
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2810
+ execute_or_queue_command(command, &block)
2811
+ end
2812
+
2813
+ # Updates the specified agent version. Note that this method does not allow you
2814
+ # to update the state of the agent the given version points to. It allows you to
2815
+ # update only mutable properties of the version resource.
2816
+ # @param [String] name
2817
+ # Output only. The unique identifier of this agent version. Supported formats: -
2818
+ # `projects//agent/versions/` - `projects//locations//agent/versions/`
2819
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] google_cloud_dialogflow_v2_version_object
2820
+ # @param [String] update_mask
2821
+ # Required. The mask to control which fields get updated.
2822
+ # @param [String] fields
2823
+ # Selector specifying which fields to include in a partial response.
2824
+ # @param [String] quota_user
2825
+ # Available to use for quota purposes for server-side applications. Can be any
2826
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2827
+ # @param [Google::Apis::RequestOptions] options
2828
+ # Request-specific options
2829
+ #
2830
+ # @yield [result, err] Result & error if block supplied
2831
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] parsed result object
2832
+ # @yieldparam err [StandardError] error object if request failed
2833
+ #
2834
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version]
2835
+ #
2836
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2837
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2838
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2839
+ def patch_project_agent_version(name, google_cloud_dialogflow_v2_version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2840
+ command = make_simple_command(:patch, 'v2/{+name}', options)
2841
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
2842
+ command.request_object = google_cloud_dialogflow_v2_version_object
2843
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
2844
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version
2845
+ command.params['name'] = name unless name.nil?
2846
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2847
+ command.query['fields'] = fields unless fields.nil?
2848
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2849
+ execute_or_queue_command(command, &block)
2850
+ end
2851
+
2485
2852
  # Returns the list of all answer records in the specified project in reverse
2486
2853
  # chronological order.
2487
2854
  # @param [String] parent
@@ -3952,8 +4319,9 @@ module Google
3952
4319
 
3953
4320
  # Updates the fulfillment.
3954
4321
  # @param [String] name
3955
- # Required. The unique identifier of the fulfillment. Format: `projects//agent/
3956
- # fulfillment`.
4322
+ # Required. The unique identifier of the fulfillment. Supported formats: - `
4323
+ # projects//agent/fulfillment` - `projects//locations//agent/fulfillment` This
4324
+ # field is not used for Fulfillment in an Environment.
3957
4325
  # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Fulfillment] google_cloud_dialogflow_v2_fulfillment_object
3958
4326
  # @param [String] update_mask
3959
4327
  # Required. The mask to control which fields get updated. If the mask is not
@@ -4353,9 +4721,148 @@ module Google
4353
4721
  execute_or_queue_command(command, &block)
4354
4722
  end
4355
4723
 
4724
+ # Creates an agent environment.
4725
+ # @param [String] parent
4726
+ # Required. The agent to create an environment for. Supported formats: - `
4727
+ # projects//agent` - `projects//locations//agent`
4728
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] google_cloud_dialogflow_v2_environment_object
4729
+ # @param [String] environment_id
4730
+ # Required. The unique id of the new environment.
4731
+ # @param [String] fields
4732
+ # Selector specifying which fields to include in a partial response.
4733
+ # @param [String] quota_user
4734
+ # Available to use for quota purposes for server-side applications. Can be any
4735
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4736
+ # @param [Google::Apis::RequestOptions] options
4737
+ # Request-specific options
4738
+ #
4739
+ # @yield [result, err] Result & error if block supplied
4740
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] parsed result object
4741
+ # @yieldparam err [StandardError] error object if request failed
4742
+ #
4743
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment]
4744
+ #
4745
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4746
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4747
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4748
+ def create_project_location_agent_environment(parent, google_cloud_dialogflow_v2_environment_object = nil, environment_id: nil, fields: nil, quota_user: nil, options: nil, &block)
4749
+ command = make_simple_command(:post, 'v2/{+parent}/environments', options)
4750
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
4751
+ command.request_object = google_cloud_dialogflow_v2_environment_object
4752
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
4753
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment
4754
+ command.params['parent'] = parent unless parent.nil?
4755
+ command.query['environmentId'] = environment_id unless environment_id.nil?
4756
+ command.query['fields'] = fields unless fields.nil?
4757
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4758
+ execute_or_queue_command(command, &block)
4759
+ end
4760
+
4761
+ # Deletes the specified agent environment.
4762
+ # @param [String] name
4763
+ # Required. The name of the environment to delete. / Format: - `projects//agent/
4764
+ # environments/` - `projects//locations//agent/environments/`
4765
+ # @param [String] fields
4766
+ # Selector specifying which fields to include in a partial response.
4767
+ # @param [String] quota_user
4768
+ # Available to use for quota purposes for server-side applications. Can be any
4769
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4770
+ # @param [Google::Apis::RequestOptions] options
4771
+ # Request-specific options
4772
+ #
4773
+ # @yield [result, err] Result & error if block supplied
4774
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleProtobufEmpty] parsed result object
4775
+ # @yieldparam err [StandardError] error object if request failed
4776
+ #
4777
+ # @return [Google::Apis::DialogflowV2::GoogleProtobufEmpty]
4778
+ #
4779
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4780
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4781
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4782
+ def delete_project_location_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
4783
+ command = make_simple_command(:delete, 'v2/{+name}', options)
4784
+ command.response_representation = Google::Apis::DialogflowV2::GoogleProtobufEmpty::Representation
4785
+ command.response_class = Google::Apis::DialogflowV2::GoogleProtobufEmpty
4786
+ command.params['name'] = name unless name.nil?
4787
+ command.query['fields'] = fields unless fields.nil?
4788
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4789
+ execute_or_queue_command(command, &block)
4790
+ end
4791
+
4792
+ # Retrieves the specified agent environment.
4793
+ # @param [String] name
4794
+ # Required. The name of the environment. Supported formats: - `projects//agent/
4795
+ # environments/` - `projects//locations//agent/environments/`
4796
+ # @param [String] fields
4797
+ # Selector specifying which fields to include in a partial response.
4798
+ # @param [String] quota_user
4799
+ # Available to use for quota purposes for server-side applications. Can be any
4800
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4801
+ # @param [Google::Apis::RequestOptions] options
4802
+ # Request-specific options
4803
+ #
4804
+ # @yield [result, err] Result & error if block supplied
4805
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] parsed result object
4806
+ # @yieldparam err [StandardError] error object if request failed
4807
+ #
4808
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment]
4809
+ #
4810
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4811
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4812
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4813
+ def get_project_location_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
4814
+ command = make_simple_command(:get, 'v2/{+name}', options)
4815
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
4816
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment
4817
+ command.params['name'] = name unless name.nil?
4818
+ command.query['fields'] = fields unless fields.nil?
4819
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4820
+ execute_or_queue_command(command, &block)
4821
+ end
4822
+
4823
+ # Gets the history of the specified environment.
4824
+ # @param [String] parent
4825
+ # Required. The name of the environment to retrieve history for. Supported
4826
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
4827
+ # environments/`
4828
+ # @param [Fixnum] page_size
4829
+ # Optional. The maximum number of items to return in a single page. By default
4830
+ # 100 and at most 1000.
4831
+ # @param [String] page_token
4832
+ # Optional. The next_page_token value returned from a previous list request.
4833
+ # @param [String] fields
4834
+ # Selector specifying which fields to include in a partial response.
4835
+ # @param [String] quota_user
4836
+ # Available to use for quota purposes for server-side applications. Can be any
4837
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4838
+ # @param [Google::Apis::RequestOptions] options
4839
+ # Request-specific options
4840
+ #
4841
+ # @yield [result, err] Result & error if block supplied
4842
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory] parsed result object
4843
+ # @yieldparam err [StandardError] error object if request failed
4844
+ #
4845
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory]
4846
+ #
4847
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4848
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4849
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4850
+ def get_project_location_agent_environment_history(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4851
+ command = make_simple_command(:get, 'v2/{+parent}/history', options)
4852
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory::Representation
4853
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistory
4854
+ command.params['parent'] = parent unless parent.nil?
4855
+ command.query['pageSize'] = page_size unless page_size.nil?
4856
+ command.query['pageToken'] = page_token unless page_token.nil?
4857
+ command.query['fields'] = fields unless fields.nil?
4858
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4859
+ execute_or_queue_command(command, &block)
4860
+ end
4861
+
4356
4862
  # Returns the list of all non-draft environments of the specified agent.
4357
4863
  # @param [String] parent
4358
- # Required. The agent to list all environments from. Format: `projects//agent`.
4864
+ # Required. The agent to list all environments from. Format: - `projects//agent`
4865
+ # - `projects//locations//agent`
4359
4866
  # @param [Fixnum] page_size
4360
4867
  # Optional. The maximum number of items to return in a single page. By default
4361
4868
  # 100 and at most 1000.
@@ -4390,6 +4897,59 @@ module Google
4390
4897
  execute_or_queue_command(command, &block)
4391
4898
  end
4392
4899
 
4900
+ # Updates the specified agent environment. This method allows you to deploy new
4901
+ # agent versions into the environment. When an environment is pointed to a new
4902
+ # agent version by setting `environment.agent_version`, the environment is
4903
+ # temporarily set to the `LOADING` state. During that time, the environment
4904
+ # keeps on serving the previous version of the agent. After the new agent
4905
+ # version is done loading, the environment is set back to the `RUNNING` state.
4906
+ # You can use "-" as Environment ID in environment name to update version in "
4907
+ # draft" environment. WARNING: this will negate all recent changes to draft and
4908
+ # can't be undone. You may want to save the draft to a version before calling
4909
+ # this function.
4910
+ # @param [String] name
4911
+ # Output only. The unique identifier of this agent environment. Supported
4912
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
4913
+ # environments/`
4914
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] google_cloud_dialogflow_v2_environment_object
4915
+ # @param [Boolean] allow_load_to_draft_and_discard_changes
4916
+ # Optional. This field is used to prevent accidental overwrite of the draft
4917
+ # environment, which is an operation that cannot be undone. To confirm that the
4918
+ # caller desires this overwrite, this field must be explicitly set to true when
4919
+ # updating the draft environment (environment ID = `-`).
4920
+ # @param [String] update_mask
4921
+ # Required. The mask to control which fields get updated.
4922
+ # @param [String] fields
4923
+ # Selector specifying which fields to include in a partial response.
4924
+ # @param [String] quota_user
4925
+ # Available to use for quota purposes for server-side applications. Can be any
4926
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4927
+ # @param [Google::Apis::RequestOptions] options
4928
+ # Request-specific options
4929
+ #
4930
+ # @yield [result, err] Result & error if block supplied
4931
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment] parsed result object
4932
+ # @yieldparam err [StandardError] error object if request failed
4933
+ #
4934
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment]
4935
+ #
4936
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4937
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4938
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4939
+ def patch_project_location_agent_environment(name, google_cloud_dialogflow_v2_environment_object = nil, allow_load_to_draft_and_discard_changes: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
4940
+ command = make_simple_command(:patch, 'v2/{+name}', options)
4941
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
4942
+ command.request_object = google_cloud_dialogflow_v2_environment_object
4943
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment::Representation
4944
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Environment
4945
+ command.params['name'] = name unless name.nil?
4946
+ command.query['allowLoadToDraftAndDiscardChanges'] = allow_load_to_draft_and_discard_changes unless allow_load_to_draft_and_discard_changes.nil?
4947
+ command.query['updateMask'] = update_mask unless update_mask.nil?
4948
+ command.query['fields'] = fields unless fields.nil?
4949
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4950
+ execute_or_queue_command(command, &block)
4951
+ end
4952
+
4393
4953
  # Deletes all active contexts in the specified session.
4394
4954
  # @param [String] parent
4395
4955
  # Required. The name of the session to delete all contexts from. Format: `
@@ -5590,6 +6150,180 @@ module Google
5590
6150
  execute_or_queue_command(command, &block)
5591
6151
  end
5592
6152
 
6153
+ # Creates an agent version. The new version points to the agent instance in the "
6154
+ # default" environment.
6155
+ # @param [String] parent
6156
+ # Required. The agent to create a version for. Supported formats: - `projects//
6157
+ # agent` - `projects//locations//agent`
6158
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] google_cloud_dialogflow_v2_version_object
6159
+ # @param [String] fields
6160
+ # Selector specifying which fields to include in a partial response.
6161
+ # @param [String] quota_user
6162
+ # Available to use for quota purposes for server-side applications. Can be any
6163
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6164
+ # @param [Google::Apis::RequestOptions] options
6165
+ # Request-specific options
6166
+ #
6167
+ # @yield [result, err] Result & error if block supplied
6168
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] parsed result object
6169
+ # @yieldparam err [StandardError] error object if request failed
6170
+ #
6171
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version]
6172
+ #
6173
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6174
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6175
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6176
+ def create_project_location_agent_version(parent, google_cloud_dialogflow_v2_version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6177
+ command = make_simple_command(:post, 'v2/{+parent}/versions', options)
6178
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
6179
+ command.request_object = google_cloud_dialogflow_v2_version_object
6180
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
6181
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version
6182
+ command.params['parent'] = parent unless parent.nil?
6183
+ command.query['fields'] = fields unless fields.nil?
6184
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6185
+ execute_or_queue_command(command, &block)
6186
+ end
6187
+
6188
+ # Delete the specified agent version.
6189
+ # @param [String] name
6190
+ # Required. The name of the version to delete. Supported formats: - `projects//
6191
+ # agent/versions/` - `projects//locations//agent/versions/`
6192
+ # @param [String] fields
6193
+ # Selector specifying which fields to include in a partial response.
6194
+ # @param [String] quota_user
6195
+ # Available to use for quota purposes for server-side applications. Can be any
6196
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6197
+ # @param [Google::Apis::RequestOptions] options
6198
+ # Request-specific options
6199
+ #
6200
+ # @yield [result, err] Result & error if block supplied
6201
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleProtobufEmpty] parsed result object
6202
+ # @yieldparam err [StandardError] error object if request failed
6203
+ #
6204
+ # @return [Google::Apis::DialogflowV2::GoogleProtobufEmpty]
6205
+ #
6206
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6207
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6208
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6209
+ def delete_project_location_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
6210
+ command = make_simple_command(:delete, 'v2/{+name}', options)
6211
+ command.response_representation = Google::Apis::DialogflowV2::GoogleProtobufEmpty::Representation
6212
+ command.response_class = Google::Apis::DialogflowV2::GoogleProtobufEmpty
6213
+ command.params['name'] = name unless name.nil?
6214
+ command.query['fields'] = fields unless fields.nil?
6215
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6216
+ execute_or_queue_command(command, &block)
6217
+ end
6218
+
6219
+ # Retrieves the specified agent version.
6220
+ # @param [String] name
6221
+ # Required. The name of the version. Supported formats: - `projects//agent/
6222
+ # versions/` - `projects//locations//agent/versions/`
6223
+ # @param [String] fields
6224
+ # Selector specifying which fields to include in a partial response.
6225
+ # @param [String] quota_user
6226
+ # Available to use for quota purposes for server-side applications. Can be any
6227
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6228
+ # @param [Google::Apis::RequestOptions] options
6229
+ # Request-specific options
6230
+ #
6231
+ # @yield [result, err] Result & error if block supplied
6232
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] parsed result object
6233
+ # @yieldparam err [StandardError] error object if request failed
6234
+ #
6235
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version]
6236
+ #
6237
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6238
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6239
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6240
+ def get_project_location_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
6241
+ command = make_simple_command(:get, 'v2/{+name}', options)
6242
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
6243
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version
6244
+ command.params['name'] = name unless name.nil?
6245
+ command.query['fields'] = fields unless fields.nil?
6246
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6247
+ execute_or_queue_command(command, &block)
6248
+ end
6249
+
6250
+ # Returns the list of all versions of the specified agent.
6251
+ # @param [String] parent
6252
+ # Required. The agent to list all versions from. Supported formats: - `projects//
6253
+ # agent` - `projects//locations//agent`
6254
+ # @param [Fixnum] page_size
6255
+ # Optional. The maximum number of items to return in a single page. By default
6256
+ # 100 and at most 1000.
6257
+ # @param [String] page_token
6258
+ # Optional. The next_page_token value returned from a previous list request.
6259
+ # @param [String] fields
6260
+ # Selector specifying which fields to include in a partial response.
6261
+ # @param [String] quota_user
6262
+ # Available to use for quota purposes for server-side applications. Can be any
6263
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6264
+ # @param [Google::Apis::RequestOptions] options
6265
+ # Request-specific options
6266
+ #
6267
+ # @yield [result, err] Result & error if block supplied
6268
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse] parsed result object
6269
+ # @yieldparam err [StandardError] error object if request failed
6270
+ #
6271
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse]
6272
+ #
6273
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6274
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6275
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6276
+ def list_project_location_agent_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6277
+ command = make_simple_command(:get, 'v2/{+parent}/versions', options)
6278
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse::Representation
6279
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ListVersionsResponse
6280
+ command.params['parent'] = parent unless parent.nil?
6281
+ command.query['pageSize'] = page_size unless page_size.nil?
6282
+ command.query['pageToken'] = page_token unless page_token.nil?
6283
+ command.query['fields'] = fields unless fields.nil?
6284
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6285
+ execute_or_queue_command(command, &block)
6286
+ end
6287
+
6288
+ # Updates the specified agent version. Note that this method does not allow you
6289
+ # to update the state of the agent the given version points to. It allows you to
6290
+ # update only mutable properties of the version resource.
6291
+ # @param [String] name
6292
+ # Output only. The unique identifier of this agent version. Supported formats: -
6293
+ # `projects//agent/versions/` - `projects//locations//agent/versions/`
6294
+ # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] google_cloud_dialogflow_v2_version_object
6295
+ # @param [String] update_mask
6296
+ # Required. The mask to control which fields get updated.
6297
+ # @param [String] fields
6298
+ # Selector specifying which fields to include in a partial response.
6299
+ # @param [String] quota_user
6300
+ # Available to use for quota purposes for server-side applications. Can be any
6301
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6302
+ # @param [Google::Apis::RequestOptions] options
6303
+ # Request-specific options
6304
+ #
6305
+ # @yield [result, err] Result & error if block supplied
6306
+ # @yieldparam result [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version] parsed result object
6307
+ # @yieldparam err [StandardError] error object if request failed
6308
+ #
6309
+ # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version]
6310
+ #
6311
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6312
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6313
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6314
+ def patch_project_location_agent_version(name, google_cloud_dialogflow_v2_version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
6315
+ command = make_simple_command(:patch, 'v2/{+name}', options)
6316
+ command.request_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
6317
+ command.request_object = google_cloud_dialogflow_v2_version_object
6318
+ command.response_representation = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version::Representation
6319
+ command.response_class = Google::Apis::DialogflowV2::GoogleCloudDialogflowV2Version
6320
+ command.params['name'] = name unless name.nil?
6321
+ command.query['updateMask'] = update_mask unless update_mask.nil?
6322
+ command.query['fields'] = fields unless fields.nil?
6323
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6324
+ execute_or_queue_command(command, &block)
6325
+ end
6326
+
5593
6327
  # Returns the list of all answer records in the specified project in reverse
5594
6328
  # chronological order.
5595
6329
  # @param [String] parent