Class CatalogServiceGrpc.CatalogServiceFutureStub (2.3.0)

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

Service for managing catalog configuration.

Inheritance

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

Methods

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)

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>

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>

updateCatalog(UpdateCatalogRequest request)

public ListenableFuture<Catalog> updateCatalog(UpdateCatalogRequest request)

Updates the Catalogs.

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