controls

Creates, updates, deletes, gets or lists a controls resource.

Overview

Name	controls
Type	Resource
Id	google.discoveryengine.controls

Fields

The following fields are returned by SELECT queries:

projects_locations_collections_data_stores_controls_get

Successful response

Name	Datatype	Description
name	string	Immutable. Fully qualified name projects/*/locations/global/dataStore/*/controls/*
associatedServingConfigIds	array	Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.
boostAction	object	Defines a boost-type control (id: GoogleCloudDiscoveryengineV1ControlBoostAction)
conditions	array	Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
displayName	string	Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
filterAction	object	Defines a filter-type control Currently not supported by Recommendation (id: GoogleCloudDiscoveryengineV1ControlFilterAction)
promoteAction	object	Promote certain links based on predefined trigger queries. (id: GoogleCloudDiscoveryengineV1ControlPromoteAction)
redirectAction	object	Defines a redirect-type control. (id: GoogleCloudDiscoveryengineV1ControlRedirectAction)
solutionType	string	Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
synonymsAction	object	Treats a group of terms as synonyms of one another. (id: GoogleCloudDiscoveryengineV1ControlSynonymsAction)
useCases	array	Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.

projects_locations_collections_engines_controls_get

Successful response

Name	Datatype	Description
name	string	Immutable. Fully qualified name projects/*/locations/global/dataStore/*/controls/*
associatedServingConfigIds	array	Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.
boostAction	object	Defines a boost-type control (id: GoogleCloudDiscoveryengineV1ControlBoostAction)
conditions	array	Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
displayName	string	Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
filterAction	object	Defines a filter-type control Currently not supported by Recommendation (id: GoogleCloudDiscoveryengineV1ControlFilterAction)
promoteAction	object	Promote certain links based on predefined trigger queries. (id: GoogleCloudDiscoveryengineV1ControlPromoteAction)
redirectAction	object	Defines a redirect-type control. (id: GoogleCloudDiscoveryengineV1ControlRedirectAction)
solutionType	string	Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
synonymsAction	object	Treats a group of terms as synonyms of one another. (id: GoogleCloudDiscoveryengineV1ControlSynonymsAction)
useCases	array	Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.

projects_locations_collections_data_stores_controls_list

Successful response

Name	Datatype	Description
name	string	Immutable. Fully qualified name projects/*/locations/global/dataStore/*/controls/*
associatedServingConfigIds	array	Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.
boostAction	object	Defines a boost-type control (id: GoogleCloudDiscoveryengineV1ControlBoostAction)
conditions	array	Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
displayName	string	Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
filterAction	object	Defines a filter-type control Currently not supported by Recommendation (id: GoogleCloudDiscoveryengineV1ControlFilterAction)
promoteAction	object	Promote certain links based on predefined trigger queries. (id: GoogleCloudDiscoveryengineV1ControlPromoteAction)
redirectAction	object	Defines a redirect-type control. (id: GoogleCloudDiscoveryengineV1ControlRedirectAction)
solutionType	string	Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
synonymsAction	object	Treats a group of terms as synonyms of one another. (id: GoogleCloudDiscoveryengineV1ControlSynonymsAction)
useCases	array	Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.

projects_locations_collections_engines_controls_list

Successful response

Name	Datatype	Description
name	string	Immutable. Fully qualified name projects/*/locations/global/dataStore/*/controls/*
associatedServingConfigIds	array	Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.
boostAction	object	Defines a boost-type control (id: GoogleCloudDiscoveryengineV1ControlBoostAction)
conditions	array	Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
displayName	string	Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
filterAction	object	Defines a filter-type control Currently not supported by Recommendation (id: GoogleCloudDiscoveryengineV1ControlFilterAction)
promoteAction	object	Promote certain links based on predefined trigger queries. (id: GoogleCloudDiscoveryengineV1ControlPromoteAction)
redirectAction	object	Defines a redirect-type control. (id: GoogleCloudDiscoveryengineV1ControlRedirectAction)
solutionType	string	Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
synonymsAction	object	Treats a group of terms as synonyms of one another. (id: GoogleCloudDiscoveryengineV1ControlSynonymsAction)
useCases	array	Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.

projects_locations_data_stores_controls_get

Successful response

Name	Datatype	Description
name	string	Immutable. Fully qualified name projects/*/locations/global/dataStore/*/controls/*
associatedServingConfigIds	array	Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.
boostAction	object	Defines a boost-type control (id: GoogleCloudDiscoveryengineV1ControlBoostAction)
conditions	array	Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
displayName	string	Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
filterAction	object	Defines a filter-type control Currently not supported by Recommendation (id: GoogleCloudDiscoveryengineV1ControlFilterAction)
promoteAction	object	Promote certain links based on predefined trigger queries. (id: GoogleCloudDiscoveryengineV1ControlPromoteAction)
redirectAction	object	Defines a redirect-type control. (id: GoogleCloudDiscoveryengineV1ControlRedirectAction)
solutionType	string	Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
synonymsAction	object	Treats a group of terms as synonyms of one another. (id: GoogleCloudDiscoveryengineV1ControlSynonymsAction)
useCases	array	Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.

projects_locations_data_stores_controls_list

Successful response

Name	Datatype	Description
name	string	Immutable. Fully qualified name projects/*/locations/global/dataStore/*/controls/*
associatedServingConfigIds	array	Output only. List of all ServingConfig IDs this control is attached to. May take up to 10 minutes to update after changes.
boostAction	object	Defines a boost-type control (id: GoogleCloudDiscoveryengineV1ControlBoostAction)
conditions	array	Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
displayName	string	Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
filterAction	object	Defines a filter-type control Currently not supported by Recommendation (id: GoogleCloudDiscoveryengineV1ControlFilterAction)
promoteAction	object	Promote certain links based on predefined trigger queries. (id: GoogleCloudDiscoveryengineV1ControlPromoteAction)
redirectAction	object	Defines a redirect-type control. (id: GoogleCloudDiscoveryengineV1ControlRedirectAction)
solutionType	string	Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
synonymsAction	object	Treats a group of terms as synonyms of one another. (id: GoogleCloudDiscoveryengineV1ControlSynonymsAction)
useCases	array	Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_collections_data_stores_controls_get	select	projectsId, locationsId, collectionsId, dataStoresId, controlsId		Gets a Control.
projects_locations_collections_engines_controls_get	select	projectsId, locationsId, collectionsId, enginesId, controlsId		Gets a Control.
projects_locations_collections_data_stores_controls_list	select	projectsId, locationsId, collectionsId, dataStoresId	pageSize, pageToken, filter	Lists all Controls by their parent DataStore.
projects_locations_collections_engines_controls_list	select	projectsId, locationsId, collectionsId, enginesId	pageSize, pageToken, filter	Lists all Controls by their parent DataStore.
projects_locations_data_stores_controls_get	select	projectsId, locationsId, dataStoresId, controlsId		Gets a Control.
projects_locations_data_stores_controls_list	select	projectsId, locationsId, dataStoresId	pageSize, pageToken, filter	Lists all Controls by their parent DataStore.
projects_locations_collections_data_stores_controls_create	insert	projectsId, locationsId, collectionsId, dataStoresId	controlId	Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
projects_locations_collections_engines_controls_create	insert	projectsId, locationsId, collectionsId, enginesId	controlId	Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
projects_locations_data_stores_controls_create	insert	projectsId, locationsId, dataStoresId	controlId	Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
projects_locations_collections_data_stores_controls_patch	update	projectsId, locationsId, collectionsId, dataStoresId, controlsId	updateMask	Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.
projects_locations_collections_engines_controls_patch	update	projectsId, locationsId, collectionsId, enginesId, controlsId	updateMask	Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.
projects_locations_data_stores_controls_patch	update	projectsId, locationsId, dataStoresId, controlsId	updateMask	Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.
projects_locations_collections_data_stores_controls_delete	delete	projectsId, locationsId, collectionsId, dataStoresId, controlsId		Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
projects_locations_collections_engines_controls_delete	delete	projectsId, locationsId, collectionsId, enginesId, controlsId		Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
projects_locations_data_stores_controls_delete	delete	projectsId, locationsId, dataStoresId, controlsId		Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
collectionsId	string
controlsId	string
dataStoresId	string
enginesId	string
locationsId	string
projectsId	string
controlId	string
filter	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)

SELECT examples

projects_locations_collections_data_stores_controls_get

Gets a Control.

SELECT
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND collectionsId = '{{ collectionsId }}' -- required
AND dataStoresId = '{{ dataStoresId }}' -- required
AND controlsId = '{{ controlsId }}' -- required;

projects_locations_collections_engines_controls_get

Gets a Control.

SELECT
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND collectionsId = '{{ collectionsId }}' -- required
AND enginesId = '{{ enginesId }}' -- required
AND controlsId = '{{ controlsId }}' -- required;

projects_locations_collections_data_stores_controls_list

Lists all Controls by their parent DataStore.

SELECT
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND collectionsId = '{{ collectionsId }}' -- required
AND dataStoresId = '{{ dataStoresId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

projects_locations_collections_engines_controls_list

Lists all Controls by their parent DataStore.

SELECT
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND collectionsId = '{{ collectionsId }}' -- required
AND enginesId = '{{ enginesId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

projects_locations_data_stores_controls_get

Gets a Control.

SELECT
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND dataStoresId = '{{ dataStoresId }}' -- required
AND controlsId = '{{ controlsId }}' -- required;

projects_locations_data_stores_controls_list

Lists all Controls by their parent DataStore.

SELECT
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND dataStoresId = '{{ dataStoresId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

INSERT examples

projects_locations_collections_data_stores_controls_create

Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.

INSERT INTO google.discoveryengine.controls (
data__boostAction,
data__filterAction,
data__redirectAction,
data__synonymsAction,
data__promoteAction,
data__name,
data__displayName,
data__solutionType,
data__useCases,
data__conditions,
projectsId,
locationsId,
collectionsId,
dataStoresId,
controlId
)
SELECT 
'{{ boostAction }}',
'{{ filterAction }}',
'{{ redirectAction }}',
'{{ synonymsAction }}',
'{{ promoteAction }}',
'{{ name }}',
'{{ displayName }}',
'{{ solutionType }}',
'{{ useCases }}',
'{{ conditions }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ collectionsId }}',
'{{ dataStoresId }}',
'{{ controlId }}'
RETURNING
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
;

projects_locations_collections_engines_controls_create

Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.

INSERT INTO google.discoveryengine.controls (
data__boostAction,
data__filterAction,
data__redirectAction,
data__synonymsAction,
data__promoteAction,
data__name,
data__displayName,
data__solutionType,
data__useCases,
data__conditions,
projectsId,
locationsId,
collectionsId,
enginesId,
controlId
)
SELECT 
'{{ boostAction }}',
'{{ filterAction }}',
'{{ redirectAction }}',
'{{ synonymsAction }}',
'{{ promoteAction }}',
'{{ name }}',
'{{ displayName }}',
'{{ solutionType }}',
'{{ useCases }}',
'{{ conditions }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ collectionsId }}',
'{{ enginesId }}',
'{{ controlId }}'
RETURNING
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
;

projects_locations_data_stores_controls_create

Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.

INSERT INTO google.discoveryengine.controls (
data__boostAction,
data__filterAction,
data__redirectAction,
data__synonymsAction,
data__promoteAction,
data__name,
data__displayName,
data__solutionType,
data__useCases,
data__conditions,
projectsId,
locationsId,
dataStoresId,
controlId
)
SELECT 
'{{ boostAction }}',
'{{ filterAction }}',
'{{ redirectAction }}',
'{{ synonymsAction }}',
'{{ promoteAction }}',
'{{ name }}',
'{{ displayName }}',
'{{ solutionType }}',
'{{ useCases }}',
'{{ conditions }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ dataStoresId }}',
'{{ controlId }}'
RETURNING
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases
;

Manifest

# Description fields are for documentation purposes
- name: controls
  props:
    - name: projectsId
      value: string
      description: Required parameter for the controls resource.
    - name: locationsId
      value: string
      description: Required parameter for the controls resource.
    - name: collectionsId
      value: string
      description: Required parameter for the controls resource.
    - name: dataStoresId
      value: string
      description: Required parameter for the controls resource.
    - name: enginesId
      value: string
      description: Required parameter for the controls resource.
    - name: boostAction
      value: object
      description: >
        Defines a boost-type control
        
    - name: filterAction
      value: object
      description: >
        Defines a filter-type control Currently not supported by Recommendation
        
    - name: redirectAction
      value: object
      description: >
        Defines a redirect-type control.
        
    - name: synonymsAction
      value: object
      description: >
        Treats a group of terms as synonyms of one another.
        
    - name: promoteAction
      value: object
      description: >
        Promote certain links based on predefined trigger queries.
        
    - name: name
      value: string
      description: >
        Immutable. Fully qualified name `projects/*/locations/global/dataStore/*/controls/*`
        
    - name: displayName
      value: string
      description: >
        Required. Human readable name. The identifier used in UI views. Must be UTF-8 encoded string. Length limit is 128 characters. Otherwise an INVALID ARGUMENT error is thrown.
        
    - name: solutionType
      value: string
      description: >
        Required. Immutable. What solution the control belongs to. Must be compatible with vertical of resource. Otherwise an INVALID ARGUMENT error is thrown.
        
      valid_values: ['SOLUTION_TYPE_UNSPECIFIED', 'SOLUTION_TYPE_RECOMMENDATION', 'SOLUTION_TYPE_SEARCH', 'SOLUTION_TYPE_CHAT', 'SOLUTION_TYPE_GENERATIVE_CHAT']
    - name: useCases
      value: array
      description: >
        Specifies the use case for the control. Affects what condition fields can be set. Only applies to SOLUTION_TYPE_SEARCH. Currently only allow one use case per control. Must be set when solution_type is SolutionType.SOLUTION_TYPE_SEARCH.
        
    - name: conditions
      value: array
      description: >
        Determines when the associated action will trigger. Omit to always apply the action. Currently only a single condition may be specified. Otherwise an INVALID ARGUMENT error is thrown.
        
    - name: controlId
      value: string

UPDATE examples

projects_locations_collections_data_stores_controls_patch

Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.

UPDATE google.discoveryengine.controls
SET 
data__boostAction = '{{ boostAction }}',
data__filterAction = '{{ filterAction }}',
data__redirectAction = '{{ redirectAction }}',
data__synonymsAction = '{{ synonymsAction }}',
data__promoteAction = '{{ promoteAction }}',
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__solutionType = '{{ solutionType }}',
data__useCases = '{{ useCases }}',
data__conditions = '{{ conditions }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND collectionsId = '{{ collectionsId }}' --required
AND dataStoresId = '{{ dataStoresId }}' --required
AND controlsId = '{{ controlsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases;

projects_locations_collections_engines_controls_patch

Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.

UPDATE google.discoveryengine.controls
SET 
data__boostAction = '{{ boostAction }}',
data__filterAction = '{{ filterAction }}',
data__redirectAction = '{{ redirectAction }}',
data__synonymsAction = '{{ synonymsAction }}',
data__promoteAction = '{{ promoteAction }}',
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__solutionType = '{{ solutionType }}',
data__useCases = '{{ useCases }}',
data__conditions = '{{ conditions }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND collectionsId = '{{ collectionsId }}' --required
AND enginesId = '{{ enginesId }}' --required
AND controlsId = '{{ controlsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases;

projects_locations_data_stores_controls_patch

Updates a Control. Control action type cannot be changed. If the Control to update does not exist, a NOT_FOUND error is returned.

UPDATE google.discoveryengine.controls
SET 
data__boostAction = '{{ boostAction }}',
data__filterAction = '{{ filterAction }}',
data__redirectAction = '{{ redirectAction }}',
data__synonymsAction = '{{ synonymsAction }}',
data__promoteAction = '{{ promoteAction }}',
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__solutionType = '{{ solutionType }}',
data__useCases = '{{ useCases }}',
data__conditions = '{{ conditions }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND dataStoresId = '{{ dataStoresId }}' --required
AND controlsId = '{{ controlsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
associatedServingConfigIds,
boostAction,
conditions,
displayName,
filterAction,
promoteAction,
redirectAction,
solutionType,
synonymsAction,
useCases;

DELETE examples

projects_locations_collections_data_stores_controls_delete

Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.

DELETE FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND collectionsId = '{{ collectionsId }}' --required
AND dataStoresId = '{{ dataStoresId }}' --required
AND controlsId = '{{ controlsId }}' --required;

projects_locations_collections_engines_controls_delete

Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.

DELETE FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND collectionsId = '{{ collectionsId }}' --required
AND enginesId = '{{ enginesId }}' --required
AND controlsId = '{{ controlsId }}' --required;

projects_locations_data_stores_controls_delete

Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.

DELETE FROM google.discoveryengine.controls
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND dataStoresId = '{{ dataStoresId }}' --required
AND controlsId = '{{ controlsId }}' --required;