feat: [google-cloud-discoveryengine] promote grounding check APIs to v1 GA (#12735)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE
feat: promote grounding check APIs to v1 GA
feat: promote answer APIs to v1 GA
feat: promote ranking APIs to v1 GA
feat: add control service APIs
feat: support writing user events for blended engines
feat: support cancelling import operations
docs: keep the API doc up-to-date with recent changes
END_COMMIT_OVERRIDE



PiperOrigin-RevId: 637140936

Source-Link:
googleapis/googleapis@4f3af9b

Source-Link:
googleapis/googleapis-gen@6cdc4fe
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpc2NvdmVyeWVuZ2luZS8uT3dsQm90LnlhbWwiLCJoIjoiNmNkYzRmZTkzNmZiMzI0Y2JlZTE0M2MxNzdmNmY3NGU0OTU1NDQ4ZCJ9

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-discoveryengine/docs/discoveryengine_v1/control_service.rst

@@ -0,0 +1,10 @@
+ControlService
+--------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.control_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.discoveryengine_v1.services.control_service.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-discoveryengine/docs/discoveryengine_v1/grounded_generation_service.rst

@@ -0,0 +1,6 @@
+GroundedGenerationService
+-------------------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.grounded_generation_service
+    :members:
+    :inherited-members:

packages/google-cloud-discoveryengine/docs/discoveryengine_v1/project_service.rst

@@ -0,0 +1,6 @@
+ProjectService
+--------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.project_service
+    :members:
+    :inherited-members:

packages/google-cloud-discoveryengine/docs/discoveryengine_v1/rank_service.rst

@@ -0,0 +1,6 @@
+RankService
+-----------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.rank_service
+    :members:
+    :inherited-members:

packages/google-cloud-discoveryengine/docs/discoveryengine_v1/services_.rst

@@ -4,10 +4,14 @@ Services for Google Cloud Discoveryengine v1 API
     :maxdepth: 2
 
     completion_service
+    control_service
     conversational_search_service
     data_store_service
     document_service
     engine_service
+    grounded_generation_service
+    project_service
+    rank_service
     recommendation_service
     schema_service
     search_service

packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/__init__.py

@@ -22,6 +22,7 @@
     CompletionServiceAsyncClient,
     CompletionServiceClient,
 )
+from .services.control_service import ControlServiceAsyncClient, ControlServiceClient
 from .services.conversational_search_service import (
     ConversationalSearchServiceAsyncClient,
     ConversationalSearchServiceClient,
@@ -32,6 +33,12 @@
 )
 from .services.document_service import DocumentServiceAsyncClient, DocumentServiceClient
 from .services.engine_service import EngineServiceAsyncClient, EngineServiceClient
+from .services.grounded_generation_service import (
+    GroundedGenerationServiceAsyncClient,
+    GroundedGenerationServiceClient,
+)
+from .services.project_service import ProjectServiceAsyncClient, ProjectServiceClient
+from .services.rank_service import RankServiceAsyncClient, RankServiceClient
 from .services.recommendation_service import (
     RecommendationServiceAsyncClient,
     RecommendationServiceClient,
@@ -46,17 +53,28 @@
     UserEventServiceAsyncClient,
     UserEventServiceClient,
 )
+from .types.answer import Answer
 from .types.common import (
     CustomAttribute,
     IndustryVertical,
     Interval,
     SearchAddOn,
     SearchTier,
+    SearchUseCase,
     SolutionType,
     UserInfo,
 )
 from .types.completion import SuggestionDenyListEntry
 from .types.completion_service import CompleteQueryRequest, CompleteQueryResponse
+from .types.control import Condition, Control
+from .types.control_service import (
+    CreateControlRequest,
+    DeleteControlRequest,
+    GetControlRequest,
+    ListControlsRequest,
+    ListControlsResponse,
+    UpdateControlRequest,
+)
 from .types.conversation import (
     Conversation,
     ConversationContext,
@@ -65,14 +83,23 @@
     TextInput,
 )
 from .types.conversational_search_service import (
+    AnswerQueryRequest,
+    AnswerQueryResponse,
     ConverseConversationRequest,
     ConverseConversationResponse,
     CreateConversationRequest,
+    CreateSessionRequest,
     DeleteConversationRequest,
+    DeleteSessionRequest,
+    GetAnswerRequest,
     GetConversationRequest,
+    GetSessionRequest,
     ListConversationsRequest,
     ListConversationsResponse,
+    ListSessionsRequest,
+    ListSessionsResponse,
     UpdateConversationRequest,
+    UpdateSessionRequest,
 )
 from .types.data_store import DataStore
 from .types.data_store_service import (
@@ -86,6 +113,7 @@
     UpdateDataStoreRequest,
 )
 from .types.document import Document
+from .types.document_processing_config import DocumentProcessingConfig
 from .types.document_service import (
     CreateDocumentRequest,
     DeleteDocumentRequest,
@@ -105,6 +133,12 @@
     ListEnginesResponse,
     UpdateEngineRequest,
 )
+from .types.grounded_generation_service import (
+    CheckGroundingRequest,
+    CheckGroundingResponse,
+    CheckGroundingSpec,
+)
+from .types.grounding import FactChunk, GroundingFact
 from .types.import_config import (
     BigQuerySource,
     BigtableOptions,
@@ -125,6 +159,8 @@
     ImportUserEventsResponse,
     SpannerSource,
 )
+from .types.project import Project
+from .types.project_service import ProvisionProjectMetadata, ProvisionProjectRequest
 from .types.purge_config import (
     PurgeDocumentsMetadata,
     PurgeDocumentsRequest,
@@ -133,6 +169,7 @@
     PurgeSuggestionDenyListEntriesRequest,
     PurgeSuggestionDenyListEntriesResponse,
 )
+from .types.rank_service import RankingRecord, RankRequest, RankResponse
 from .types.recommendation_service import RecommendRequest, RecommendResponse
 from .types.schema import Schema
 from .types.schema_service import (
@@ -147,6 +184,7 @@
     UpdateSchemaRequest,
 )
 from .types.search_service import SearchRequest, SearchResponse
+from .types.session import Query, Session
 from .types.site_search_engine import SiteSearchEngine, SiteVerificationInfo, TargetSite
 from .types.site_search_engine_service import (
     BatchCreateTargetSiteMetadata,
@@ -191,15 +229,22 @@
 
 __all__ = (
     "CompletionServiceAsyncClient",
+    "ControlServiceAsyncClient",
     "ConversationalSearchServiceAsyncClient",
     "DataStoreServiceAsyncClient",
     "DocumentServiceAsyncClient",
     "EngineServiceAsyncClient",
+    "GroundedGenerationServiceAsyncClient",
+    "ProjectServiceAsyncClient",
+    "RankServiceAsyncClient",
     "RecommendationServiceAsyncClient",
     "SchemaServiceAsyncClient",
     "SearchServiceAsyncClient",
     "SiteSearchEngineServiceAsyncClient",
     "UserEventServiceAsyncClient",
+    "Answer",
+    "AnswerQueryRequest",
+    "AnswerQueryResponse",
     "BatchCreateTargetSiteMetadata",
     "BatchCreateTargetSitesRequest",
     "BatchCreateTargetSitesResponse",
@@ -209,18 +254,25 @@
     "BigQuerySource",
     "BigtableOptions",
     "BigtableSource",
+    "CheckGroundingRequest",
+    "CheckGroundingResponse",
+    "CheckGroundingSpec",
     "CloudSqlSource",
     "CollectUserEventRequest",
     "CompleteQueryRequest",
     "CompleteQueryResponse",
     "CompletionInfo",
     "CompletionServiceClient",
+    "Condition",
+    "Control",
+    "ControlServiceClient",
     "Conversation",
     "ConversationContext",
     "ConversationMessage",
     "ConversationalSearchServiceClient",
     "ConverseConversationRequest",
     "ConverseConversationResponse",
+    "CreateControlRequest",
     "CreateConversationRequest",
     "CreateDataStoreMetadata",
     "CreateDataStoreRequest",
@@ -229,11 +281,13 @@
     "CreateEngineRequest",
     "CreateSchemaMetadata",
     "CreateSchemaRequest",
+    "CreateSessionRequest",
     "CreateTargetSiteMetadata",
     "CreateTargetSiteRequest",
     "CustomAttribute",
     "DataStore",
     "DataStoreServiceClient",
+    "DeleteControlRequest",
     "DeleteConversationRequest",
     "DeleteDataStoreMetadata",
     "DeleteDataStoreRequest",
@@ -242,31 +296,39 @@
     "DeleteEngineRequest",
     "DeleteSchemaMetadata",
     "DeleteSchemaRequest",
+    "DeleteSessionRequest",
     "DeleteTargetSiteMetadata",
     "DeleteTargetSiteRequest",
     "DisableAdvancedSiteSearchMetadata",
     "DisableAdvancedSiteSearchRequest",
     "DisableAdvancedSiteSearchResponse",
     "Document",
     "DocumentInfo",
+    "DocumentProcessingConfig",
     "DocumentServiceClient",
     "EnableAdvancedSiteSearchMetadata",
     "EnableAdvancedSiteSearchRequest",
     "EnableAdvancedSiteSearchResponse",
     "Engine",
     "EngineServiceClient",
+    "FactChunk",
     "FetchDomainVerificationStatusRequest",
     "FetchDomainVerificationStatusResponse",
     "FhirStoreSource",
     "FirestoreSource",
     "GcsSource",
+    "GetAnswerRequest",
+    "GetControlRequest",
     "GetConversationRequest",
     "GetDataStoreRequest",
     "GetDocumentRequest",
     "GetEngineRequest",
     "GetSchemaRequest",
+    "GetSessionRequest",
     "GetSiteSearchEngineRequest",
     "GetTargetSiteRequest",
+    "GroundedGenerationServiceClient",
+    "GroundingFact",
     "ImportDocumentsMetadata",
     "ImportDocumentsRequest",
     "ImportDocumentsResponse",
@@ -279,6 +341,8 @@
     "ImportUserEventsResponse",
     "IndustryVertical",
     "Interval",
+    "ListControlsRequest",
+    "ListControlsResponse",
     "ListConversationsRequest",
     "ListConversationsResponse",
     "ListDataStoresRequest",
@@ -289,17 +353,28 @@
     "ListEnginesResponse",
     "ListSchemasRequest",
     "ListSchemasResponse",
+    "ListSessionsRequest",
+    "ListSessionsResponse",
     "ListTargetSitesRequest",
     "ListTargetSitesResponse",
     "MediaInfo",
     "PageInfo",
     "PanelInfo",
+    "Project",
+    "ProjectServiceClient",
+    "ProvisionProjectMetadata",
+    "ProvisionProjectRequest",
     "PurgeDocumentsMetadata",
     "PurgeDocumentsRequest",
     "PurgeDocumentsResponse",
     "PurgeSuggestionDenyListEntriesMetadata",
     "PurgeSuggestionDenyListEntriesRequest",
     "PurgeSuggestionDenyListEntriesResponse",
+    "Query",
+    "RankRequest",
+    "RankResponse",
+    "RankServiceClient",
+    "RankingRecord",
     "RecommendRequest",
     "RecommendResponse",
     "RecommendationServiceClient",
@@ -315,6 +390,8 @@
     "SearchResponse",
     "SearchServiceClient",
     "SearchTier",
+    "SearchUseCase",
+    "Session",
     "SiteSearchEngine",
     "SiteSearchEngineServiceClient",
     "SiteVerificationInfo",
@@ -324,12 +401,14 @@
     "TargetSite",
     "TextInput",
     "TransactionInfo",
+    "UpdateControlRequest",
     "UpdateConversationRequest",
     "UpdateDataStoreRequest",
     "UpdateDocumentRequest",
     "UpdateEngineRequest",
     "UpdateSchemaMetadata",
     "UpdateSchemaRequest",
+    "UpdateSessionRequest",
     "UpdateTargetSiteMetadata",
     "UpdateTargetSiteRequest",
     "UserEvent",