google-apis-discoveryengine_v1 0.4.0 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -51,6 +51,43 @@ module Google
51
51
  @batch_path = 'batch'
52
52
  end
53
53
 
54
+ # Provisions the project resource. During the process, related systems will get
55
+ # prepared and initialized. Caller must read the [Terms for data use](https://
56
+ # cloud.google.com/retail/data-use-terms), and optionally specify in request to
57
+ # provide consent to that service terms.
58
+ # @param [String] name
59
+ # Required. Full resource name of a Project, such as `projects/`
60
+ # project_id_or_number``.
61
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ProvisionProjectRequest] google_cloud_discoveryengine_v1_provision_project_request_object
62
+ # @param [String] fields
63
+ # Selector specifying which fields to include in a partial response.
64
+ # @param [String] quota_user
65
+ # Available to use for quota purposes for server-side applications. Can be any
66
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
67
+ # @param [Google::Apis::RequestOptions] options
68
+ # Request-specific options
69
+ #
70
+ # @yield [result, err] Result & error if block supplied
71
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation] parsed result object
72
+ # @yieldparam err [StandardError] error object if request failed
73
+ #
74
+ # @return [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation]
75
+ #
76
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
77
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
78
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
79
+ def provision_project(name, google_cloud_discoveryengine_v1_provision_project_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
80
+ command = make_simple_command(:post, 'v1/{+name}:provision', options)
81
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ProvisionProjectRequest::Representation
82
+ command.request_object = google_cloud_discoveryengine_v1_provision_project_request_object
83
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation::Representation
84
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation
85
+ command.params['name'] = name unless name.nil?
86
+ command.query['fields'] = fields unless fields.nil?
87
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
88
+ execute_or_queue_command(command, &block)
89
+ end
90
+
54
91
  # Gets the latest state of a long-running operation. Clients can use this method
55
92
  # to poll the operation result at intervals as recommended by the API service.
56
93
  # @param [String] name
@@ -342,8 +379,8 @@ module Google
342
379
  # permission to list DataStores under this location, regardless of whether or
343
380
  # not this data store exists, a PERMISSION_DENIED error is returned.
344
381
  # @param [String] filter
345
- # Filter by solution type . For example: filter = 'solution_type:
346
- # SOLUTION_TYPE_SEARCH'
382
+ # Filter by solution type . For example: `filter = 'solution_type:
383
+ # SOLUTION_TYPE_SEARCH'`
347
384
  # @param [Fixnum] page_size
348
385
  # Maximum number of DataStores to return. If unspecified, defaults to 10. The
349
386
  # maximum allowed value is 50. Values above 50 will be coerced to 50. If this
@@ -815,6 +852,197 @@ module Google
815
852
  execute_or_queue_command(command, &block)
816
853
  end
817
854
 
855
+ # Creates a Control. By default 1000 controls are allowed for a data store. A
856
+ # request can be submitted to adjust this limit. If the Control to create
857
+ # already exists, an ALREADY_EXISTS error is returned.
858
+ # @param [String] parent
859
+ # Required. Full resource name of parent data store. Format: `projects/`
860
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
861
+ # `data_store_id``
862
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] google_cloud_discoveryengine_v1_control_object
863
+ # @param [String] control_id
864
+ # Required. The ID to use for the Control, which will become the final component
865
+ # of the Control's resource name. This value must be within 1-63 characters.
866
+ # Valid characters are /a-z-_/.
867
+ # @param [String] fields
868
+ # Selector specifying which fields to include in a partial response.
869
+ # @param [String] quota_user
870
+ # Available to use for quota purposes for server-side applications. Can be any
871
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
872
+ # @param [Google::Apis::RequestOptions] options
873
+ # Request-specific options
874
+ #
875
+ # @yield [result, err] Result & error if block supplied
876
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
877
+ # @yieldparam err [StandardError] error object if request failed
878
+ #
879
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
880
+ #
881
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
882
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
883
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
884
+ def create_project_location_collection_data_store_control(parent, google_cloud_discoveryengine_v1_control_object = nil, control_id: nil, fields: nil, quota_user: nil, options: nil, &block)
885
+ command = make_simple_command(:post, 'v1/{+parent}/controls', options)
886
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
887
+ command.request_object = google_cloud_discoveryengine_v1_control_object
888
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
889
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
890
+ command.params['parent'] = parent unless parent.nil?
891
+ command.query['controlId'] = control_id unless control_id.nil?
892
+ command.query['fields'] = fields unless fields.nil?
893
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
894
+ execute_or_queue_command(command, &block)
895
+ end
896
+
897
+ # Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error
898
+ # is returned.
899
+ # @param [String] name
900
+ # Required. The resource name of the Control to delete. Format: `projects/`
901
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
902
+ # `data_store_id`/controls/`control_id``
903
+ # @param [String] fields
904
+ # Selector specifying which fields to include in a partial response.
905
+ # @param [String] quota_user
906
+ # Available to use for quota purposes for server-side applications. Can be any
907
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
908
+ # @param [Google::Apis::RequestOptions] options
909
+ # Request-specific options
910
+ #
911
+ # @yield [result, err] Result & error if block supplied
912
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty] parsed result object
913
+ # @yieldparam err [StandardError] error object if request failed
914
+ #
915
+ # @return [Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty]
916
+ #
917
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
918
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
919
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
920
+ def delete_project_location_collection_data_store_control(name, fields: nil, quota_user: nil, options: nil, &block)
921
+ command = make_simple_command(:delete, 'v1/{+name}', options)
922
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty::Representation
923
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty
924
+ command.params['name'] = name unless name.nil?
925
+ command.query['fields'] = fields unless fields.nil?
926
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
927
+ execute_or_queue_command(command, &block)
928
+ end
929
+
930
+ # Gets a Control.
931
+ # @param [String] name
932
+ # Required. The resource name of the Control to get. Format: `projects/`
933
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
934
+ # `data_store_id`/controls/`control_id``
935
+ # @param [String] fields
936
+ # Selector specifying which fields to include in a partial response.
937
+ # @param [String] quota_user
938
+ # Available to use for quota purposes for server-side applications. Can be any
939
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
940
+ # @param [Google::Apis::RequestOptions] options
941
+ # Request-specific options
942
+ #
943
+ # @yield [result, err] Result & error if block supplied
944
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
945
+ # @yieldparam err [StandardError] error object if request failed
946
+ #
947
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
948
+ #
949
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
950
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
951
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
952
+ def get_project_location_collection_data_store_control(name, fields: nil, quota_user: nil, options: nil, &block)
953
+ command = make_simple_command(:get, 'v1/{+name}', options)
954
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
955
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
956
+ command.params['name'] = name unless name.nil?
957
+ command.query['fields'] = fields unless fields.nil?
958
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
959
+ execute_or_queue_command(command, &block)
960
+ end
961
+
962
+ # Lists all Controls by their parent DataStore.
963
+ # @param [String] parent
964
+ # Required. The data store resource name. Format: `projects/`project_number`/
965
+ # locations/`location_id`/collections/`collection_id`/dataStores/`data_store_id``
966
+ # @param [String] filter
967
+ # Optional. A filter to apply on the list results. Supported features: * List
968
+ # all the products under the parent branch if filter is unset. Currently this
969
+ # field is unsupported.
970
+ # @param [Fixnum] page_size
971
+ # Optional. Maximum number of results to return. If unspecified, defaults to 50.
972
+ # Max allowed value is 1000.
973
+ # @param [String] page_token
974
+ # Optional. A page token, received from a previous `ListControls` call. Provide
975
+ # this to retrieve the subsequent page.
976
+ # @param [String] fields
977
+ # Selector specifying which fields to include in a partial response.
978
+ # @param [String] quota_user
979
+ # Available to use for quota purposes for server-side applications. Can be any
980
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
981
+ # @param [Google::Apis::RequestOptions] options
982
+ # Request-specific options
983
+ #
984
+ # @yield [result, err] Result & error if block supplied
985
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse] parsed result object
986
+ # @yieldparam err [StandardError] error object if request failed
987
+ #
988
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse]
989
+ #
990
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
991
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
992
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
993
+ def list_project_location_collection_data_store_controls(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
994
+ command = make_simple_command(:get, 'v1/{+parent}/controls', options)
995
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse::Representation
996
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse
997
+ command.params['parent'] = parent unless parent.nil?
998
+ command.query['filter'] = filter unless filter.nil?
999
+ command.query['pageSize'] = page_size unless page_size.nil?
1000
+ command.query['pageToken'] = page_token unless page_token.nil?
1001
+ command.query['fields'] = fields unless fields.nil?
1002
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1003
+ execute_or_queue_command(command, &block)
1004
+ end
1005
+
1006
+ # Updates a Control. Control action type cannot be changed. If the Control to
1007
+ # update does not exist, a NOT_FOUND error is returned.
1008
+ # @param [String] name
1009
+ # Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/
1010
+ # controls/*`
1011
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] google_cloud_discoveryengine_v1_control_object
1012
+ # @param [String] update_mask
1013
+ # Optional. Indicates which fields in the provided Control to update. The
1014
+ # following are NOT supported: * Control.name * Control.solution_type If not set
1015
+ # or empty, all supported fields are updated.
1016
+ # @param [String] fields
1017
+ # Selector specifying which fields to include in a partial response.
1018
+ # @param [String] quota_user
1019
+ # Available to use for quota purposes for server-side applications. Can be any
1020
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1021
+ # @param [Google::Apis::RequestOptions] options
1022
+ # Request-specific options
1023
+ #
1024
+ # @yield [result, err] Result & error if block supplied
1025
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
1026
+ # @yieldparam err [StandardError] error object if request failed
1027
+ #
1028
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
1029
+ #
1030
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1031
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1032
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1033
+ def patch_project_location_collection_data_store_control(name, google_cloud_discoveryengine_v1_control_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1034
+ command = make_simple_command(:patch, 'v1/{+name}', options)
1035
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
1036
+ command.request_object = google_cloud_discoveryengine_v1_control_object
1037
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
1038
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
1039
+ command.params['name'] = name unless name.nil?
1040
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1041
+ command.query['fields'] = fields unless fields.nil?
1042
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1043
+ execute_or_queue_command(command, &block)
1044
+ end
1045
+
818
1046
  # Converses a conversation.
819
1047
  # @param [String] name
820
1048
  # Required. The resource name of the Conversation to get. Format: `projects/`
@@ -2490,6 +2718,9 @@ module Google
2490
2718
  # across multiple DataStore, the format is: `projects/`project`/locations/`
2491
2719
  # location``.
2492
2720
  # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent] google_cloud_discoveryengine_v1_user_event_object
2721
+ # @param [Boolean] write_async
2722
+ # If set to true, the user event is written asynchronously after validation, and
2723
+ # the API responds without waiting for the write.
2493
2724
  # @param [String] fields
2494
2725
  # Selector specifying which fields to include in a partial response.
2495
2726
  # @param [String] quota_user
@@ -2507,13 +2738,14 @@ module Google
2507
2738
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2508
2739
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2509
2740
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2510
- def write_project_location_collection_data_store_user_event(parent, google_cloud_discoveryengine_v1_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2741
+ def write_project_location_collection_data_store_user_event(parent, google_cloud_discoveryengine_v1_user_event_object = nil, write_async: nil, fields: nil, quota_user: nil, options: nil, &block)
2511
2742
  command = make_simple_command(:post, 'v1/{+parent}/userEvents:write', options)
2512
2743
  command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent::Representation
2513
2744
  command.request_object = google_cloud_discoveryengine_v1_user_event_object
2514
2745
  command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent::Representation
2515
2746
  command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent
2516
2747
  command.params['parent'] = parent unless parent.nil?
2748
+ command.query['writeAsync'] = write_async unless write_async.nil?
2517
2749
  command.query['fields'] = fields unless fields.nil?
2518
2750
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2519
2751
  execute_or_queue_command(command, &block)
@@ -2706,6 +2938,197 @@ module Google
2706
2938
  execute_or_queue_command(command, &block)
2707
2939
  end
2708
2940
 
2941
+ # Creates a Control. By default 1000 controls are allowed for a data store. A
2942
+ # request can be submitted to adjust this limit. If the Control to create
2943
+ # already exists, an ALREADY_EXISTS error is returned.
2944
+ # @param [String] parent
2945
+ # Required. Full resource name of parent data store. Format: `projects/`
2946
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
2947
+ # `data_store_id``
2948
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] google_cloud_discoveryengine_v1_control_object
2949
+ # @param [String] control_id
2950
+ # Required. The ID to use for the Control, which will become the final component
2951
+ # of the Control's resource name. This value must be within 1-63 characters.
2952
+ # Valid characters are /a-z-_/.
2953
+ # @param [String] fields
2954
+ # Selector specifying which fields to include in a partial response.
2955
+ # @param [String] quota_user
2956
+ # Available to use for quota purposes for server-side applications. Can be any
2957
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2958
+ # @param [Google::Apis::RequestOptions] options
2959
+ # Request-specific options
2960
+ #
2961
+ # @yield [result, err] Result & error if block supplied
2962
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
2963
+ # @yieldparam err [StandardError] error object if request failed
2964
+ #
2965
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
2966
+ #
2967
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2968
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2969
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2970
+ def create_project_location_collection_engine_control(parent, google_cloud_discoveryengine_v1_control_object = nil, control_id: nil, fields: nil, quota_user: nil, options: nil, &block)
2971
+ command = make_simple_command(:post, 'v1/{+parent}/controls', options)
2972
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
2973
+ command.request_object = google_cloud_discoveryengine_v1_control_object
2974
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
2975
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
2976
+ command.params['parent'] = parent unless parent.nil?
2977
+ command.query['controlId'] = control_id unless control_id.nil?
2978
+ command.query['fields'] = fields unless fields.nil?
2979
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2980
+ execute_or_queue_command(command, &block)
2981
+ end
2982
+
2983
+ # Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error
2984
+ # is returned.
2985
+ # @param [String] name
2986
+ # Required. The resource name of the Control to delete. Format: `projects/`
2987
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
2988
+ # `data_store_id`/controls/`control_id``
2989
+ # @param [String] fields
2990
+ # Selector specifying which fields to include in a partial response.
2991
+ # @param [String] quota_user
2992
+ # Available to use for quota purposes for server-side applications. Can be any
2993
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2994
+ # @param [Google::Apis::RequestOptions] options
2995
+ # Request-specific options
2996
+ #
2997
+ # @yield [result, err] Result & error if block supplied
2998
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty] parsed result object
2999
+ # @yieldparam err [StandardError] error object if request failed
3000
+ #
3001
+ # @return [Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty]
3002
+ #
3003
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3004
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3005
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3006
+ def delete_project_location_collection_engine_control(name, fields: nil, quota_user: nil, options: nil, &block)
3007
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3008
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty::Representation
3009
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty
3010
+ command.params['name'] = name unless name.nil?
3011
+ command.query['fields'] = fields unless fields.nil?
3012
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3013
+ execute_or_queue_command(command, &block)
3014
+ end
3015
+
3016
+ # Gets a Control.
3017
+ # @param [String] name
3018
+ # Required. The resource name of the Control to get. Format: `projects/`
3019
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
3020
+ # `data_store_id`/controls/`control_id``
3021
+ # @param [String] fields
3022
+ # Selector specifying which fields to include in a partial response.
3023
+ # @param [String] quota_user
3024
+ # Available to use for quota purposes for server-side applications. Can be any
3025
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3026
+ # @param [Google::Apis::RequestOptions] options
3027
+ # Request-specific options
3028
+ #
3029
+ # @yield [result, err] Result & error if block supplied
3030
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
3031
+ # @yieldparam err [StandardError] error object if request failed
3032
+ #
3033
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
3034
+ #
3035
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3036
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3037
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3038
+ def get_project_location_collection_engine_control(name, fields: nil, quota_user: nil, options: nil, &block)
3039
+ command = make_simple_command(:get, 'v1/{+name}', options)
3040
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
3041
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
3042
+ command.params['name'] = name unless name.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
+ # Lists all Controls by their parent DataStore.
3049
+ # @param [String] parent
3050
+ # Required. The data store resource name. Format: `projects/`project_number`/
3051
+ # locations/`location_id`/collections/`collection_id`/dataStores/`data_store_id``
3052
+ # @param [String] filter
3053
+ # Optional. A filter to apply on the list results. Supported features: * List
3054
+ # all the products under the parent branch if filter is unset. Currently this
3055
+ # field is unsupported.
3056
+ # @param [Fixnum] page_size
3057
+ # Optional. Maximum number of results to return. If unspecified, defaults to 50.
3058
+ # Max allowed value is 1000.
3059
+ # @param [String] page_token
3060
+ # Optional. A page token, received from a previous `ListControls` call. Provide
3061
+ # this to retrieve the subsequent page.
3062
+ # @param [String] fields
3063
+ # Selector specifying which fields to include in a partial response.
3064
+ # @param [String] quota_user
3065
+ # Available to use for quota purposes for server-side applications. Can be any
3066
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3067
+ # @param [Google::Apis::RequestOptions] options
3068
+ # Request-specific options
3069
+ #
3070
+ # @yield [result, err] Result & error if block supplied
3071
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse] parsed result object
3072
+ # @yieldparam err [StandardError] error object if request failed
3073
+ #
3074
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse]
3075
+ #
3076
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3077
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3078
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3079
+ def list_project_location_collection_engine_controls(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3080
+ command = make_simple_command(:get, 'v1/{+parent}/controls', options)
3081
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse::Representation
3082
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse
3083
+ command.params['parent'] = parent unless parent.nil?
3084
+ command.query['filter'] = filter unless filter.nil?
3085
+ command.query['pageSize'] = page_size unless page_size.nil?
3086
+ command.query['pageToken'] = page_token unless page_token.nil?
3087
+ command.query['fields'] = fields unless fields.nil?
3088
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3089
+ execute_or_queue_command(command, &block)
3090
+ end
3091
+
3092
+ # Updates a Control. Control action type cannot be changed. If the Control to
3093
+ # update does not exist, a NOT_FOUND error is returned.
3094
+ # @param [String] name
3095
+ # Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/
3096
+ # controls/*`
3097
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] google_cloud_discoveryengine_v1_control_object
3098
+ # @param [String] update_mask
3099
+ # Optional. Indicates which fields in the provided Control to update. The
3100
+ # following are NOT supported: * Control.name * Control.solution_type If not set
3101
+ # or empty, all supported fields are updated.
3102
+ # @param [String] fields
3103
+ # Selector specifying which fields to include in a partial response.
3104
+ # @param [String] quota_user
3105
+ # Available to use for quota purposes for server-side applications. Can be any
3106
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3107
+ # @param [Google::Apis::RequestOptions] options
3108
+ # Request-specific options
3109
+ #
3110
+ # @yield [result, err] Result & error if block supplied
3111
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
3112
+ # @yieldparam err [StandardError] error object if request failed
3113
+ #
3114
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
3115
+ #
3116
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3117
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3118
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3119
+ def patch_project_location_collection_engine_control(name, google_cloud_discoveryengine_v1_control_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3120
+ command = make_simple_command(:patch, 'v1/{+name}', options)
3121
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
3122
+ command.request_object = google_cloud_discoveryengine_v1_control_object
3123
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
3124
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
3125
+ command.params['name'] = name unless name.nil?
3126
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3127
+ command.query['fields'] = fields unless fields.nil?
3128
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3129
+ execute_or_queue_command(command, &block)
3130
+ end
3131
+
2709
3132
  # Converses a conversation.
2710
3133
  # @param [String] name
2711
3134
  # Required. The resource name of the Conversation to get. Format: `projects/`
@@ -3633,8 +4056,8 @@ module Google
3633
4056
  # permission to list DataStores under this location, regardless of whether or
3634
4057
  # not this data store exists, a PERMISSION_DENIED error is returned.
3635
4058
  # @param [String] filter
3636
- # Filter by solution type . For example: filter = 'solution_type:
3637
- # SOLUTION_TYPE_SEARCH'
4059
+ # Filter by solution type . For example: `filter = 'solution_type:
4060
+ # SOLUTION_TYPE_SEARCH'`
3638
4061
  # @param [Fixnum] page_size
3639
4062
  # Maximum number of DataStores to return. If unspecified, defaults to 10. The
3640
4063
  # maximum allowed value is 50. Values above 50 will be coerced to 50. If this
@@ -4106,6 +4529,197 @@ module Google
4106
4529
  execute_or_queue_command(command, &block)
4107
4530
  end
4108
4531
 
4532
+ # Creates a Control. By default 1000 controls are allowed for a data store. A
4533
+ # request can be submitted to adjust this limit. If the Control to create
4534
+ # already exists, an ALREADY_EXISTS error is returned.
4535
+ # @param [String] parent
4536
+ # Required. Full resource name of parent data store. Format: `projects/`
4537
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
4538
+ # `data_store_id``
4539
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] google_cloud_discoveryengine_v1_control_object
4540
+ # @param [String] control_id
4541
+ # Required. The ID to use for the Control, which will become the final component
4542
+ # of the Control's resource name. This value must be within 1-63 characters.
4543
+ # Valid characters are /a-z-_/.
4544
+ # @param [String] fields
4545
+ # Selector specifying which fields to include in a partial response.
4546
+ # @param [String] quota_user
4547
+ # Available to use for quota purposes for server-side applications. Can be any
4548
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4549
+ # @param [Google::Apis::RequestOptions] options
4550
+ # Request-specific options
4551
+ #
4552
+ # @yield [result, err] Result & error if block supplied
4553
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
4554
+ # @yieldparam err [StandardError] error object if request failed
4555
+ #
4556
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
4557
+ #
4558
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4559
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4560
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4561
+ def create_project_location_data_store_control(parent, google_cloud_discoveryengine_v1_control_object = nil, control_id: nil, fields: nil, quota_user: nil, options: nil, &block)
4562
+ command = make_simple_command(:post, 'v1/{+parent}/controls', options)
4563
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
4564
+ command.request_object = google_cloud_discoveryengine_v1_control_object
4565
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
4566
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
4567
+ command.params['parent'] = parent unless parent.nil?
4568
+ command.query['controlId'] = control_id unless control_id.nil?
4569
+ command.query['fields'] = fields unless fields.nil?
4570
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4571
+ execute_or_queue_command(command, &block)
4572
+ end
4573
+
4574
+ # Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error
4575
+ # is returned.
4576
+ # @param [String] name
4577
+ # Required. The resource name of the Control to delete. Format: `projects/`
4578
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
4579
+ # `data_store_id`/controls/`control_id``
4580
+ # @param [String] fields
4581
+ # Selector specifying which fields to include in a partial response.
4582
+ # @param [String] quota_user
4583
+ # Available to use for quota purposes for server-side applications. Can be any
4584
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4585
+ # @param [Google::Apis::RequestOptions] options
4586
+ # Request-specific options
4587
+ #
4588
+ # @yield [result, err] Result & error if block supplied
4589
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty] parsed result object
4590
+ # @yieldparam err [StandardError] error object if request failed
4591
+ #
4592
+ # @return [Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty]
4593
+ #
4594
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4595
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4596
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4597
+ def delete_project_location_data_store_control(name, fields: nil, quota_user: nil, options: nil, &block)
4598
+ command = make_simple_command(:delete, 'v1/{+name}', options)
4599
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty::Representation
4600
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleProtobufEmpty
4601
+ command.params['name'] = name unless name.nil?
4602
+ command.query['fields'] = fields unless fields.nil?
4603
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4604
+ execute_or_queue_command(command, &block)
4605
+ end
4606
+
4607
+ # Gets a Control.
4608
+ # @param [String] name
4609
+ # Required. The resource name of the Control to get. Format: `projects/`
4610
+ # project_number`/locations/`location_id`/collections/`collection_id`/dataStores/
4611
+ # `data_store_id`/controls/`control_id``
4612
+ # @param [String] fields
4613
+ # Selector specifying which fields to include in a partial response.
4614
+ # @param [String] quota_user
4615
+ # Available to use for quota purposes for server-side applications. Can be any
4616
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4617
+ # @param [Google::Apis::RequestOptions] options
4618
+ # Request-specific options
4619
+ #
4620
+ # @yield [result, err] Result & error if block supplied
4621
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
4622
+ # @yieldparam err [StandardError] error object if request failed
4623
+ #
4624
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
4625
+ #
4626
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4627
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4628
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4629
+ def get_project_location_data_store_control(name, fields: nil, quota_user: nil, options: nil, &block)
4630
+ command = make_simple_command(:get, 'v1/{+name}', options)
4631
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
4632
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
4633
+ command.params['name'] = name unless name.nil?
4634
+ command.query['fields'] = fields unless fields.nil?
4635
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4636
+ execute_or_queue_command(command, &block)
4637
+ end
4638
+
4639
+ # Lists all Controls by their parent DataStore.
4640
+ # @param [String] parent
4641
+ # Required. The data store resource name. Format: `projects/`project_number`/
4642
+ # locations/`location_id`/collections/`collection_id`/dataStores/`data_store_id``
4643
+ # @param [String] filter
4644
+ # Optional. A filter to apply on the list results. Supported features: * List
4645
+ # all the products under the parent branch if filter is unset. Currently this
4646
+ # field is unsupported.
4647
+ # @param [Fixnum] page_size
4648
+ # Optional. Maximum number of results to return. If unspecified, defaults to 50.
4649
+ # Max allowed value is 1000.
4650
+ # @param [String] page_token
4651
+ # Optional. A page token, received from a previous `ListControls` call. Provide
4652
+ # this to retrieve the subsequent page.
4653
+ # @param [String] fields
4654
+ # Selector specifying which fields to include in a partial response.
4655
+ # @param [String] quota_user
4656
+ # Available to use for quota purposes for server-side applications. Can be any
4657
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4658
+ # @param [Google::Apis::RequestOptions] options
4659
+ # Request-specific options
4660
+ #
4661
+ # @yield [result, err] Result & error if block supplied
4662
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse] parsed result object
4663
+ # @yieldparam err [StandardError] error object if request failed
4664
+ #
4665
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse]
4666
+ #
4667
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4668
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4669
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4670
+ def list_project_location_data_store_controls(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4671
+ command = make_simple_command(:get, 'v1/{+parent}/controls', options)
4672
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse::Representation
4673
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListControlsResponse
4674
+ command.params['parent'] = parent unless parent.nil?
4675
+ command.query['filter'] = filter unless filter.nil?
4676
+ command.query['pageSize'] = page_size unless page_size.nil?
4677
+ command.query['pageToken'] = page_token unless page_token.nil?
4678
+ command.query['fields'] = fields unless fields.nil?
4679
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4680
+ execute_or_queue_command(command, &block)
4681
+ end
4682
+
4683
+ # Updates a Control. Control action type cannot be changed. If the Control to
4684
+ # update does not exist, a NOT_FOUND error is returned.
4685
+ # @param [String] name
4686
+ # Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/
4687
+ # controls/*`
4688
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] google_cloud_discoveryengine_v1_control_object
4689
+ # @param [String] update_mask
4690
+ # Optional. Indicates which fields in the provided Control to update. The
4691
+ # following are NOT supported: * Control.name * Control.solution_type If not set
4692
+ # or empty, all supported fields are updated.
4693
+ # @param [String] fields
4694
+ # Selector specifying which fields to include in a partial response.
4695
+ # @param [String] quota_user
4696
+ # Available to use for quota purposes for server-side applications. Can be any
4697
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4698
+ # @param [Google::Apis::RequestOptions] options
4699
+ # Request-specific options
4700
+ #
4701
+ # @yield [result, err] Result & error if block supplied
4702
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control] parsed result object
4703
+ # @yieldparam err [StandardError] error object if request failed
4704
+ #
4705
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control]
4706
+ #
4707
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4708
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4709
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4710
+ def patch_project_location_data_store_control(name, google_cloud_discoveryengine_v1_control_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
4711
+ command = make_simple_command(:patch, 'v1/{+name}', options)
4712
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
4713
+ command.request_object = google_cloud_discoveryengine_v1_control_object
4714
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control::Representation
4715
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1Control
4716
+ command.params['name'] = name unless name.nil?
4717
+ command.query['updateMask'] = update_mask unless update_mask.nil?
4718
+ command.query['fields'] = fields unless fields.nil?
4719
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4720
+ execute_or_queue_command(command, &block)
4721
+ end
4722
+
4109
4723
  # Converses a conversation.
4110
4724
  # @param [String] name
4111
4725
  # Required. The resource name of the Conversation to get. Format: `projects/`
@@ -5487,6 +6101,9 @@ module Google
5487
6101
  # across multiple DataStore, the format is: `projects/`project`/locations/`
5488
6102
  # location``.
5489
6103
  # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent] google_cloud_discoveryengine_v1_user_event_object
6104
+ # @param [Boolean] write_async
6105
+ # If set to true, the user event is written asynchronously after validation, and
6106
+ # the API responds without waiting for the write.
5490
6107
  # @param [String] fields
5491
6108
  # Selector specifying which fields to include in a partial response.
5492
6109
  # @param [String] quota_user
@@ -5504,13 +6121,14 @@ module Google
5504
6121
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5505
6122
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5506
6123
  # @raise [Google::Apis::AuthorizationError] Authorization is required
5507
- def write_project_location_data_store_user_event(parent, google_cloud_discoveryengine_v1_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6124
+ def write_project_location_data_store_user_event(parent, google_cloud_discoveryengine_v1_user_event_object = nil, write_async: nil, fields: nil, quota_user: nil, options: nil, &block)
5508
6125
  command = make_simple_command(:post, 'v1/{+parent}/userEvents:write', options)
5509
6126
  command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent::Representation
5510
6127
  command.request_object = google_cloud_discoveryengine_v1_user_event_object
5511
6128
  command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent::Representation
5512
6129
  command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent
5513
6130
  command.params['parent'] = parent unless parent.nil?
6131
+ command.query['writeAsync'] = write_async unless write_async.nil?
5514
6132
  command.query['fields'] = fields unless fields.nil?
5515
6133
  command.query['quotaUser'] = quota_user unless quota_user.nil?
5516
6134
  execute_or_queue_command(command, &block)
@@ -5664,6 +6282,9 @@ module Google
5664
6282
  # across multiple DataStore, the format is: `projects/`project`/locations/`
5665
6283
  # location``.
5666
6284
  # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent] google_cloud_discoveryengine_v1_user_event_object
6285
+ # @param [Boolean] write_async
6286
+ # If set to true, the user event is written asynchronously after validation, and
6287
+ # the API responds without waiting for the write.
5667
6288
  # @param [String] fields
5668
6289
  # Selector specifying which fields to include in a partial response.
5669
6290
  # @param [String] quota_user
@@ -5681,13 +6302,14 @@ module Google
5681
6302
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5682
6303
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5683
6304
  # @raise [Google::Apis::AuthorizationError] Authorization is required
5684
- def write_project_location_user_event(parent, google_cloud_discoveryengine_v1_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6305
+ def write_project_location_user_event(parent, google_cloud_discoveryengine_v1_user_event_object = nil, write_async: nil, fields: nil, quota_user: nil, options: nil, &block)
5685
6306
  command = make_simple_command(:post, 'v1/{+parent}/userEvents:write', options)
5686
6307
  command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent::Representation
5687
6308
  command.request_object = google_cloud_discoveryengine_v1_user_event_object
5688
6309
  command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent::Representation
5689
6310
  command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1UserEvent
5690
6311
  command.params['parent'] = parent unless parent.nil?
6312
+ command.query['writeAsync'] = write_async unless write_async.nil?
5691
6313
  command.query['fields'] = fields unless fields.nil?
5692
6314
  command.query['quotaUser'] = quota_user unless quota_user.nil?
5693
6315
  execute_or_queue_command(command, &block)