Class CatalogServiceGrpc.CatalogServiceBlockingStub (2.3.0)

public static final class CatalogServiceGrpc.CatalogServiceBlockingStub extends AbstractBlockingStub<CatalogServiceGrpc.CatalogServiceBlockingStub>

Service for managing catalog configuration.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractBlockingStub > CatalogServiceGrpc.CatalogServiceBlockingStub

Methods

build(Channel channel, CallOptions callOptions)

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

getDefaultBranch(GetDefaultBranchRequest request)

public 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
GetDefaultBranchResponse

listCatalogs(ListCatalogsRequest request)

public ListCatalogsResponse listCatalogs(ListCatalogsRequest request)

Lists all the Catalogs associated with the project.

Parameter
NameDescription
requestListCatalogsRequest
Returns
TypeDescription
ListCatalogsResponse

setDefaultBranch(SetDefaultBranchRequest request)

public 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
Empty

updateCatalog(UpdateCatalogRequest request)

public Catalog updateCatalog(UpdateCatalogRequest request)

Updates the Catalogs.

Parameter
NameDescription
requestUpdateCatalogRequest
Returns
TypeDescription
Catalog