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: https://github.com/googleapis/googleapis-gen/commit/da4276898c106ad7ae8cc3aa55a8c45cf2708fc0 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>

Author: gcf-owl-bot[bot]

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

java-discoveryengine/google-cloud-discoveryengine/src/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);

java-discoveryengine/google-cloud-discoveryengine/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:

java-discoveryengine/google-cloud-discoveryengine/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>())