Skip navigation links

@Generated(value="by gapic-generator-java")

Package com.google.cloud.discoveryengine.v1alpha

A client to Discovery Engine API The interfaces provided are listed below, along with usage samples.

See: Description

Package com.google.cloud.discoveryengine.v1alpha Description

A client to Discovery Engine API

The interfaces provided are listed below, along with usage samples.

======================= AclConfigServiceClient =======================

Service Description: Service for managing Acl Configuration.

Sample for AclConfigServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (AclConfigServiceClient aclConfigServiceClient = AclConfigServiceClient.create()) {
   UpdateAclConfigRequest request =
       UpdateAclConfigRequest.newBuilder().setAclConfig(AclConfig.newBuilder().build()).build();
   AclConfig response = aclConfigServiceClient.updateAclConfig(request);
 }

======================= ChunkServiceClient =======================

Service Description: Service for displaying processed [Chunk][google.cloud.discoveryengine.v1alpha.Chunk] information of the customer's unstructured data.

Sample for ChunkServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ChunkServiceClient chunkServiceClient = ChunkServiceClient.create()) {
   ChunkName name =
       ChunkName.ofProjectLocationDataStoreBranchDocumentChunkName(
           "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[BRANCH]", "[DOCUMENT]", "[CHUNK]");
   Chunk response = chunkServiceClient.getChunk(name);
 }

======================= CompletionServiceClient =======================

Service Description: Service for Auto-Completion.

Sample for CompletionServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
   CompleteQueryRequest request =
       CompleteQueryRequest.newBuilder()
           .setDataStore(
               DataStoreName.ofProjectLocationDataStoreName(
                       "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
                   .toString())
           .setQuery("query107944136")
           .setQueryModel("queryModel-184930495")
           .setUserPseudoId("userPseudoId-1155274652")
           .setIncludeTailSuggestions(true)
           .build();
   CompleteQueryResponse response = completionServiceClient.completeQuery(request);
 }

======================= ControlServiceClient =======================

Service Description: Service for performing CRUD operations on Controls. Controls allow for custom logic to be implemented in the serving path. Controls need to be attached to a Serving Config to be considered during a request.

Sample for ControlServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ControlServiceClient controlServiceClient = ControlServiceClient.create()) {
   DataStoreName parent =
       DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
   Control control = Control.newBuilder().build();
   String controlId = "controlId-395080872";
   Control response = controlServiceClient.createControl(parent, control, controlId);
 }

======================= ConversationalSearchServiceClient =======================

Service Description: Service for conversational search.

Sample for ConversationalSearchServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ConversationalSearchServiceClient conversationalSearchServiceClient =
     ConversationalSearchServiceClient.create()) {
   ConversationName name =
       ConversationName.ofProjectLocationDataStoreConversationName(
           "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[CONVERSATION]");
   TextInput query = TextInput.newBuilder().build();
   ConverseConversationResponse response =
       conversationalSearchServiceClient.converseConversation(name, query);
 }

======================= DataStoreServiceClient =======================

Service Description: Service for managing [DataStore][google.cloud.discoveryengine.v1alpha.DataStore] configuration.

Sample for DataStoreServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (DataStoreServiceClient dataStoreServiceClient = DataStoreServiceClient.create()) {
   DataStoreName name =
       DataStoreName.ofProjectLocationDataStoreName("[PROJECT]", "[LOCATION]", "[DATA_STORE]");
   DataStore response = dataStoreServiceClient.getDataStore(name);
 }

======================= DocumentServiceClient =======================

Service Description: Service for ingesting [Document][google.cloud.discoveryengine.v1alpha.Document] information of the customer's website.

Sample for DocumentServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (DocumentServiceClient documentServiceClient = DocumentServiceClient.create()) {
   DocumentName name =
       DocumentName.ofProjectLocationDataStoreBranchDocumentName(
           "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[BRANCH]", "[DOCUMENT]");
   Document response = documentServiceClient.getDocument(name);
 }

======================= EngineServiceClient =======================

Service Description: Service for managing [Engine][google.cloud.discoveryengine.v1alpha.Engine] configuration.

Sample for EngineServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (EngineServiceClient engineServiceClient = EngineServiceClient.create()) {
   Engine engine = Engine.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Engine response = engineServiceClient.updateEngine(engine, updateMask);
 }

======================= EstimateBillingServiceClient =======================

Service Description: Service for managing billing estimations resources.

Sample for EstimateBillingServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (EstimateBillingServiceClient estimateBillingServiceClient =
     EstimateBillingServiceClient.create()) {
   EstimateDataSizeRequest request =
       EstimateDataSizeRequest.newBuilder()
           .setLocation(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .build();
   EstimateDataSizeResponse response =
       estimateBillingServiceClient.estimateDataSizeAsync(request).get();
 }

======================= EvaluationServiceClient =======================

Service Description: Service for managing [Evaluation][google.cloud.discoveryengine.v1alpha.Evaluation]s,

Sample for EvaluationServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (EvaluationServiceClient evaluationServiceClient = EvaluationServiceClient.create()) {
   EvaluationName name = EvaluationName.of("[PROJECT]", "[LOCATION]", "[EVALUATION]");
   Evaluation response = evaluationServiceClient.getEvaluation(name);
 }

======================= GroundedGenerationServiceClient =======================

Service Description: Service for grounded generation.

Sample for GroundedGenerationServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (GroundedGenerationServiceClient groundedGenerationServiceClient =
     GroundedGenerationServiceClient.create()) {
   CheckGroundingRequest request =
       CheckGroundingRequest.newBuilder()
           .setGroundingConfig(
               GroundingConfigName.of("[PROJECT]", "[LOCATION]", "[GROUNDING_CONFIG]")
                   .toString())
           .setAnswerCandidate("answerCandidate-292402331")
           .addAllFacts(new ArrayList<GroundingFact>())
           .setGroundingSpec(CheckGroundingSpec.newBuilder().build())
           .putAllUserLabels(new HashMap<String, String>())
           .build();
   CheckGroundingResponse response = groundedGenerationServiceClient.checkGrounding(request);
 }

======================= ProjectServiceClient =======================

Service Description: Service for operations on the [Project][google.cloud.discoveryengine.v1alpha.Project].

Sample for ProjectServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ProjectServiceClient projectServiceClient = ProjectServiceClient.create()) {
   ProjectName name = ProjectName.of("[PROJECT]");
   Project response = projectServiceClient.getProject(name);
 }

======================= RankServiceClient =======================

Service Description: Service for ranking text records.

Sample for RankServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (RankServiceClient rankServiceClient = RankServiceClient.create()) {
   RankRequest request =
       RankRequest.newBuilder()
           .setRankingConfig(
               RankingConfigName.of("[PROJECT]", "[LOCATION]", "[RANKING_CONFIG]").toString())
           .setModel("model104069929")
           .setTopN(110545924)
           .setQuery("query107944136")
           .addAllRecords(new ArrayList<RankingRecord>())
           .setIgnoreRecordDetailsInResponse(true)
           .putAllUserLabels(new HashMap<String, String>())
           .build();
   RankResponse response = rankServiceClient.rank(request);
 }

======================= RecommendationServiceClient =======================

Service Description: Service for making recommendations.

Sample for RecommendationServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (RecommendationServiceClient recommendationServiceClient =
     RecommendationServiceClient.create()) {
   RecommendRequest request =
       RecommendRequest.newBuilder()
           .setServingConfig(
               ServingConfigName.ofProjectLocationDataStoreServingConfigName(
                       "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SERVING_CONFIG]")
                   .toString())
           .setUserEvent(UserEvent.newBuilder().build())
           .setPageSize(883849137)
           .setFilter("filter-1274492040")
           .setValidateOnly(true)
           .putAllParams(new HashMap<String, Value>())
           .putAllUserLabels(new HashMap<String, String>())
           .build();
   RecommendResponse response = recommendationServiceClient.recommend(request);
 }

======================= SampleQueryServiceClient =======================

Service Description: Service for managing [SampleQuery][google.cloud.discoveryengine.v1alpha.SampleQuery]s,

Sample for SampleQueryServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (SampleQueryServiceClient sampleQueryServiceClient = SampleQueryServiceClient.create()) {
   SampleQueryName name =
       SampleQueryName.of("[PROJECT]", "[LOCATION]", "[SAMPLE_QUERY_SET]", "[SAMPLE_QUERY]");
   SampleQuery response = sampleQueryServiceClient.getSampleQuery(name);
 }

======================= SampleQuerySetServiceClient =======================

Service Description: Service for managing [SampleQuerySet][google.cloud.discoveryengine.v1alpha.SampleQuerySet]s,

Sample for SampleQuerySetServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (SampleQuerySetServiceClient sampleQuerySetServiceClient =
     SampleQuerySetServiceClient.create()) {
   SampleQuerySetName name =
       SampleQuerySetName.of("[PROJECT]", "[LOCATION]", "[SAMPLE_QUERY_SET]");
   SampleQuerySet response = sampleQuerySetServiceClient.getSampleQuerySet(name);
 }

======================= SchemaServiceClient =======================

Service Description: Service for managing [Schema][google.cloud.discoveryengine.v1alpha.Schema]s.

Sample for SchemaServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (SchemaServiceClient schemaServiceClient = SchemaServiceClient.create()) {
   SchemaName name =
       SchemaName.ofProjectLocationDataStoreSchemaName(
           "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SCHEMA]");
   Schema response = schemaServiceClient.getSchema(name);
 }

======================= SearchServiceClient =======================

Service Description: Service for search.

Sample for SearchServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (SearchServiceClient searchServiceClient = SearchServiceClient.create()) {
   SearchRequest request =
       SearchRequest.newBuilder()
           .setServingConfig(
               ServingConfigName.ofProjectLocationDataStoreServingConfigName(
                       "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SERVING_CONFIG]")
                   .toString())
           .setBranch(
               BranchName.ofProjectLocationDataStoreBranchName(
                       "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[BRANCH]")
                   .toString())
           .setQuery("query107944136")
           .setImageQuery(SearchRequest.ImageQuery.newBuilder().build())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .setOffset(-1019779949)
           .addAllDataStoreSpecs(new ArrayList<SearchRequest.DataStoreSpec>())
           .setFilter("filter-1274492040")
           .setCanonicalFilter("canonicalFilter-722283124")
           .setOrderBy("orderBy-1207110587")
           .setUserInfo(UserInfo.newBuilder().build())
           .setLanguageCode("languageCode-2092349083")
           .setRegionCode("regionCode-1991004415")
           .addAllFacetSpecs(new ArrayList<SearchRequest.FacetSpec>())
           .setBoostSpec(SearchRequest.BoostSpec.newBuilder().build())
           .putAllParams(new HashMap<String, Value>())
           .setQueryExpansionSpec(SearchRequest.QueryExpansionSpec.newBuilder().build())
           .setSpellCorrectionSpec(SearchRequest.SpellCorrectionSpec.newBuilder().build())
           .setUserPseudoId("userPseudoId-1155274652")
           .setContentSearchSpec(SearchRequest.ContentSearchSpec.newBuilder().build())
           .setEmbeddingSpec(SearchRequest.EmbeddingSpec.newBuilder().build())
           .setRankingExpression("rankingExpression2110320494")
           .setSafeSearch(true)
           .putAllUserLabels(new HashMap<String, String>())
           .setNaturalLanguageQueryUnderstandingSpec(
               SearchRequest.NaturalLanguageQueryUnderstandingSpec.newBuilder().build())
           .setSearchAsYouTypeSpec(SearchRequest.SearchAsYouTypeSpec.newBuilder().build())
           .setCustomFineTuningSpec(CustomFineTuningSpec.newBuilder().build())
           .setSession(
               SessionName.ofProjectLocationDataStoreSessionName(
                       "[PROJECT]", "[LOCATION]", "[DATA_STORE]", "[SESSION]")
                   .toString())
           .setSessionSpec(SearchRequest.SessionSpec.newBuilder().build())
           .build();
   for (SearchResponse.SearchResult element : searchServiceClient.search(request).iterateAll()) {
     // doThingsWith(element);
   }
 }

======================= SearchTuningServiceClient =======================

Service Description: Service for search tuning.

Sample for SearchTuningServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (SearchTuningServiceClient searchTuningServiceClient = SearchTuningServiceClient.create()) {
   ListCustomModelsRequest request =
       ListCustomModelsRequest.newBuilder()
           .setDataStore(
               DataStoreName.ofProjectLocationCollectionDataStoreName(
                       "[PROJECT]", "[LOCATION]", "[COLLECTION]", "[DATA_STORE]")
                   .toString())
           .build();
   ListCustomModelsResponse response = searchTuningServiceClient.listCustomModels(request);
 }

======================= ServingConfigServiceClient =======================

Service Description: Service for operations related to [ServingConfig][google.cloud.discoveryengine.v1alpha.ServingConfig].

Sample for ServingConfigServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (ServingConfigServiceClient servingConfigServiceClient =
     ServingConfigServiceClient.create()) {
   ServingConfig servingConfig = ServingConfig.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   ServingConfig response =
       servingConfigServiceClient.updateServingConfig(servingConfig, updateMask);
 }

======================= SiteSearchEngineServiceClient =======================

Service Description: Service for managing site search related resources.

Sample for SiteSearchEngineServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (SiteSearchEngineServiceClient siteSearchEngineServiceClient =
     SiteSearchEngineServiceClient.create()) {
   SiteSearchEngineName name =
       SiteSearchEngineName.ofProjectLocationDataStoreName(
           "[PROJECT]", "[LOCATION]", "[DATA_STORE]");
   SiteSearchEngine response = siteSearchEngineServiceClient.getSiteSearchEngine(name);
 }

======================= UserEventServiceClient =======================

Service Description: Service for ingesting end user actions on a website to Discovery Engine API.

Sample for UserEventServiceClient: 


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (UserEventServiceClient userEventServiceClient = UserEventServiceClient.create()) {
   WriteUserEventRequest request =
       WriteUserEventRequest.newBuilder()
           .setParent(
               DataStoreName.ofProjectLocationDataStoreName(
                       "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
                   .toString())
           .setUserEvent(UserEvent.newBuilder().build())
           .setWriteAsync(true)
           .build();
   UserEvent response = userEventServiceClient.writeUserEvent(request);
 }
Skip navigation links

Copyright © 2025 Google LLC. All rights reserved.