google-apis-dialogflow_v2beta1 0.7.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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/`.