Class CatalogServiceGrpc.CatalogServiceFutureStub (2.17.0)

public static final class CatalogServiceGrpc.CatalogServiceFutureStub extends AbstractFutureStub<CatalogServiceGrpc.CatalogServiceFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service CatalogService.

Service for managing catalog configuration.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > CatalogServiceGrpc.CatalogServiceFutureStub

Methods

addCatalogAttribute(AddCatalogAttributeRequest request)

public ListenableFuture<AttributesConfig> addCatalogAttribute(AddCatalogAttributeRequest request)

Adds the specified CatalogAttribute to the AttributesConfig. If the CatalogAttribute to add already exists, an ALREADY_EXISTS error is returned.

Parameter
NameDescription
requestAddCatalogAttributeRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<AttributesConfig>

batchRemoveCatalogAttributes(BatchRemoveCatalogAttributesRequest request)

public ListenableFuture<BatchRemoveCatalogAttributesResponse> batchRemoveCatalogAttributes(BatchRemoveCatalogAttributesRequest request)

Removes all specified CatalogAttributes from the AttributesConfig.

Parameter
NameDescription
requestBatchRemoveCatalogAttributesRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<BatchRemoveCatalogAttributesResponse>

build(Channel channel, CallOptions callOptions)

protected CatalogServiceGrpc.CatalogServiceFutureStub build(Channel channel, CallOptions callOptions)
Parameters
NameDescription
channelio.grpc.Channel
callOptionsio.grpc.CallOptions
Returns
TypeDescription
CatalogServiceGrpc.CatalogServiceFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

getAttributesConfig(GetAttributesConfigRequest request)

public ListenableFuture<AttributesConfig> getAttributesConfig(GetAttributesConfigRequest request)

Gets an AttributesConfig.

Parameter
NameDescription
requestGetAttributesConfigRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<AttributesConfig>

getCompletionConfig(GetCompletionConfigRequest request)

public ListenableFuture<CompletionConfig> getCompletionConfig(GetCompletionConfigRequest request)

Gets a CompletionConfig.

Parameter
NameDescription
requestGetCompletionConfigRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CompletionConfig>

getDefaultBranch(GetDefaultBranchRequest request)

public ListenableFuture<GetDefaultBranchResponse> getDefaultBranch(GetDefaultBranchRequest request)

Get which branch is currently default branch set by CatalogService.SetDefaultBranch method under a specified parent catalog.

Parameter
NameDescription
requestGetDefaultBranchRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<GetDefaultBranchResponse>

listCatalogs(ListCatalogsRequest request)

public ListenableFuture<ListCatalogsResponse> listCatalogs(ListCatalogsRequest request)

Lists all the Catalogs associated with the project.

Parameter
NameDescription
requestListCatalogsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListCatalogsResponse>

removeCatalogAttribute(RemoveCatalogAttributeRequest request)

public ListenableFuture<AttributesConfig> removeCatalogAttribute(RemoveCatalogAttributeRequest request)

Removes the specified CatalogAttribute from the AttributesConfig. If the CatalogAttribute to remove does not exist, a NOT_FOUND error is returned.

Parameter
NameDescription
requestRemoveCatalogAttributeRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<AttributesConfig>

replaceCatalogAttribute(ReplaceCatalogAttributeRequest request)

public ListenableFuture<AttributesConfig> replaceCatalogAttribute(ReplaceCatalogAttributeRequest request)

Replaces the specified CatalogAttribute in the AttributesConfig by updating the catalog attribute with the same CatalogAttribute.key. If the CatalogAttribute to replace does not exist, a NOT_FOUND error is returned.

Parameter
NameDescription
requestReplaceCatalogAttributeRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<AttributesConfig>

setDefaultBranch(SetDefaultBranchRequest request)

public ListenableFuture<Empty> setDefaultBranch(SetDefaultBranchRequest request)

Set a specified branch id as default branch. API methods such as SearchService.Search, ProductService.GetProduct, ProductService.ListProducts will treat requests using "default_branch" to the actual branch id set as default. For example, if projects/*/locations/*/catalogs/*/branches/1 is set as default, setting SearchRequest.branch to projects/*/locations/*/catalogs/*/branches/default_branch is equivalent to setting SearchRequest.branch to projects/*/locations/*/catalogs/*/branches/1. Using multiple branches can be useful when developers would like to have a staging branch to test and verify for future usage. When it becomes ready, developers switch on the staging branch using this API while keeping using projects/*/locations/*/catalogs/*/branches/default_branch as SearchRequest.branch to route the traffic to this staging branch. CAUTION: If you have live predict/search traffic, switching the default branch could potentially cause outages if the ID space of the new branch is very different from the old one. More specifically:

  • PredictionService will only return product IDs from branch {newBranch}.
  • SearchService will only return product IDs from branch {newBranch} (if branch is not explicitly set).
  • UserEventService will only join events with products from branch {newBranch}.
Parameter
NameDescription
requestSetDefaultBranchRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Empty>

updateAttributesConfig(UpdateAttributesConfigRequest request)

public ListenableFuture<AttributesConfig> updateAttributesConfig(UpdateAttributesConfigRequest request)

Updates the AttributesConfig. The catalog attributes in the request will be updated in the catalog, or inserted if they do not exist. Existing catalog attributes not included in the request will remain unchanged. Attributes that are assigned to products, but do not exist at the catalog level, are always included in the response. The product attribute is assigned default values for missing catalog attribute fields, e.g., searchable and dynamic facetable options.

Parameter
NameDescription
requestUpdateAttributesConfigRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<AttributesConfig>

updateCatalog(UpdateCatalogRequest request)

public ListenableFuture<Catalog> updateCatalog(UpdateCatalogRequest request)

Updates the Catalogs.

Parameter
NameDescription
requestUpdateCatalogRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<Catalog>

updateCompletionConfig(UpdateCompletionConfigRequest request)

public ListenableFuture<CompletionConfig> updateCompletionConfig(UpdateCompletionConfigRequest request)

Updates the CompletionConfigs.

Parameter
NameDescription
requestUpdateCompletionConfigRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<CompletionConfig>