feat: [discoveryengine] add site search engine service (#10149)

* feat: add site search engine service feat: add search tuning service feat: add engine support for conversational engine service feat: support search summarization with citations and references docs: keep the API doc up-to-date with recent changes PiperOrigin-RevId: 590625062 Source-Link: googleapis/googleapis@5e2f0b2 Source-Link: googleapis/googleapis-gen@da42768 Copy-Tag: eyJwIjoiamF2YS1kaXNjb3ZlcnllbmdpbmUvLk93bEJvdC55YW1sIiwiaCI6ImRhNDI3Njg5OGMxMDZhZDdhZThjYzNhYTU1YThjNDVjZjI3MDhmYzAifQ== * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Jan 2, 2024 · ebfda8b · ebfda8b
1 parent bfc8e3c
commit ebfda8b
Show file tree

Hide file tree

Showing 184 changed files with 61,720 additions and 1,081 deletions.
diff --git a/java-discoveryengine/README.md b/java-discoveryengine/README.md
@@ -201,7 +201,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-preview-yellow
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-discoveryengine.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-discoveryengine/0.26.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-discoveryengine/0.28.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

diff --git a/...main/java/com/google/cloud/discoveryengine/v1alpha/ConversationalSearchServiceClient.java b/...main/java/com/google/cloud/discoveryengine/v1alpha/ConversationalSearchServiceClient.java
@@ -297,6 +297,7 @@ public final ConverseConversationResponse converseConversation(String name, Text
    *           .setSafeSearch(true)
    *           .putAllUserLabels(new HashMap<String, String>())
    *           .setSummarySpec(SearchRequest.ContentSearchSpec.SummarySpec.newBuilder().build())
+   *           .setFilter("filter-1274492040")
    *           .build();
    *   ConverseConversationResponse response =
    *       conversationalSearchServiceClient.converseConversation(request);
@@ -340,6 +341,7 @@ public final ConverseConversationResponse converseConversation(
    *           .setSafeSearch(true)
    *           .putAllUserLabels(new HashMap<String, String>())
    *           .setSummarySpec(SearchRequest.ContentSearchSpec.SummarySpec.newBuilder().build())
+   *           .setFilter("filter-1274492040")
    *           .build();
    *   ApiFuture<ConverseConversationResponse> future =
    *       conversationalSearchServiceClient.converseConversationCallable().futureCall(request);

diff --git a/...eryengine/src/main/java/com/google/cloud/discoveryengine/v1alpha/EngineServiceClient.java b/...eryengine/src/main/java/com/google/cloud/discoveryengine/v1alpha/EngineServiceClient.java
@@ -1030,7 +1030,8 @@ public final UnaryCallable<PauseEngineRequest, Engine> pauseEngineCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Resumes the training of an existing engine. Only applicable if [solution_type][] is
+   * Resumes the training of an existing engine. Only applicable if
+   * [SolutionType][google.cloud.discoveryengine.v1alpha.SolutionType] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.discoveryengine.v1alpha.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
    *
    * <p>Sample code:
@@ -1059,7 +1060,8 @@ public final Engine resumeEngine(EngineName name) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Resumes the training of an existing engine. Only applicable if [solution_type][] is
+   * Resumes the training of an existing engine. Only applicable if
+   * [SolutionType][google.cloud.discoveryengine.v1alpha.SolutionType] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.discoveryengine.v1alpha.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
    *
    * <p>Sample code:
@@ -1087,7 +1089,8 @@ public final Engine resumeEngine(String name) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Resumes the training of an existing engine. Only applicable if [solution_type][] is
+   * Resumes the training of an existing engine. Only applicable if
+   * [SolutionType][google.cloud.discoveryengine.v1alpha.SolutionType] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.discoveryengine.v1alpha.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
    *
    * <p>Sample code:
@@ -1117,7 +1120,8 @@ public final Engine resumeEngine(ResumeEngineRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Resumes the training of an existing engine. Only applicable if [solution_type][] is
+   * Resumes the training of an existing engine. Only applicable if
+   * [SolutionType][google.cloud.discoveryengine.v1alpha.SolutionType] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.discoveryengine.v1alpha.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
    *
    * <p>Sample code:

diff --git a/...eryengine/src/main/java/com/google/cloud/discoveryengine/v1alpha/SearchServiceClient.java b/...eryengine/src/main/java/com/google/cloud/discoveryengine/v1alpha/SearchServiceClient.java
@@ -63,6 +63,7 @@
  *           .setPageToken("pageToken873572522")
  *           .setOffset(-1019779949)
  *           .setFilter("filter-1274492040")
+ *           .setCanonicalFilter("canonicalFilter-722283124")
  *           .setOrderBy("orderBy-1207110587")
  *           .setUserInfo(UserInfo.newBuilder().build())
  *           .addAllFacetSpecs(new ArrayList<SearchRequest.FacetSpec>())
@@ -233,6 +234,7 @@ public SearchServiceStub getStub() {
    *           .setPageToken("pageToken873572522")
    *           .setOffset(-1019779949)
    *           .setFilter("filter-1274492040")
+   *           .setCanonicalFilter("canonicalFilter-722283124")
    *           .setOrderBy("orderBy-1207110587")
    *           .setUserInfo(UserInfo.newBuilder().build())
    *           .addAllFacetSpecs(new ArrayList<SearchRequest.FacetSpec>())
@@ -289,6 +291,7 @@ public final SearchPagedResponse search(SearchRequest request) {
    *           .setPageToken("pageToken873572522")
    *           .setOffset(-1019779949)
    *           .setFilter("filter-1274492040")
+   *           .setCanonicalFilter("canonicalFilter-722283124")
    *           .setOrderBy("orderBy-1207110587")
    *           .setUserInfo(UserInfo.newBuilder().build())
    *           .addAllFacetSpecs(new ArrayList<SearchRequest.FacetSpec>())
@@ -345,6 +348,7 @@ public final UnaryCallable<SearchRequest, SearchPagedResponse> searchPagedCallab
    *           .setPageToken("pageToken873572522")
    *           .setOffset(-1019779949)
    *           .setFilter("filter-1274492040")
+   *           .setCanonicalFilter("canonicalFilter-722283124")
    *           .setOrderBy("orderBy-1207110587")
    *           .setUserInfo(UserInfo.newBuilder().build())
    *           .addAllFacetSpecs(new ArrayList<SearchRequest.FacetSpec>())