google-apis-dialogflow_v2beta1 0.7.0 → 0.12.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -414,7 +414,8 @@ module Google
414
414
  # Updates the fulfillment.
415
415
  # @param [String] name
416
416
  # Required. The unique identifier of the fulfillment. Supported formats: - `
417
- # projects//agent/fulfillment` - `projects//locations//agent/fulfillment`
417
+ # projects//agent/fulfillment` - `projects//locations//agent/fulfillment` This
418
+ # field is not used for Fulfillment in an Environment.
418
419
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Fulfillment] google_cloud_dialogflow_v2beta1_fulfillment_object
419
420
  # @param [String] update_mask
420
421
  # Required. The mask to control which fields get updated. If the mask is not
@@ -819,6 +820,144 @@ module Google
819
820
  execute_or_queue_command(command, &block)
820
821
  end
821
822
 
823
+ # Creates an agent environment.
824
+ # @param [String] parent
825
+ # Required. The agent to create an environment for. Supported formats: - `
826
+ # projects//agent` - `projects//locations//agent`
827
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
828
+ # @param [String] environment_id
829
+ # Required. The unique id of the new environment.
830
+ # @param [String] fields
831
+ # Selector specifying which fields to include in a partial response.
832
+ # @param [String] quota_user
833
+ # Available to use for quota purposes for server-side applications. Can be any
834
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
835
+ # @param [Google::Apis::RequestOptions] options
836
+ # Request-specific options
837
+ #
838
+ # @yield [result, err] Result & error if block supplied
839
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] parsed result object
840
+ # @yieldparam err [StandardError] error object if request failed
841
+ #
842
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment]
843
+ #
844
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
845
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
846
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
847
+ def create_project_agent_environment(parent, google_cloud_dialogflow_v2beta1_environment_object = nil, environment_id: nil, fields: nil, quota_user: nil, options: nil, &block)
848
+ command = make_simple_command(:post, 'v2beta1/{+parent}/environments', options)
849
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
850
+ command.request_object = google_cloud_dialogflow_v2beta1_environment_object
851
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
852
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment
853
+ command.params['parent'] = parent unless parent.nil?
854
+ command.query['environmentId'] = environment_id unless environment_id.nil?
855
+ command.query['fields'] = fields unless fields.nil?
856
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
857
+ execute_or_queue_command(command, &block)
858
+ end
859
+
860
+ # Deletes the specified agent environment.
861
+ # @param [String] name
862
+ # Required. The name of the environment to delete. / Format: - `projects//agent/
863
+ # environments/` - `projects//locations//agent/environments/`
864
+ # @param [String] fields
865
+ # Selector specifying which fields to include in a partial response.
866
+ # @param [String] quota_user
867
+ # Available to use for quota purposes for server-side applications. Can be any
868
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
869
+ # @param [Google::Apis::RequestOptions] options
870
+ # Request-specific options
871
+ #
872
+ # @yield [result, err] Result & error if block supplied
873
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
874
+ # @yieldparam err [StandardError] error object if request failed
875
+ #
876
+ # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
877
+ #
878
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
879
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
880
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
881
+ def delete_project_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
882
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
883
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
884
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
885
+ command.params['name'] = name unless name.nil?
886
+ command.query['fields'] = fields unless fields.nil?
887
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
888
+ execute_or_queue_command(command, &block)
889
+ end
890
+
891
+ # Retrieves the specified agent environment.
892
+ # @param [String] name
893
+ # Required. The name of the environment. Supported formats: - `projects//agent/
894
+ # environments/` - `projects//locations//agent/environments/`
895
+ # @param [String] fields
896
+ # Selector specifying which fields to include in a partial response.
897
+ # @param [String] quota_user
898
+ # Available to use for quota purposes for server-side applications. Can be any
899
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
900
+ # @param [Google::Apis::RequestOptions] options
901
+ # Request-specific options
902
+ #
903
+ # @yield [result, err] Result & error if block supplied
904
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] parsed result object
905
+ # @yieldparam err [StandardError] error object if request failed
906
+ #
907
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment]
908
+ #
909
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
910
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
911
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
912
+ def get_project_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
913
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
914
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
915
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment
916
+ command.params['name'] = name unless name.nil?
917
+ command.query['fields'] = fields unless fields.nil?
918
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
919
+ execute_or_queue_command(command, &block)
920
+ end
921
+
922
+ # Gets the history of the specified environment.
923
+ # @param [String] parent
924
+ # Required. The name of the environment to retrieve history for. Supported
925
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
926
+ # environments/`
927
+ # @param [Fixnum] page_size
928
+ # Optional. The maximum number of items to return in a single page. By default
929
+ # 100 and at most 1000.
930
+ # @param [String] page_token
931
+ # Optional. The next_page_token value returned from a previous list request.
932
+ # @param [String] fields
933
+ # Selector specifying which fields to include in a partial response.
934
+ # @param [String] quota_user
935
+ # Available to use for quota purposes for server-side applications. Can be any
936
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
937
+ # @param [Google::Apis::RequestOptions] options
938
+ # Request-specific options
939
+ #
940
+ # @yield [result, err] Result & error if block supplied
941
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory] parsed result object
942
+ # @yieldparam err [StandardError] error object if request failed
943
+ #
944
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory]
945
+ #
946
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
947
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
948
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
949
+ def get_project_agent_environment_history(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
950
+ command = make_simple_command(:get, 'v2beta1/{+parent}/history', options)
951
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory::Representation
952
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory
953
+ command.params['parent'] = parent unless parent.nil?
954
+ command.query['pageSize'] = page_size unless page_size.nil?
955
+ command.query['pageToken'] = page_token unless page_token.nil?
956
+ command.query['fields'] = fields unless fields.nil?
957
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
958
+ execute_or_queue_command(command, &block)
959
+ end
960
+
822
961
  # Returns the list of all non-draft environments of the specified agent.
823
962
  # @param [String] parent
824
963
  # Required. The agent to list all environments from. Format: - `projects//agent`
@@ -857,9 +996,66 @@ module Google
857
996
  execute_or_queue_command(command, &block)
858
997
  end
859
998
 
999
+ # Updates the specified agent environment. This method allows you to deploy new
1000
+ # agent versions into the environment. When an environment is pointed to a new
1001
+ # agent version by setting `environment.agent_version`, the environment is
1002
+ # temporarily set to the `LOADING` state. During that time, the environment
1003
+ # keeps on serving the previous version of the agent. After the new agent
1004
+ # version is done loading, the environment is set back to the `RUNNING` state.
1005
+ # You can use "-" as Environment ID in environment name to update version in "
1006
+ # draft" environment. WARNING: this will negate all recent changes to draft and
1007
+ # can't be undone. You may want to save the draft to a version before calling
1008
+ # this function.
1009
+ # @param [String] name
1010
+ # Output only. The unique identifier of this agent environment. Supported
1011
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
1012
+ # environments/`
1013
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
1014
+ # @param [Boolean] allow_load_to_draft_and_discard_changes
1015
+ # Optional. This field is used to prevent accidental overwrite of the draft
1016
+ # environment, which is an operation that cannot be undone. To confirm that the
1017
+ # caller desires this overwrite, this field must be explicitly set to true when
1018
+ # updating the draft environment (environment ID = `-`).
1019
+ # @param [String] update_mask
1020
+ # Required. The mask to control which fields get updated.
1021
+ # @param [String] fields
1022
+ # Selector specifying which fields to include in a partial response.
1023
+ # @param [String] quota_user
1024
+ # Available to use for quota purposes for server-side applications. Can be any
1025
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1026
+ # @param [Google::Apis::RequestOptions] options
1027
+ # Request-specific options
1028
+ #
1029
+ # @yield [result, err] Result & error if block supplied
1030
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] parsed result object
1031
+ # @yieldparam err [StandardError] error object if request failed
1032
+ #
1033
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment]
1034
+ #
1035
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1036
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1037
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1038
+ def patch_project_agent_environment(name, google_cloud_dialogflow_v2beta1_environment_object = nil, allow_load_to_draft_and_discard_changes: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1039
+ command = make_simple_command(:patch, 'v2beta1/{+name}', options)
1040
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
1041
+ command.request_object = google_cloud_dialogflow_v2beta1_environment_object
1042
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
1043
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment
1044
+ command.params['name'] = name unless name.nil?
1045
+ command.query['allowLoadToDraftAndDiscardChanges'] = allow_load_to_draft_and_discard_changes unless allow_load_to_draft_and_discard_changes.nil?
1046
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1047
+ command.query['fields'] = fields unless fields.nil?
1048
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1049
+ execute_or_queue_command(command, &block)
1050
+ end
1051
+
860
1052
  # Returns the list of all intents in the specified agent.
861
1053
  # @param [String] parent
862
- # Required. The agent to list all intents from. Format: `projects//agent`.
1054
+ # Required. The agent to list all intents from. Format: `projects//agent` or `
1055
+ # projects//locations//agent`. Alternatively, you can specify the environment to
1056
+ # list intents for. Format: `projects//agent/environments/` or `projects//
1057
+ # locations//agent/environments/`. Note: training phrases of the intents will
1058
+ # not be returned for non-draft environment.
863
1059
  # @param [String] intent_view
864
1060
  # Optional. The resource view to apply to the returned intent.
865
1061
  # @param [String] language_code
@@ -1580,7 +1776,11 @@ module Google
1580
1776
 
1581
1777
  # Returns the list of all intents in the specified agent.
1582
1778
  # @param [String] parent
1583
- # Required. The agent to list all intents from. Format: `projects//agent`.
1779
+ # Required. The agent to list all intents from. Format: `projects//agent` or `
1780
+ # projects//locations//agent`. Alternatively, you can specify the environment to
1781
+ # list intents for. Format: `projects//agent/environments/` or `projects//
1782
+ # locations//agent/environments/`. Note: training phrases of the intents will
1783
+ # not be returned for non-draft environment.
1584
1784
  # @param [String] intent_view
1585
1785
  # Optional. The resource view to apply to the returned intent.
1586
1786
  # @param [String] language_code
@@ -2599,10 +2799,12 @@ module Google
2599
2799
  execute_or_queue_command(command, &block)
2600
2800
  end
2601
2801
 
2602
- # Deprecated. Retrieves a specific answer record.
2603
- # @param [String] name
2604
- # Required. The name of the answer record to retrieve. Format: `projects//
2605
- # locations//answerRecords/`.
2802
+ # Creates an agent version. The new version points to the agent instance in the "
2803
+ # default" environment.
2804
+ # @param [String] parent
2805
+ # Required. The agent to create a version for. Supported formats: - `projects//
2806
+ # agent` - `projects//locations//agent`
2807
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
2606
2808
  # @param [String] fields
2607
2809
  # Selector specifying which fields to include in a partial response.
2608
2810
  # @param [String] quota_user
@@ -2612,36 +2814,30 @@ module Google
2612
2814
  # Request-specific options
2613
2815
  #
2614
2816
  # @yield [result, err] Result & error if block supplied
2615
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] parsed result object
2817
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] parsed result object
2616
2818
  # @yieldparam err [StandardError] error object if request failed
2617
2819
  #
2618
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord]
2820
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version]
2619
2821
  #
2620
2822
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2621
2823
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2622
2824
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2623
- def get_project_answer_record(name, fields: nil, quota_user: nil, options: nil, &block)
2624
- command = make_simple_command(:get, 'v2beta1/{+name}', options)
2625
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord::Representation
2626
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord
2627
- command.params['name'] = name unless name.nil?
2825
+ def create_project_agent_version(parent, google_cloud_dialogflow_v2beta1_version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2826
+ command = make_simple_command(:post, 'v2beta1/{+parent}/versions', options)
2827
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
2828
+ command.request_object = google_cloud_dialogflow_v2beta1_version_object
2829
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
2830
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version
2831
+ command.params['parent'] = parent unless parent.nil?
2628
2832
  command.query['fields'] = fields unless fields.nil?
2629
2833
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2630
2834
  execute_or_queue_command(command, &block)
2631
2835
  end
2632
2836
 
2633
- # Returns the list of all answer records in the specified project in reverse
2634
- # chronological order.
2635
- # @param [String] parent
2636
- # Required. The project to list all answer records for in reverse chronological
2637
- # order. Format: `projects//locations/`.
2638
- # @param [Fixnum] page_size
2639
- # Optional. The maximum number of records to return in a single page. The server
2640
- # may return fewer records than this. If unspecified, we use 10. The maximum is
2641
- # 100.
2642
- # @param [String] page_token
2643
- # Optional. The ListAnswerRecordsResponse.next_page_token value returned from a
2644
- # previous list request used to continue listing on the next page.
2837
+ # Delete the specified agent version.
2838
+ # @param [String] name
2839
+ # Required. The name of the version to delete. Supported formats: - `projects//
2840
+ # agent/versions/` - `projects//locations//agent/versions/`
2645
2841
  # @param [String] fields
2646
2842
  # Selector specifying which fields to include in a partial response.
2647
2843
  # @param [String] quota_user
@@ -2651,33 +2847,28 @@ module Google
2651
2847
  # Request-specific options
2652
2848
  #
2653
2849
  # @yield [result, err] Result & error if block supplied
2654
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse] parsed result object
2850
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
2655
2851
  # @yieldparam err [StandardError] error object if request failed
2656
2852
  #
2657
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse]
2853
+ # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
2658
2854
  #
2659
2855
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2660
2856
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2661
2857
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2662
- def list_project_answer_records(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2663
- command = make_simple_command(:get, 'v2beta1/{+parent}/answerRecords', options)
2664
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse::Representation
2665
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse
2666
- command.params['parent'] = parent unless parent.nil?
2667
- command.query['pageSize'] = page_size unless page_size.nil?
2668
- command.query['pageToken'] = page_token unless page_token.nil?
2858
+ def delete_project_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
2859
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
2860
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
2861
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
2862
+ command.params['name'] = name unless name.nil?
2669
2863
  command.query['fields'] = fields unless fields.nil?
2670
2864
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2671
2865
  execute_or_queue_command(command, &block)
2672
2866
  end
2673
2867
 
2674
- # Updates the specified answer record.
2868
+ # Retrieves the specified agent version.
2675
2869
  # @param [String] name
2676
- # The unique identifier of this answer record. Required for AnswerRecords.
2677
- # UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`.
2678
- # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] google_cloud_dialogflow_v2beta1_answer_record_object
2679
- # @param [String] update_mask
2680
- # Required. The mask to control which fields get updated.
2870
+ # Required. The name of the version. Supported formats: - `projects//agent/
2871
+ # versions/` - `projects//locations//agent/versions/`
2681
2872
  # @param [String] fields
2682
2873
  # Selector specifying which fields to include in a partial response.
2683
2874
  # @param [String] quota_user
@@ -2687,34 +2878,33 @@ module Google
2687
2878
  # Request-specific options
2688
2879
  #
2689
2880
  # @yield [result, err] Result & error if block supplied
2690
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] parsed result object
2881
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] parsed result object
2691
2882
  # @yieldparam err [StandardError] error object if request failed
2692
2883
  #
2693
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord]
2884
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version]
2694
2885
  #
2695
2886
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2696
2887
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2697
2888
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2698
- def patch_project_answer_record(name, google_cloud_dialogflow_v2beta1_answer_record_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2699
- command = make_simple_command(:patch, 'v2beta1/{+name}', options)
2700
- command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord::Representation
2701
- command.request_object = google_cloud_dialogflow_v2beta1_answer_record_object
2702
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord::Representation
2703
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord
2889
+ def get_project_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
2890
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
2891
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
2892
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version
2704
2893
  command.params['name'] = name unless name.nil?
2705
- command.query['updateMask'] = update_mask unless update_mask.nil?
2706
2894
  command.query['fields'] = fields unless fields.nil?
2707
2895
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2708
2896
  execute_or_queue_command(command, &block)
2709
2897
  end
2710
2898
 
2711
- # Creates a conversation profile in the specified project. ConversationProfile.
2712
- # CreateTime and ConversationProfile.UpdateTime aren't populated in the response.
2713
- # You can retrieve them via GetConversationProfile API.
2899
+ # Returns the list of all versions of the specified agent.
2714
2900
  # @param [String] parent
2715
- # Required. The project to create a conversation profile for. Format: `projects//
2716
- # locations/`.
2717
- # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] google_cloud_dialogflow_v2beta1_conversation_profile_object
2901
+ # Required. The agent to list all versions from. Supported formats: - `projects//
2902
+ # agent` - `projects//locations//agent`
2903
+ # @param [Fixnum] page_size
2904
+ # Optional. The maximum number of items to return in a single page. By default
2905
+ # 100 and at most 1000.
2906
+ # @param [String] page_token
2907
+ # Optional. The next_page_token value returned from a previous list request.
2718
2908
  # @param [String] fields
2719
2909
  # Selector specifying which fields to include in a partial response.
2720
2910
  # @param [String] quota_user
@@ -2724,30 +2914,35 @@ module Google
2724
2914
  # Request-specific options
2725
2915
  #
2726
2916
  # @yield [result, err] Result & error if block supplied
2727
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] parsed result object
2917
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse] parsed result object
2728
2918
  # @yieldparam err [StandardError] error object if request failed
2729
2919
  #
2730
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile]
2920
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse]
2731
2921
  #
2732
2922
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2733
2923
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2734
2924
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2735
- def create_project_conversation_profile(parent, google_cloud_dialogflow_v2beta1_conversation_profile_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2736
- command = make_simple_command(:post, 'v2beta1/{+parent}/conversationProfiles', options)
2737
- command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile::Representation
2738
- command.request_object = google_cloud_dialogflow_v2beta1_conversation_profile_object
2739
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile::Representation
2740
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile
2925
+ def list_project_agent_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2926
+ command = make_simple_command(:get, 'v2beta1/{+parent}/versions', options)
2927
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse::Representation
2928
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse
2741
2929
  command.params['parent'] = parent unless parent.nil?
2930
+ command.query['pageSize'] = page_size unless page_size.nil?
2931
+ command.query['pageToken'] = page_token unless page_token.nil?
2742
2932
  command.query['fields'] = fields unless fields.nil?
2743
2933
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2744
2934
  execute_or_queue_command(command, &block)
2745
2935
  end
2746
2936
 
2747
- # Deletes the specified conversation profile.
2937
+ # Updates the specified agent version. Note that this method does not allow you
2938
+ # to update the state of the agent the given version points to. It allows you to
2939
+ # update only mutable properties of the version resource.
2748
2940
  # @param [String] name
2749
- # Required. The name of the conversation profile to delete. Format: `projects//
2750
- # locations//conversationProfiles/`.
2941
+ # Output only. The unique identifier of this agent version. Supported formats: -
2942
+ # `projects//agent/versions/` - `projects//locations//agent/versions/`
2943
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
2944
+ # @param [String] update_mask
2945
+ # Required. The mask to control which fields get updated.
2751
2946
  # @param [String] fields
2752
2947
  # Selector specifying which fields to include in a partial response.
2753
2948
  # @param [String] quota_user
@@ -2757,28 +2952,31 @@ module Google
2757
2952
  # Request-specific options
2758
2953
  #
2759
2954
  # @yield [result, err] Result & error if block supplied
2760
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
2955
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] parsed result object
2761
2956
  # @yieldparam err [StandardError] error object if request failed
2762
2957
  #
2763
- # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
2958
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version]
2764
2959
  #
2765
2960
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2766
2961
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2767
2962
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2768
- def delete_project_conversation_profile(name, fields: nil, quota_user: nil, options: nil, &block)
2769
- command = make_simple_command(:delete, 'v2beta1/{+name}', options)
2770
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
2771
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
2963
+ def patch_project_agent_version(name, google_cloud_dialogflow_v2beta1_version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
2964
+ command = make_simple_command(:patch, 'v2beta1/{+name}', options)
2965
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
2966
+ command.request_object = google_cloud_dialogflow_v2beta1_version_object
2967
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
2968
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version
2772
2969
  command.params['name'] = name unless name.nil?
2970
+ command.query['updateMask'] = update_mask unless update_mask.nil?
2773
2971
  command.query['fields'] = fields unless fields.nil?
2774
2972
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2775
2973
  execute_or_queue_command(command, &block)
2776
2974
  end
2777
2975
 
2778
- # Retrieves the specified conversation profile.
2976
+ # Deprecated. Retrieves a specific answer record.
2779
2977
  # @param [String] name
2780
- # Required. The resource name of the conversation profile. Format: `projects//
2781
- # locations//conversationProfiles/`.
2978
+ # Required. The name of the answer record to retrieve. Format: `projects//
2979
+ # locations//answerRecords/`.
2782
2980
  # @param [String] fields
2783
2981
  # Selector specifying which fields to include in a partial response.
2784
2982
  # @param [String] quota_user
@@ -2788,33 +2986,36 @@ module Google
2788
2986
  # Request-specific options
2789
2987
  #
2790
2988
  # @yield [result, err] Result & error if block supplied
2791
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] parsed result object
2989
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] parsed result object
2792
2990
  # @yieldparam err [StandardError] error object if request failed
2793
2991
  #
2794
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile]
2992
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord]
2795
2993
  #
2796
2994
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2797
2995
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2798
2996
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2799
- def get_project_conversation_profile(name, fields: nil, quota_user: nil, options: nil, &block)
2997
+ def get_project_answer_record(name, fields: nil, quota_user: nil, options: nil, &block)
2800
2998
  command = make_simple_command(:get, 'v2beta1/{+name}', options)
2801
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile::Representation
2802
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile
2999
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord::Representation
3000
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord
2803
3001
  command.params['name'] = name unless name.nil?
2804
3002
  command.query['fields'] = fields unless fields.nil?
2805
3003
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2806
3004
  execute_or_queue_command(command, &block)
2807
3005
  end
2808
3006
 
2809
- # Returns the list of all conversation profiles in the specified project.
3007
+ # Returns the list of all answer records in the specified project in reverse
3008
+ # chronological order.
2810
3009
  # @param [String] parent
2811
- # Required. The project to list all conversation profiles from. Format: `
2812
- # projects//locations/`.
3010
+ # Required. The project to list all answer records for in reverse chronological
3011
+ # order. Format: `projects//locations/`.
2813
3012
  # @param [Fixnum] page_size
2814
- # The maximum number of items to return in a single page. By default 100 and at
2815
- # most 1000.
3013
+ # Optional. The maximum number of records to return in a single page. The server
3014
+ # may return fewer records than this. If unspecified, we use 10. The maximum is
3015
+ # 100.
2816
3016
  # @param [String] page_token
2817
- # The next_page_token value returned from a previous list request.
3017
+ # Optional. The ListAnswerRecordsResponse.next_page_token value returned from a
3018
+ # previous list request used to continue listing on the next page.
2818
3019
  # @param [String] fields
2819
3020
  # Selector specifying which fields to include in a partial response.
2820
3021
  # @param [String] quota_user
@@ -2824,10 +3025,183 @@ module Google
2824
3025
  # Request-specific options
2825
3026
  #
2826
3027
  # @yield [result, err] Result & error if block supplied
2827
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListConversationProfilesResponse] parsed result object
3028
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse] parsed result object
2828
3029
  # @yieldparam err [StandardError] error object if request failed
2829
3030
  #
2830
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListConversationProfilesResponse]
3031
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse]
3032
+ #
3033
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3034
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3035
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3036
+ def list_project_answer_records(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3037
+ command = make_simple_command(:get, 'v2beta1/{+parent}/answerRecords', options)
3038
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse::Representation
3039
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListAnswerRecordsResponse
3040
+ command.params['parent'] = parent unless parent.nil?
3041
+ command.query['pageSize'] = page_size unless page_size.nil?
3042
+ command.query['pageToken'] = page_token unless page_token.nil?
3043
+ command.query['fields'] = fields unless fields.nil?
3044
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3045
+ execute_or_queue_command(command, &block)
3046
+ end
3047
+
3048
+ # Updates the specified answer record.
3049
+ # @param [String] name
3050
+ # The unique identifier of this answer record. Required for AnswerRecords.
3051
+ # UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`.
3052
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] google_cloud_dialogflow_v2beta1_answer_record_object
3053
+ # @param [String] update_mask
3054
+ # Required. The mask to control which fields get updated.
3055
+ # @param [String] fields
3056
+ # Selector specifying which fields to include in a partial response.
3057
+ # @param [String] quota_user
3058
+ # Available to use for quota purposes for server-side applications. Can be any
3059
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3060
+ # @param [Google::Apis::RequestOptions] options
3061
+ # Request-specific options
3062
+ #
3063
+ # @yield [result, err] Result & error if block supplied
3064
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord] parsed result object
3065
+ # @yieldparam err [StandardError] error object if request failed
3066
+ #
3067
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord]
3068
+ #
3069
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3070
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3071
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3072
+ def patch_project_answer_record(name, google_cloud_dialogflow_v2beta1_answer_record_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3073
+ command = make_simple_command(:patch, 'v2beta1/{+name}', options)
3074
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord::Representation
3075
+ command.request_object = google_cloud_dialogflow_v2beta1_answer_record_object
3076
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord::Representation
3077
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1AnswerRecord
3078
+ command.params['name'] = name unless name.nil?
3079
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3080
+ command.query['fields'] = fields unless fields.nil?
3081
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3082
+ execute_or_queue_command(command, &block)
3083
+ end
3084
+
3085
+ # Creates a conversation profile in the specified project. ConversationProfile.
3086
+ # CreateTime and ConversationProfile.UpdateTime aren't populated in the response.
3087
+ # You can retrieve them via GetConversationProfile API.
3088
+ # @param [String] parent
3089
+ # Required. The project to create a conversation profile for. Format: `projects//
3090
+ # locations/`.
3091
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] google_cloud_dialogflow_v2beta1_conversation_profile_object
3092
+ # @param [String] fields
3093
+ # Selector specifying which fields to include in a partial response.
3094
+ # @param [String] quota_user
3095
+ # Available to use for quota purposes for server-side applications. Can be any
3096
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3097
+ # @param [Google::Apis::RequestOptions] options
3098
+ # Request-specific options
3099
+ #
3100
+ # @yield [result, err] Result & error if block supplied
3101
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] parsed result object
3102
+ # @yieldparam err [StandardError] error object if request failed
3103
+ #
3104
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile]
3105
+ #
3106
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3107
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3108
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3109
+ def create_project_conversation_profile(parent, google_cloud_dialogflow_v2beta1_conversation_profile_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3110
+ command = make_simple_command(:post, 'v2beta1/{+parent}/conversationProfiles', options)
3111
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile::Representation
3112
+ command.request_object = google_cloud_dialogflow_v2beta1_conversation_profile_object
3113
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile::Representation
3114
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile
3115
+ command.params['parent'] = parent unless parent.nil?
3116
+ command.query['fields'] = fields unless fields.nil?
3117
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3118
+ execute_or_queue_command(command, &block)
3119
+ end
3120
+
3121
+ # Deletes the specified conversation profile.
3122
+ # @param [String] name
3123
+ # Required. The name of the conversation profile to delete. Format: `projects//
3124
+ # locations//conversationProfiles/`.
3125
+ # @param [String] fields
3126
+ # Selector specifying which fields to include in a partial response.
3127
+ # @param [String] quota_user
3128
+ # Available to use for quota purposes for server-side applications. Can be any
3129
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3130
+ # @param [Google::Apis::RequestOptions] options
3131
+ # Request-specific options
3132
+ #
3133
+ # @yield [result, err] Result & error if block supplied
3134
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
3135
+ # @yieldparam err [StandardError] error object if request failed
3136
+ #
3137
+ # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
3138
+ #
3139
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3140
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3141
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3142
+ def delete_project_conversation_profile(name, fields: nil, quota_user: nil, options: nil, &block)
3143
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
3144
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
3145
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
3146
+ command.params['name'] = name unless name.nil?
3147
+ command.query['fields'] = fields unless fields.nil?
3148
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3149
+ execute_or_queue_command(command, &block)
3150
+ end
3151
+
3152
+ # Retrieves the specified conversation profile.
3153
+ # @param [String] name
3154
+ # Required. The resource name of the conversation profile. Format: `projects//
3155
+ # locations//conversationProfiles/`.
3156
+ # @param [String] fields
3157
+ # Selector specifying which fields to include in a partial response.
3158
+ # @param [String] quota_user
3159
+ # Available to use for quota purposes for server-side applications. Can be any
3160
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3161
+ # @param [Google::Apis::RequestOptions] options
3162
+ # Request-specific options
3163
+ #
3164
+ # @yield [result, err] Result & error if block supplied
3165
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile] parsed result object
3166
+ # @yieldparam err [StandardError] error object if request failed
3167
+ #
3168
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile]
3169
+ #
3170
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3171
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3172
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3173
+ def get_project_conversation_profile(name, fields: nil, quota_user: nil, options: nil, &block)
3174
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
3175
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile::Representation
3176
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ConversationProfile
3177
+ command.params['name'] = name unless name.nil?
3178
+ command.query['fields'] = fields unless fields.nil?
3179
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3180
+ execute_or_queue_command(command, &block)
3181
+ end
3182
+
3183
+ # Returns the list of all conversation profiles in the specified project.
3184
+ # @param [String] parent
3185
+ # Required. The project to list all conversation profiles from. Format: `
3186
+ # projects//locations/`.
3187
+ # @param [Fixnum] page_size
3188
+ # The maximum number of items to return in a single page. By default 100 and at
3189
+ # most 1000.
3190
+ # @param [String] page_token
3191
+ # The next_page_token value returned from a previous list request.
3192
+ # @param [String] fields
3193
+ # Selector specifying which fields to include in a partial response.
3194
+ # @param [String] quota_user
3195
+ # Available to use for quota purposes for server-side applications. Can be any
3196
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3197
+ # @param [Google::Apis::RequestOptions] options
3198
+ # Request-specific options
3199
+ #
3200
+ # @yield [result, err] Result & error if block supplied
3201
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListConversationProfilesResponse] parsed result object
3202
+ # @yieldparam err [StandardError] error object if request failed
3203
+ #
3204
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListConversationProfilesResponse]
2831
3205
  #
2832
3206
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2833
3207
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
@@ -3051,110 +3425,6 @@ module Google
3051
3425
  execute_or_queue_command(command, &block)
3052
3426
  end
3053
3427
 
3054
- # Creates a call matcher that links incoming SIP calls to the specified
3055
- # conversation if they fulfill specified criteria.
3056
- # @param [String] parent
3057
- # Required. Resource identifier of the conversation adding the call matcher.
3058
- # Format: `projects//locations//conversations/`.
3059
- # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher] google_cloud_dialogflow_v2beta1_call_matcher_object
3060
- # @param [String] fields
3061
- # Selector specifying which fields to include in a partial response.
3062
- # @param [String] quota_user
3063
- # Available to use for quota purposes for server-side applications. Can be any
3064
- # arbitrary string assigned to a user, but should not exceed 40 characters.
3065
- # @param [Google::Apis::RequestOptions] options
3066
- # Request-specific options
3067
- #
3068
- # @yield [result, err] Result & error if block supplied
3069
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher] parsed result object
3070
- # @yieldparam err [StandardError] error object if request failed
3071
- #
3072
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher]
3073
- #
3074
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3075
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3076
- # @raise [Google::Apis::AuthorizationError] Authorization is required
3077
- def create_project_conversation_call_matcher(parent, google_cloud_dialogflow_v2beta1_call_matcher_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3078
- command = make_simple_command(:post, 'v2beta1/{+parent}/callMatchers', options)
3079
- command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher::Representation
3080
- command.request_object = google_cloud_dialogflow_v2beta1_call_matcher_object
3081
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher::Representation
3082
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher
3083
- command.params['parent'] = parent unless parent.nil?
3084
- command.query['fields'] = fields unless fields.nil?
3085
- command.query['quotaUser'] = quota_user unless quota_user.nil?
3086
- execute_or_queue_command(command, &block)
3087
- end
3088
-
3089
- # Requests deletion of a call matcher.
3090
- # @param [String] name
3091
- # Required. The unique identifier of the CallMatcher to delete. Format: `
3092
- # projects//locations//conversations//callMatchers/`.
3093
- # @param [String] fields
3094
- # Selector specifying which fields to include in a partial response.
3095
- # @param [String] quota_user
3096
- # Available to use for quota purposes for server-side applications. Can be any
3097
- # arbitrary string assigned to a user, but should not exceed 40 characters.
3098
- # @param [Google::Apis::RequestOptions] options
3099
- # Request-specific options
3100
- #
3101
- # @yield [result, err] Result & error if block supplied
3102
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
3103
- # @yieldparam err [StandardError] error object if request failed
3104
- #
3105
- # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
3106
- #
3107
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3108
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3109
- # @raise [Google::Apis::AuthorizationError] Authorization is required
3110
- def delete_project_conversation_call_matcher(name, fields: nil, quota_user: nil, options: nil, &block)
3111
- command = make_simple_command(:delete, 'v2beta1/{+name}', options)
3112
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
3113
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
3114
- command.params['name'] = name unless name.nil?
3115
- command.query['fields'] = fields unless fields.nil?
3116
- command.query['quotaUser'] = quota_user unless quota_user.nil?
3117
- execute_or_queue_command(command, &block)
3118
- end
3119
-
3120
- # Returns the list of all call matchers in the specified conversation.
3121
- # @param [String] parent
3122
- # Required. The conversation to list all call matchers from. Format: `projects//
3123
- # locations//conversations/`.
3124
- # @param [Fixnum] page_size
3125
- # Optional. The maximum number of items to return in a single page. By default
3126
- # 100 and at most 1000.
3127
- # @param [String] page_token
3128
- # Optional. The next_page_token value returned from a previous list request.
3129
- # @param [String] fields
3130
- # Selector specifying which fields to include in a partial response.
3131
- # @param [String] quota_user
3132
- # Available to use for quota purposes for server-side applications. Can be any
3133
- # arbitrary string assigned to a user, but should not exceed 40 characters.
3134
- # @param [Google::Apis::RequestOptions] options
3135
- # Request-specific options
3136
- #
3137
- # @yield [result, err] Result & error if block supplied
3138
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse] parsed result object
3139
- # @yieldparam err [StandardError] error object if request failed
3140
- #
3141
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse]
3142
- #
3143
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3144
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3145
- # @raise [Google::Apis::AuthorizationError] Authorization is required
3146
- def list_project_conversation_call_matchers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3147
- command = make_simple_command(:get, 'v2beta1/{+parent}/callMatchers', options)
3148
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse::Representation
3149
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse
3150
- command.params['parent'] = parent unless parent.nil?
3151
- command.query['pageSize'] = page_size unless page_size.nil?
3152
- command.query['pageToken'] = page_token unless page_token.nil?
3153
- command.query['fields'] = fields unless fields.nil?
3154
- command.query['quotaUser'] = quota_user unless quota_user.nil?
3155
- execute_or_queue_command(command, &block)
3156
- end
3157
-
3158
3428
  # Batch ingests messages to conversation. Customers can use this RPC to ingest
3159
3429
  # historical messages to conversation.
3160
3430
  # @param [String] parent
@@ -3201,7 +3471,7 @@ module Google
3201
3471
  # Optional. Filter on message fields. Currently predicates on `create_time` and `
3202
3472
  # create_time_epoch_microseconds` are supported. `create_time` only support
3203
3473
  # milliseconds accuracy. E.g., `create_time_epoch_microseconds >
3204
- # 1551790877964485` or `create_time > 2017-01-15T01:30:15.01Z`. For more
3474
+ # 1551790877964485` or `create_time > "2017-01-15T01:30:15.01Z"`. For more
3205
3475
  # information about filtering, see [API Filtering](https://aip.dev/160).
3206
3476
  # @param [Fixnum] page_size
3207
3477
  # Optional. The maximum number of items to return in a single page. By default
@@ -3241,7 +3511,7 @@ module Google
3241
3511
  # Adds a text (chat, for example), or audio (phone recording, for example)
3242
3512
  # message from a participant into the conversation. Note: Always use agent
3243
3513
  # versions for production traffic sent to virtual agents. See [Versions and
3244
- # environments(https://cloud.google.com/dialogflow/es/docs/agents-versions).
3514
+ # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
3245
3515
  # @param [String] participant
3246
3516
  # Required. The name of the participant this text comes from. Format: `projects//
3247
3517
  # locations//conversations//participants/`.
@@ -3472,7 +3742,7 @@ module Google
3472
3742
  # Optional. Filter on suggestions fields. Currently predicates on `create_time`
3473
3743
  # and `create_time_epoch_microseconds` are supported. `create_time` only support
3474
3744
  # milliseconds accuracy. E.g., `create_time_epoch_microseconds >
3475
- # 1551790877964485` or `create_time > 2017-01-15T01:30:15.01Z` For more
3745
+ # 1551790877964485` or `create_time > "2017-01-15T01:30:15.01Z"` For more
3476
3746
  # information about filtering, see [API Filtering](https://aip.dev/160).
3477
3747
  # @param [Fixnum] page_size
3478
3748
  # Optional. The maximum number of items to return in a single page. The default
@@ -3917,7 +4187,9 @@ module Google
3917
4187
  execute_or_queue_command(command, &block)
3918
4188
  end
3919
4189
 
3920
- # Create documents by importing data from external sources.
4190
+ # Create documents by importing data from external sources. Dialogflow supports
4191
+ # up to 350 documents in each request. If you try to import more, Dialogflow
4192
+ # will return an error.
3921
4193
  # @param [String] parent
3922
4194
  # Required. The knowledge base to import documents into. Format: `projects//
3923
4195
  # locations//knowledgeBases/`.
@@ -4449,7 +4721,8 @@ module Google
4449
4721
  # Updates the fulfillment.
4450
4722
  # @param [String] name
4451
4723
  # Required. The unique identifier of the fulfillment. Supported formats: - `
4452
- # projects//agent/fulfillment` - `projects//locations//agent/fulfillment`
4724
+ # projects//agent/fulfillment` - `projects//locations//agent/fulfillment` This
4725
+ # field is not used for Fulfillment in an Environment.
4453
4726
  # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Fulfillment] google_cloud_dialogflow_v2beta1_fulfillment_object
4454
4727
  # @param [String] update_mask
4455
4728
  # Required. The mask to control which fields get updated. If the mask is not
@@ -4854,10 +5127,148 @@ module Google
4854
5127
  execute_or_queue_command(command, &block)
4855
5128
  end
4856
5129
 
4857
- # Returns the list of all non-draft environments of the specified agent.
5130
+ # Creates an agent environment.
4858
5131
  # @param [String] parent
4859
- # Required. The agent to list all environments from. Format: - `projects//agent`
4860
- # - `projects//locations//agent`
5132
+ # Required. The agent to create an environment for. Supported formats: - `
5133
+ # projects//agent` - `projects//locations//agent`
5134
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
5135
+ # @param [String] environment_id
5136
+ # Required. The unique id of the new environment.
5137
+ # @param [String] fields
5138
+ # Selector specifying which fields to include in a partial response.
5139
+ # @param [String] quota_user
5140
+ # Available to use for quota purposes for server-side applications. Can be any
5141
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5142
+ # @param [Google::Apis::RequestOptions] options
5143
+ # Request-specific options
5144
+ #
5145
+ # @yield [result, err] Result & error if block supplied
5146
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] parsed result object
5147
+ # @yieldparam err [StandardError] error object if request failed
5148
+ #
5149
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment]
5150
+ #
5151
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5152
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5153
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5154
+ def create_project_location_agent_environment(parent, google_cloud_dialogflow_v2beta1_environment_object = nil, environment_id: nil, fields: nil, quota_user: nil, options: nil, &block)
5155
+ command = make_simple_command(:post, 'v2beta1/{+parent}/environments', options)
5156
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
5157
+ command.request_object = google_cloud_dialogflow_v2beta1_environment_object
5158
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
5159
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment
5160
+ command.params['parent'] = parent unless parent.nil?
5161
+ command.query['environmentId'] = environment_id unless environment_id.nil?
5162
+ command.query['fields'] = fields unless fields.nil?
5163
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5164
+ execute_or_queue_command(command, &block)
5165
+ end
5166
+
5167
+ # Deletes the specified agent environment.
5168
+ # @param [String] name
5169
+ # Required. The name of the environment to delete. / Format: - `projects//agent/
5170
+ # environments/` - `projects//locations//agent/environments/`
5171
+ # @param [String] fields
5172
+ # Selector specifying which fields to include in a partial response.
5173
+ # @param [String] quota_user
5174
+ # Available to use for quota purposes for server-side applications. Can be any
5175
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5176
+ # @param [Google::Apis::RequestOptions] options
5177
+ # Request-specific options
5178
+ #
5179
+ # @yield [result, err] Result & error if block supplied
5180
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
5181
+ # @yieldparam err [StandardError] error object if request failed
5182
+ #
5183
+ # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
5184
+ #
5185
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5186
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5187
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5188
+ def delete_project_location_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
5189
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
5190
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
5191
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
5192
+ command.params['name'] = name unless name.nil?
5193
+ command.query['fields'] = fields unless fields.nil?
5194
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5195
+ execute_or_queue_command(command, &block)
5196
+ end
5197
+
5198
+ # Retrieves the specified agent environment.
5199
+ # @param [String] name
5200
+ # Required. The name of the environment. Supported formats: - `projects//agent/
5201
+ # environments/` - `projects//locations//agent/environments/`
5202
+ # @param [String] fields
5203
+ # Selector specifying which fields to include in a partial response.
5204
+ # @param [String] quota_user
5205
+ # Available to use for quota purposes for server-side applications. Can be any
5206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5207
+ # @param [Google::Apis::RequestOptions] options
5208
+ # Request-specific options
5209
+ #
5210
+ # @yield [result, err] Result & error if block supplied
5211
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] parsed result object
5212
+ # @yieldparam err [StandardError] error object if request failed
5213
+ #
5214
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment]
5215
+ #
5216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5219
+ def get_project_location_agent_environment(name, fields: nil, quota_user: nil, options: nil, &block)
5220
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
5221
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
5222
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment
5223
+ command.params['name'] = name unless name.nil?
5224
+ command.query['fields'] = fields unless fields.nil?
5225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5226
+ execute_or_queue_command(command, &block)
5227
+ end
5228
+
5229
+ # Gets the history of the specified environment.
5230
+ # @param [String] parent
5231
+ # Required. The name of the environment to retrieve history for. Supported
5232
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
5233
+ # environments/`
5234
+ # @param [Fixnum] page_size
5235
+ # Optional. The maximum number of items to return in a single page. By default
5236
+ # 100 and at most 1000.
5237
+ # @param [String] page_token
5238
+ # Optional. The next_page_token value returned from a previous list request.
5239
+ # @param [String] fields
5240
+ # Selector specifying which fields to include in a partial response.
5241
+ # @param [String] quota_user
5242
+ # Available to use for quota purposes for server-side applications. Can be any
5243
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5244
+ # @param [Google::Apis::RequestOptions] options
5245
+ # Request-specific options
5246
+ #
5247
+ # @yield [result, err] Result & error if block supplied
5248
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory] parsed result object
5249
+ # @yieldparam err [StandardError] error object if request failed
5250
+ #
5251
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory]
5252
+ #
5253
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5254
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5255
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5256
+ def get_project_location_agent_environment_history(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5257
+ command = make_simple_command(:get, 'v2beta1/{+parent}/history', options)
5258
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory::Representation
5259
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistory
5260
+ command.params['parent'] = parent unless parent.nil?
5261
+ command.query['pageSize'] = page_size unless page_size.nil?
5262
+ command.query['pageToken'] = page_token unless page_token.nil?
5263
+ command.query['fields'] = fields unless fields.nil?
5264
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5265
+ execute_or_queue_command(command, &block)
5266
+ end
5267
+
5268
+ # Returns the list of all non-draft environments of the specified agent.
5269
+ # @param [String] parent
5270
+ # Required. The agent to list all environments from. Format: - `projects//agent`
5271
+ # - `projects//locations//agent`
4861
5272
  # @param [Fixnum] page_size
4862
5273
  # Optional. The maximum number of items to return in a single page. By default
4863
5274
  # 100 and at most 1000.
@@ -4892,6 +5303,109 @@ module Google
4892
5303
  execute_or_queue_command(command, &block)
4893
5304
  end
4894
5305
 
5306
+ # Updates the specified agent environment. This method allows you to deploy new
5307
+ # agent versions into the environment. When an environment is pointed to a new
5308
+ # agent version by setting `environment.agent_version`, the environment is
5309
+ # temporarily set to the `LOADING` state. During that time, the environment
5310
+ # keeps on serving the previous version of the agent. After the new agent
5311
+ # version is done loading, the environment is set back to the `RUNNING` state.
5312
+ # You can use "-" as Environment ID in environment name to update version in "
5313
+ # draft" environment. WARNING: this will negate all recent changes to draft and
5314
+ # can't be undone. You may want to save the draft to a version before calling
5315
+ # this function.
5316
+ # @param [String] name
5317
+ # Output only. The unique identifier of this agent environment. Supported
5318
+ # formats: - `projects//agent/environments/` - `projects//locations//agent/
5319
+ # environments/`
5320
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] google_cloud_dialogflow_v2beta1_environment_object
5321
+ # @param [Boolean] allow_load_to_draft_and_discard_changes
5322
+ # Optional. This field is used to prevent accidental overwrite of the draft
5323
+ # environment, which is an operation that cannot be undone. To confirm that the
5324
+ # caller desires this overwrite, this field must be explicitly set to true when
5325
+ # updating the draft environment (environment ID = `-`).
5326
+ # @param [String] update_mask
5327
+ # Required. The mask to control which fields get updated.
5328
+ # @param [String] fields
5329
+ # Selector specifying which fields to include in a partial response.
5330
+ # @param [String] quota_user
5331
+ # Available to use for quota purposes for server-side applications. Can be any
5332
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5333
+ # @param [Google::Apis::RequestOptions] options
5334
+ # Request-specific options
5335
+ #
5336
+ # @yield [result, err] Result & error if block supplied
5337
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment] parsed result object
5338
+ # @yieldparam err [StandardError] error object if request failed
5339
+ #
5340
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment]
5341
+ #
5342
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5343
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5344
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5345
+ def patch_project_location_agent_environment(name, google_cloud_dialogflow_v2beta1_environment_object = nil, allow_load_to_draft_and_discard_changes: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
5346
+ command = make_simple_command(:patch, 'v2beta1/{+name}', options)
5347
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
5348
+ command.request_object = google_cloud_dialogflow_v2beta1_environment_object
5349
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment::Representation
5350
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment
5351
+ command.params['name'] = name unless name.nil?
5352
+ command.query['allowLoadToDraftAndDiscardChanges'] = allow_load_to_draft_and_discard_changes unless allow_load_to_draft_and_discard_changes.nil?
5353
+ command.query['updateMask'] = update_mask unless update_mask.nil?
5354
+ command.query['fields'] = fields unless fields.nil?
5355
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5356
+ execute_or_queue_command(command, &block)
5357
+ end
5358
+
5359
+ # Returns the list of all intents in the specified agent.
5360
+ # @param [String] parent
5361
+ # Required. The agent to list all intents from. Format: `projects//agent` or `
5362
+ # projects//locations//agent`. Alternatively, you can specify the environment to
5363
+ # list intents for. Format: `projects//agent/environments/` or `projects//
5364
+ # locations//agent/environments/`. Note: training phrases of the intents will
5365
+ # not be returned for non-draft environment.
5366
+ # @param [String] intent_view
5367
+ # Optional. The resource view to apply to the returned intent.
5368
+ # @param [String] language_code
5369
+ # Optional. The language used to access language-specific data. If not specified,
5370
+ # the agent's default language is used. For more information, see [Multilingual
5371
+ # intent and entity data](https://cloud.google.com/dialogflow/docs/agents-
5372
+ # multilingual#intent-entity).
5373
+ # @param [Fixnum] page_size
5374
+ # Optional. The maximum number of items to return in a single page. By default
5375
+ # 100 and at most 1000.
5376
+ # @param [String] page_token
5377
+ # Optional. The next_page_token value returned from a previous list request.
5378
+ # @param [String] fields
5379
+ # Selector specifying which fields to include in a partial response.
5380
+ # @param [String] quota_user
5381
+ # Available to use for quota purposes for server-side applications. Can be any
5382
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5383
+ # @param [Google::Apis::RequestOptions] options
5384
+ # Request-specific options
5385
+ #
5386
+ # @yield [result, err] Result & error if block supplied
5387
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListIntentsResponse] parsed result object
5388
+ # @yieldparam err [StandardError] error object if request failed
5389
+ #
5390
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListIntentsResponse]
5391
+ #
5392
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5393
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5394
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5395
+ def list_project_location_agent_environment_intents(parent, intent_view: nil, language_code: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5396
+ command = make_simple_command(:get, 'v2beta1/{+parent}/intents', options)
5397
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListIntentsResponse::Representation
5398
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListIntentsResponse
5399
+ command.params['parent'] = parent unless parent.nil?
5400
+ command.query['intentView'] = intent_view unless intent_view.nil?
5401
+ command.query['languageCode'] = language_code unless language_code.nil?
5402
+ command.query['pageSize'] = page_size unless page_size.nil?
5403
+ command.query['pageToken'] = page_token unless page_token.nil?
5404
+ command.query['fields'] = fields unless fields.nil?
5405
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5406
+ execute_or_queue_command(command, &block)
5407
+ end
5408
+
4895
5409
  # Deletes all active contexts in the specified session.
4896
5410
  # @param [String] parent
4897
5411
  # Required. The name of the session to delete all contexts from. Supported
@@ -5569,7 +6083,11 @@ module Google
5569
6083
 
5570
6084
  # Returns the list of all intents in the specified agent.
5571
6085
  # @param [String] parent
5572
- # Required. The agent to list all intents from. Format: `projects//agent`.
6086
+ # Required. The agent to list all intents from. Format: `projects//agent` or `
6087
+ # projects//locations//agent`. Alternatively, you can specify the environment to
6088
+ # list intents for. Format: `projects//agent/environments/` or `projects//
6089
+ # locations//agent/environments/`. Note: training phrases of the intents will
6090
+ # not be returned for non-draft environment.
5573
6091
  # @param [String] intent_view
5574
6092
  # Optional. The resource view to apply to the returned intent.
5575
6093
  # @param [String] language_code
@@ -6152,6 +6670,180 @@ module Google
6152
6670
  execute_or_queue_command(command, &block)
6153
6671
  end
6154
6672
 
6673
+ # Creates an agent version. The new version points to the agent instance in the "
6674
+ # default" environment.
6675
+ # @param [String] parent
6676
+ # Required. The agent to create a version for. Supported formats: - `projects//
6677
+ # agent` - `projects//locations//agent`
6678
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
6679
+ # @param [String] fields
6680
+ # Selector specifying which fields to include in a partial response.
6681
+ # @param [String] quota_user
6682
+ # Available to use for quota purposes for server-side applications. Can be any
6683
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6684
+ # @param [Google::Apis::RequestOptions] options
6685
+ # Request-specific options
6686
+ #
6687
+ # @yield [result, err] Result & error if block supplied
6688
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] parsed result object
6689
+ # @yieldparam err [StandardError] error object if request failed
6690
+ #
6691
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version]
6692
+ #
6693
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6694
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6695
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6696
+ def create_project_location_agent_version(parent, google_cloud_dialogflow_v2beta1_version_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6697
+ command = make_simple_command(:post, 'v2beta1/{+parent}/versions', options)
6698
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
6699
+ command.request_object = google_cloud_dialogflow_v2beta1_version_object
6700
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
6701
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version
6702
+ command.params['parent'] = parent unless parent.nil?
6703
+ command.query['fields'] = fields unless fields.nil?
6704
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6705
+ execute_or_queue_command(command, &block)
6706
+ end
6707
+
6708
+ # Delete the specified agent version.
6709
+ # @param [String] name
6710
+ # Required. The name of the version to delete. Supported formats: - `projects//
6711
+ # agent/versions/` - `projects//locations//agent/versions/`
6712
+ # @param [String] fields
6713
+ # Selector specifying which fields to include in a partial response.
6714
+ # @param [String] quota_user
6715
+ # Available to use for quota purposes for server-side applications. Can be any
6716
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6717
+ # @param [Google::Apis::RequestOptions] options
6718
+ # Request-specific options
6719
+ #
6720
+ # @yield [result, err] Result & error if block supplied
6721
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
6722
+ # @yieldparam err [StandardError] error object if request failed
6723
+ #
6724
+ # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
6725
+ #
6726
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6727
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6728
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6729
+ def delete_project_location_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
6730
+ command = make_simple_command(:delete, 'v2beta1/{+name}', options)
6731
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
6732
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
6733
+ command.params['name'] = name unless name.nil?
6734
+ command.query['fields'] = fields unless fields.nil?
6735
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6736
+ execute_or_queue_command(command, &block)
6737
+ end
6738
+
6739
+ # Retrieves the specified agent version.
6740
+ # @param [String] name
6741
+ # Required. The name of the version. Supported formats: - `projects//agent/
6742
+ # versions/` - `projects//locations//agent/versions/`
6743
+ # @param [String] fields
6744
+ # Selector specifying which fields to include in a partial response.
6745
+ # @param [String] quota_user
6746
+ # Available to use for quota purposes for server-side applications. Can be any
6747
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6748
+ # @param [Google::Apis::RequestOptions] options
6749
+ # Request-specific options
6750
+ #
6751
+ # @yield [result, err] Result & error if block supplied
6752
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] parsed result object
6753
+ # @yieldparam err [StandardError] error object if request failed
6754
+ #
6755
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version]
6756
+ #
6757
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6758
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6759
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6760
+ def get_project_location_agent_version(name, fields: nil, quota_user: nil, options: nil, &block)
6761
+ command = make_simple_command(:get, 'v2beta1/{+name}', options)
6762
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
6763
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version
6764
+ command.params['name'] = name unless name.nil?
6765
+ command.query['fields'] = fields unless fields.nil?
6766
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6767
+ execute_or_queue_command(command, &block)
6768
+ end
6769
+
6770
+ # Returns the list of all versions of the specified agent.
6771
+ # @param [String] parent
6772
+ # Required. The agent to list all versions from. Supported formats: - `projects//
6773
+ # agent` - `projects//locations//agent`
6774
+ # @param [Fixnum] page_size
6775
+ # Optional. The maximum number of items to return in a single page. By default
6776
+ # 100 and at most 1000.
6777
+ # @param [String] page_token
6778
+ # Optional. The next_page_token value returned from a previous list request.
6779
+ # @param [String] fields
6780
+ # Selector specifying which fields to include in a partial response.
6781
+ # @param [String] quota_user
6782
+ # Available to use for quota purposes for server-side applications. Can be any
6783
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6784
+ # @param [Google::Apis::RequestOptions] options
6785
+ # Request-specific options
6786
+ #
6787
+ # @yield [result, err] Result & error if block supplied
6788
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse] parsed result object
6789
+ # @yieldparam err [StandardError] error object if request failed
6790
+ #
6791
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse]
6792
+ #
6793
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6794
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6795
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6796
+ def list_project_location_agent_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6797
+ command = make_simple_command(:get, 'v2beta1/{+parent}/versions', options)
6798
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse::Representation
6799
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListVersionsResponse
6800
+ command.params['parent'] = parent unless parent.nil?
6801
+ command.query['pageSize'] = page_size unless page_size.nil?
6802
+ command.query['pageToken'] = page_token unless page_token.nil?
6803
+ command.query['fields'] = fields unless fields.nil?
6804
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6805
+ execute_or_queue_command(command, &block)
6806
+ end
6807
+
6808
+ # Updates the specified agent version. Note that this method does not allow you
6809
+ # to update the state of the agent the given version points to. It allows you to
6810
+ # update only mutable properties of the version resource.
6811
+ # @param [String] name
6812
+ # Output only. The unique identifier of this agent version. Supported formats: -
6813
+ # `projects//agent/versions/` - `projects//locations//agent/versions/`
6814
+ # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] google_cloud_dialogflow_v2beta1_version_object
6815
+ # @param [String] update_mask
6816
+ # Required. The mask to control which fields get updated.
6817
+ # @param [String] fields
6818
+ # Selector specifying which fields to include in a partial response.
6819
+ # @param [String] quota_user
6820
+ # Available to use for quota purposes for server-side applications. Can be any
6821
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6822
+ # @param [Google::Apis::RequestOptions] options
6823
+ # Request-specific options
6824
+ #
6825
+ # @yield [result, err] Result & error if block supplied
6826
+ # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version] parsed result object
6827
+ # @yieldparam err [StandardError] error object if request failed
6828
+ #
6829
+ # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version]
6830
+ #
6831
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6832
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6833
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6834
+ def patch_project_location_agent_version(name, google_cloud_dialogflow_v2beta1_version_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
6835
+ command = make_simple_command(:patch, 'v2beta1/{+name}', options)
6836
+ command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
6837
+ command.request_object = google_cloud_dialogflow_v2beta1_version_object
6838
+ command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version::Representation
6839
+ command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version
6840
+ command.params['name'] = name unless name.nil?
6841
+ command.query['updateMask'] = update_mask unless update_mask.nil?
6842
+ command.query['fields'] = fields unless fields.nil?
6843
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6844
+ execute_or_queue_command(command, &block)
6845
+ end
6846
+
6155
6847
  # Deprecated. Retrieves a specific answer record.
6156
6848
  # @param [String] name
6157
6849
  # Required. The name of the answer record to retrieve. Format: `projects//
@@ -6604,110 +7296,6 @@ module Google
6604
7296
  execute_or_queue_command(command, &block)
6605
7297
  end
6606
7298
 
6607
- # Creates a call matcher that links incoming SIP calls to the specified
6608
- # conversation if they fulfill specified criteria.
6609
- # @param [String] parent
6610
- # Required. Resource identifier of the conversation adding the call matcher.
6611
- # Format: `projects//locations//conversations/`.
6612
- # @param [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CreateCallMatcherRequest] google_cloud_dialogflow_v2beta1_create_call_matcher_request_object
6613
- # @param [String] fields
6614
- # Selector specifying which fields to include in a partial response.
6615
- # @param [String] quota_user
6616
- # Available to use for quota purposes for server-side applications. Can be any
6617
- # arbitrary string assigned to a user, but should not exceed 40 characters.
6618
- # @param [Google::Apis::RequestOptions] options
6619
- # Request-specific options
6620
- #
6621
- # @yield [result, err] Result & error if block supplied
6622
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher] parsed result object
6623
- # @yieldparam err [StandardError] error object if request failed
6624
- #
6625
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher]
6626
- #
6627
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6628
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6629
- # @raise [Google::Apis::AuthorizationError] Authorization is required
6630
- def create_project_location_conversation_call_matcher(parent, google_cloud_dialogflow_v2beta1_create_call_matcher_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6631
- command = make_simple_command(:post, 'v2beta1/{+parent}/callMatchers', options)
6632
- command.request_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CreateCallMatcherRequest::Representation
6633
- command.request_object = google_cloud_dialogflow_v2beta1_create_call_matcher_request_object
6634
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher::Representation
6635
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1CallMatcher
6636
- command.params['parent'] = parent unless parent.nil?
6637
- command.query['fields'] = fields unless fields.nil?
6638
- command.query['quotaUser'] = quota_user unless quota_user.nil?
6639
- execute_or_queue_command(command, &block)
6640
- end
6641
-
6642
- # Requests deletion of a call matcher.
6643
- # @param [String] name
6644
- # Required. The unique identifier of the CallMatcher to delete. Format: `
6645
- # projects//locations//conversations//callMatchers/`.
6646
- # @param [String] fields
6647
- # Selector specifying which fields to include in a partial response.
6648
- # @param [String] quota_user
6649
- # Available to use for quota purposes for server-side applications. Can be any
6650
- # arbitrary string assigned to a user, but should not exceed 40 characters.
6651
- # @param [Google::Apis::RequestOptions] options
6652
- # Request-specific options
6653
- #
6654
- # @yield [result, err] Result & error if block supplied
6655
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty] parsed result object
6656
- # @yieldparam err [StandardError] error object if request failed
6657
- #
6658
- # @return [Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty]
6659
- #
6660
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6661
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6662
- # @raise [Google::Apis::AuthorizationError] Authorization is required
6663
- def delete_project_location_conversation_call_matcher(name, fields: nil, quota_user: nil, options: nil, &block)
6664
- command = make_simple_command(:delete, 'v2beta1/{+name}', options)
6665
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty::Representation
6666
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleProtobufEmpty
6667
- command.params['name'] = name unless name.nil?
6668
- command.query['fields'] = fields unless fields.nil?
6669
- command.query['quotaUser'] = quota_user unless quota_user.nil?
6670
- execute_or_queue_command(command, &block)
6671
- end
6672
-
6673
- # Returns the list of all call matchers in the specified conversation.
6674
- # @param [String] parent
6675
- # Required. The conversation to list all call matchers from. Format: `projects//
6676
- # locations//conversations/`.
6677
- # @param [Fixnum] page_size
6678
- # Optional. The maximum number of items to return in a single page. By default
6679
- # 100 and at most 1000.
6680
- # @param [String] page_token
6681
- # Optional. The next_page_token value returned from a previous list request.
6682
- # @param [String] fields
6683
- # Selector specifying which fields to include in a partial response.
6684
- # @param [String] quota_user
6685
- # Available to use for quota purposes for server-side applications. Can be any
6686
- # arbitrary string assigned to a user, but should not exceed 40 characters.
6687
- # @param [Google::Apis::RequestOptions] options
6688
- # Request-specific options
6689
- #
6690
- # @yield [result, err] Result & error if block supplied
6691
- # @yieldparam result [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse] parsed result object
6692
- # @yieldparam err [StandardError] error object if request failed
6693
- #
6694
- # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse]
6695
- #
6696
- # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6697
- # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6698
- # @raise [Google::Apis::AuthorizationError] Authorization is required
6699
- def list_project_location_conversation_call_matchers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
6700
- command = make_simple_command(:get, 'v2beta1/{+parent}/callMatchers', options)
6701
- command.response_representation = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse::Representation
6702
- command.response_class = Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1ListCallMatchersResponse
6703
- command.params['parent'] = parent unless parent.nil?
6704
- command.query['pageSize'] = page_size unless page_size.nil?
6705
- command.query['pageToken'] = page_token unless page_token.nil?
6706
- command.query['fields'] = fields unless fields.nil?
6707
- command.query['quotaUser'] = quota_user unless quota_user.nil?
6708
- execute_or_queue_command(command, &block)
6709
- end
6710
-
6711
7299
  # Batch ingests messages to conversation. Customers can use this RPC to ingest
6712
7300
  # historical messages to conversation.
6713
7301
  # @param [String] parent
@@ -6754,7 +7342,7 @@ module Google
6754
7342
  # Optional. Filter on message fields. Currently predicates on `create_time` and `
6755
7343
  # create_time_epoch_microseconds` are supported. `create_time` only support
6756
7344
  # milliseconds accuracy. E.g., `create_time_epoch_microseconds >
6757
- # 1551790877964485` or `create_time > 2017-01-15T01:30:15.01Z`. For more
7345
+ # 1551790877964485` or `create_time > "2017-01-15T01:30:15.01Z"`. For more
6758
7346
  # information about filtering, see [API Filtering](https://aip.dev/160).
6759
7347
  # @param [Fixnum] page_size
6760
7348
  # Optional. The maximum number of items to return in a single page. By default
@@ -6794,7 +7382,7 @@ module Google
6794
7382
  # Adds a text (chat, for example), or audio (phone recording, for example)
6795
7383
  # message from a participant into the conversation. Note: Always use agent
6796
7384
  # versions for production traffic sent to virtual agents. See [Versions and
6797
- # environments(https://cloud.google.com/dialogflow/es/docs/agents-versions).
7385
+ # environments](https://cloud.google.com/dialogflow/es/docs/agents-versions).
6798
7386
  # @param [String] participant
6799
7387
  # Required. The name of the participant this text comes from. Format: `projects//
6800
7388
  # locations//conversations//participants/`.
@@ -7376,7 +7964,9 @@ module Google
7376
7964
  execute_or_queue_command(command, &block)
7377
7965
  end
7378
7966
 
7379
- # Create documents by importing data from external sources.
7967
+ # Create documents by importing data from external sources. Dialogflow supports
7968
+ # up to 350 documents in each request. If you try to import more, Dialogflow
7969
+ # will return an error.
7380
7970
  # @param [String] parent
7381
7971
  # Required. The knowledge base to import documents into. Format: `projects//
7382
7972
  # locations//knowledgeBases/`.