feat: add discovery engine v1 library for enterprise search (#11187)

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: Anthonios Partheniou <partheniou@google.com>
googleapis · May 25, 2023 · 10671ec · 10671ec
1 parent 65e6164
commit 10671ec
Show file tree

Hide file tree

Showing 120 changed files with 46,562 additions and 5 deletions.
diff --git a/...ges/google-cloud-discoveryengine/docs/discoveryengine_v1/completion_service.rst b/...ges/google-cloud-discoveryengine/docs/discoveryengine_v1/completion_service.rst
@@ -0,0 +1,6 @@
+CompletionService
+-----------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.completion_service
+    :members:
+    :inherited-members:
diff --git a/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/document_service.rst b/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/document_service.rst
@@ -0,0 +1,10 @@
+DocumentService
+---------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.document_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.discoveryengine_v1.services.document_service.pagers
+    :members:
+    :inherited-members:
diff --git a/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/schema_service.rst b/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/schema_service.rst
@@ -0,0 +1,10 @@
+SchemaService
+-------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.schema_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.discoveryengine_v1.services.schema_service.pagers
+    :members:
+    :inherited-members:
diff --git a/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/search_service.rst b/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/search_service.rst
@@ -0,0 +1,10 @@
+SearchService
+-------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.search_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.discoveryengine_v1.services.search_service.pagers
+    :members:
+    :inherited-members:
diff --git a/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/services.rst b/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/services.rst
@@ -0,0 +1,10 @@
+Services for Google Cloud Discoveryengine v1 API
+================================================
+.. toctree::
+    :maxdepth: 2
+
+    completion_service
+    document_service
+    schema_service
+    search_service
+    user_event_service
diff --git a/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/types.rst b/packages/google-cloud-discoveryengine/docs/discoveryengine_v1/types.rst
@@ -0,0 +1,6 @@
+Types for Google Cloud Discoveryengine v1 API
+=============================================
+
+.. automodule:: google.cloud.discoveryengine_v1.types
+    :members:
+    :show-inheritance:
diff --git a/...ges/google-cloud-discoveryengine/docs/discoveryengine_v1/user_event_service.rst b/...ges/google-cloud-discoveryengine/docs/discoveryengine_v1/user_event_service.rst
@@ -0,0 +1,6 @@
+UserEventService
+----------------------------------
+
+.. automodule:: google.cloud.discoveryengine_v1.services.user_event_service
+    :members:
+    :inherited-members:
diff --git a/packages/google-cloud-discoveryengine/docs/index.rst b/packages/google-cloud-discoveryengine/docs/index.rst
@@ -2,6 +2,17 @@
 
 .. include:: multiprocessing.rst
 
+This package includes clients for multiple versions of Discovery Engine API.
+By default, you will get version ``discoveryengine_v1``.
+
+
+API Reference
+-------------
+.. toctree::
+    :maxdepth: 2
+
+    discoveryengine_v1/services
+    discoveryengine_v1/types
 
 API Reference
 -------------

diff --git a/packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/__init__.py b/packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/__init__.py
@@ -0,0 +1,140 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from google.cloud.discoveryengine_v1 import gapic_version as package_version
+
+__version__ = package_version.__version__
+
+
+from .services.completion_service import (
+    CompletionServiceAsyncClient,
+    CompletionServiceClient,
+)
+from .services.document_service import DocumentServiceAsyncClient, DocumentServiceClient
+from .services.schema_service import SchemaServiceAsyncClient, SchemaServiceClient
+from .services.search_service import SearchServiceAsyncClient, SearchServiceClient
+from .services.user_event_service import (
+    UserEventServiceAsyncClient,
+    UserEventServiceClient,
+)
+from .types.common import CustomAttribute, UserInfo
+from .types.completion_service import CompleteQueryRequest, CompleteQueryResponse
+from .types.document import Document
+from .types.document_service import (
+    CreateDocumentRequest,
+    DeleteDocumentRequest,
+    GetDocumentRequest,
+    ListDocumentsRequest,
+    ListDocumentsResponse,
+    UpdateDocumentRequest,
+)
+from .types.import_config import (
+    BigQuerySource,
+    GcsSource,
+    ImportDocumentsMetadata,
+    ImportDocumentsRequest,
+    ImportDocumentsResponse,
+    ImportErrorConfig,
+    ImportUserEventsMetadata,
+    ImportUserEventsRequest,
+    ImportUserEventsResponse,
+)
+from .types.purge_config import (
+    PurgeDocumentsMetadata,
+    PurgeDocumentsRequest,
+    PurgeDocumentsResponse,
+)
+from .types.schema import Schema
+from .types.schema_service import (
+    CreateSchemaMetadata,
+    CreateSchemaRequest,
+    DeleteSchemaMetadata,
+    DeleteSchemaRequest,
+    GetSchemaRequest,
+    ListSchemasRequest,
+    ListSchemasResponse,
+    UpdateSchemaMetadata,
+    UpdateSchemaRequest,
+)
+from .types.search_service import SearchRequest, SearchResponse
+from .types.user_event import (
+    CompletionInfo,
+    DocumentInfo,
+    MediaInfo,
+    PageInfo,
+    PanelInfo,
+    SearchInfo,
+    TransactionInfo,
+    UserEvent,
+)
+from .types.user_event_service import CollectUserEventRequest, WriteUserEventRequest
+
+__all__ = (
+    "CompletionServiceAsyncClient",
+    "DocumentServiceAsyncClient",
+    "SchemaServiceAsyncClient",
+    "SearchServiceAsyncClient",
+    "UserEventServiceAsyncClient",
+    "BigQuerySource",
+    "CollectUserEventRequest",
+    "CompleteQueryRequest",
+    "CompleteQueryResponse",
+    "CompletionInfo",
+    "CompletionServiceClient",
+    "CreateDocumentRequest",
+    "CreateSchemaMetadata",
+    "CreateSchemaRequest",
+    "CustomAttribute",
+    "DeleteDocumentRequest",
+    "DeleteSchemaMetadata",
+    "DeleteSchemaRequest",
+    "Document",
+    "DocumentInfo",
+    "DocumentServiceClient",
+    "GcsSource",
+    "GetDocumentRequest",
+    "GetSchemaRequest",
+    "ImportDocumentsMetadata",
+    "ImportDocumentsRequest",
+    "ImportDocumentsResponse",
+    "ImportErrorConfig",
+    "ImportUserEventsMetadata",
+    "ImportUserEventsRequest",
+    "ImportUserEventsResponse",
+    "ListDocumentsRequest",
+    "ListDocumentsResponse",
+    "ListSchemasRequest",
+    "ListSchemasResponse",
+    "MediaInfo",
+    "PageInfo",
+    "PanelInfo",
+    "PurgeDocumentsMetadata",
+    "PurgeDocumentsRequest",
+    "PurgeDocumentsResponse",
+    "Schema",
+    "SchemaServiceClient",
+    "SearchInfo",
+    "SearchRequest",
+    "SearchResponse",
+    "SearchServiceClient",
+    "TransactionInfo",
+    "UpdateDocumentRequest",
+    "UpdateSchemaMetadata",
+    "UpdateSchemaRequest",
+    "UserEvent",
+    "UserEventServiceClient",
+    "UserInfo",
+    "WriteUserEventRequest",
+)