Class WarehouseGrpc.WarehouseBlockingStub (0.8.0)

public static final class WarehouseGrpc.WarehouseBlockingStub extends AbstractBlockingStub<WarehouseGrpc.WarehouseBlockingStub>

A stub to allow clients to do synchronous rpc calls to service Warehouse.

Service that manages media content + metadata for streaming.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractBlockingStub > WarehouseGrpc.WarehouseBlockingStub

Methods

addCollectionItem(AddCollectionItemRequest request)

public AddCollectionItemResponse addCollectionItem(AddCollectionItemRequest request)

Adds an item into a Collection.

Parameter
Name Description
request AddCollectionItemRequest
Returns
Type Description
AddCollectionItemResponse

analyzeAsset(AnalyzeAssetRequest request)

public Operation analyzeAsset(AnalyzeAssetRequest request)

Analyze asset to power search capability.

Parameter
Name Description
request AnalyzeAssetRequest
Returns
Type Description
Operation

analyzeCorpus(AnalyzeCorpusRequest request)

public Operation analyzeCorpus(AnalyzeCorpusRequest request)

Analyzes a corpus.

Parameter
Name Description
request AnalyzeCorpusRequest
Returns
Type Description
Operation

build(Channel channel, CallOptions callOptions)

protected WarehouseGrpc.WarehouseBlockingStub build(Channel channel, CallOptions callOptions)
Parameters
Name Description
channel io.grpc.Channel
callOptions io.grpc.CallOptions
Returns
Type Description
WarehouseGrpc.WarehouseBlockingStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

clipAsset(ClipAssetRequest request)

public ClipAssetResponse clipAsset(ClipAssetRequest request)

Supported by STREAM_VIDEO corpus type. Generates clips for downloading. The api takes in a time range, and generates a clip of the first content available after start_time and before end_time, which may overflow beyond these bounds. Returned clips are truncated if the total size of the clips are larger than 100MB.

Parameter
Name Description
request ClipAssetRequest
Returns
Type Description
ClipAssetResponse

createAnnotation(CreateAnnotationRequest request)

public Annotation createAnnotation(CreateAnnotationRequest request)

Creates annotation inside asset.

Parameter
Name Description
request CreateAnnotationRequest
Returns
Type Description
Annotation

createAsset(CreateAssetRequest request)

public Asset createAsset(CreateAssetRequest request)

Creates an asset inside corpus.

Parameter
Name Description
request CreateAssetRequest
Returns
Type Description
Asset

createCollection(CreateCollectionRequest request)

public Operation createCollection(CreateCollectionRequest request)

Creates a collection.

Parameter
Name Description
request CreateCollectionRequest
Returns
Type Description
Operation

createCorpus(CreateCorpusRequest request)

public Operation createCorpus(CreateCorpusRequest request)

Creates a corpus inside a project.

Parameter
Name Description
request CreateCorpusRequest
Returns
Type Description
Operation

createDataSchema(CreateDataSchemaRequest request)

public DataSchema createDataSchema(CreateDataSchemaRequest request)

Creates data schema inside corpus.

Parameter
Name Description
request CreateDataSchemaRequest
Returns
Type Description
DataSchema

createIndex(CreateIndexRequest request)

public Operation createIndex(CreateIndexRequest request)

Creates an Index under the corpus.

Parameter
Name Description
request CreateIndexRequest
Returns
Type Description
Operation

createIndexEndpoint(CreateIndexEndpointRequest request)

public Operation createIndexEndpoint(CreateIndexEndpointRequest request)

Creates an IndexEndpoint.

Parameter
Name Description
request CreateIndexEndpointRequest
Returns
Type Description
Operation

createSearchConfig(CreateSearchConfigRequest request)

public SearchConfig createSearchConfig(CreateSearchConfigRequest request)

Creates a search configuration inside a corpus. Please follow the rules below to create a valid CreateSearchConfigRequest. --- General Rules ---

  1. Request.search_config_id must not be associated with an existing SearchConfig.
  2. Request must contain at least one non-empty search_criteria_property or facet_property.
  3. mapped_fields must not be empty, and must map to existing UGA keys.
  4. All mapped_fields must be of the same type.
  5. All mapped_fields must share the same granularity.
  6. All mapped_fields must share the same semantic SearchConfig match options. For property-specific rules, please reference the comments for FacetProperty and SearchCriteriaProperty.
Parameter
Name Description
request CreateSearchConfigRequest
Returns
Type Description
SearchConfig

createSearchHypernym(CreateSearchHypernymRequest request)

public SearchHypernym createSearchHypernym(CreateSearchHypernymRequest request)

Creates a SearchHypernym inside a corpus.

Parameter
Name Description
request CreateSearchHypernymRequest
Returns
Type Description
SearchHypernym

deleteAnnotation(DeleteAnnotationRequest request)

public Empty deleteAnnotation(DeleteAnnotationRequest request)

Deletes annotation inside asset.

Parameter
Name Description
request DeleteAnnotationRequest
Returns
Type Description
Empty

deleteAsset(DeleteAssetRequest request)

public Operation deleteAsset(DeleteAssetRequest request)

Deletes asset inside corpus.

Parameter
Name Description
request DeleteAssetRequest
Returns
Type Description
Operation

deleteCollection(DeleteCollectionRequest request)

public Operation deleteCollection(DeleteCollectionRequest request)

Deletes a collection.

Parameter
Name Description
request DeleteCollectionRequest
Returns
Type Description
Operation

deleteCorpus(DeleteCorpusRequest request)

public Empty deleteCorpus(DeleteCorpusRequest request)

Deletes a corpus only if its empty. Returns empty response.

Parameter
Name Description
request DeleteCorpusRequest
Returns
Type Description
Empty

deleteDataSchema(DeleteDataSchemaRequest request)

public Empty deleteDataSchema(DeleteDataSchemaRequest request)

Deletes data schema inside corpus.

Parameter
Name Description
request DeleteDataSchemaRequest
Returns
Type Description
Empty

deleteIndex(DeleteIndexRequest request)

public Operation deleteIndex(DeleteIndexRequest request)

Delete a single Index. In order to delete an index, the caller must make sure that it is not deployed to any index endpoint.

Parameter
Name Description
request DeleteIndexRequest
Returns
Type Description
Operation

deleteIndexEndpoint(DeleteIndexEndpointRequest request)

public Operation deleteIndexEndpoint(DeleteIndexEndpointRequest request)

Deletes an IndexEndpoint.

Parameter
Name Description
request DeleteIndexEndpointRequest
Returns
Type Description
Operation

deleteSearchConfig(DeleteSearchConfigRequest request)

public Empty deleteSearchConfig(DeleteSearchConfigRequest request)

Deletes a search configuration inside a corpus. For a DeleteSearchConfigRequest to be valid, Request.search_configuration.name must already exist.

Parameter
Name Description
request DeleteSearchConfigRequest
Returns
Type Description
Empty

deleteSearchHypernym(DeleteSearchHypernymRequest request)

public Empty deleteSearchHypernym(DeleteSearchHypernymRequest request)

Deletes a SearchHypernym inside a corpus.

Parameter
Name Description
request DeleteSearchHypernymRequest
Returns
Type Description
Empty

deployIndex(DeployIndexRequest request)

public Operation deployIndex(DeployIndexRequest request)

Deploys an Index to IndexEndpoint.

Parameter
Name Description
request DeployIndexRequest
Returns
Type Description
Operation

generateHlsUri(GenerateHlsUriRequest request)

public GenerateHlsUriResponse generateHlsUri(GenerateHlsUriRequest request)

Generates a uri for an HLS manifest. The api takes in a collection of time ranges, and generates a URI for an HLS manifest that covers all the requested time ranges.

Parameter
Name Description
request GenerateHlsUriRequest
Returns
Type Description
GenerateHlsUriResponse

generateRetrievalUrl(GenerateRetrievalUrlRequest request)

public GenerateRetrievalUrlResponse generateRetrievalUrl(GenerateRetrievalUrlRequest request)

Generates a signed url for downloading the asset. For video warehouse, please see comment of UploadAsset about how to allow retrieval of cloud storage files in a different project.

Parameter
Name Description
request GenerateRetrievalUrlRequest
Returns
Type Description
GenerateRetrievalUrlResponse

getAnnotation(GetAnnotationRequest request)

public Annotation getAnnotation(GetAnnotationRequest request)

Reads annotation inside asset.

Parameter
Name Description
request GetAnnotationRequest
Returns
Type Description
Annotation

getAsset(GetAssetRequest request)

public Asset getAsset(GetAssetRequest request)

Reads an asset inside corpus.

Parameter
Name Description
request GetAssetRequest
Returns
Type Description
Asset

getCollection(GetCollectionRequest request)

public Collection getCollection(GetCollectionRequest request)

Gets a collection.

Parameter
Name Description
request GetCollectionRequest
Returns
Type Description
Collection

getCorpus(GetCorpusRequest request)

public Corpus getCorpus(GetCorpusRequest request)

Gets corpus details inside a project.

Parameter
Name Description
request GetCorpusRequest
Returns
Type Description
Corpus

getDataSchema(GetDataSchemaRequest request)

public DataSchema getDataSchema(GetDataSchemaRequest request)

Gets data schema inside corpus.

Parameter
Name Description
request GetDataSchemaRequest
Returns
Type Description
DataSchema

getIndex(GetIndexRequest request)

public Index getIndex(GetIndexRequest request)

Gets the details of a single Index under a Corpus.

Parameter
Name Description
request GetIndexRequest
Returns
Type Description
Index

getIndexEndpoint(GetIndexEndpointRequest request)

public IndexEndpoint getIndexEndpoint(GetIndexEndpointRequest request)

Gets an IndexEndpoint.

Parameter
Name Description
request GetIndexEndpointRequest
Returns
Type Description
IndexEndpoint

getSearchConfig(GetSearchConfigRequest request)

public SearchConfig getSearchConfig(GetSearchConfigRequest request)

Gets a search configuration inside a corpus.

Parameter
Name Description
request GetSearchConfigRequest
Returns
Type Description
SearchConfig

getSearchHypernym(GetSearchHypernymRequest request)

public SearchHypernym getSearchHypernym(GetSearchHypernymRequest request)

Gets a SearchHypernym inside a corpus.

Parameter
Name Description
request GetSearchHypernymRequest
Returns
Type Description
SearchHypernym

importAssets(ImportAssetsRequest request)

public Operation importAssets(ImportAssetsRequest request)

Imports assets (images plus annotations) from a meta file on cloud storage. Each row in the meta file is corresponding to an image (specified by a cloud storage uri) and its annotations.

Parameter
Name Description
request ImportAssetsRequest
Returns
Type Description
Operation

indexAsset(IndexAssetRequest request)

public Operation indexAsset(IndexAssetRequest request)

Index one asset for search. Supported corpus type: Corpus.Type.VIDEO_ON_DEMAND

Parameter
Name Description
request IndexAssetRequest
Returns
Type Description
Operation

listAnnotations(ListAnnotationsRequest request)

public ListAnnotationsResponse listAnnotations(ListAnnotationsRequest request)

Lists a list of annotations inside asset.

Parameter
Name Description
request ListAnnotationsRequest
Returns
Type Description
ListAnnotationsResponse

listAssets(ListAssetsRequest request)

public ListAssetsResponse listAssets(ListAssetsRequest request)

Lists an list of assets inside corpus.

Parameter
Name Description
request ListAssetsRequest
Returns
Type Description
ListAssetsResponse

listCollections(ListCollectionsRequest request)

public ListCollectionsResponse listCollections(ListCollectionsRequest request)

Lists collections inside a corpus.

Parameter
Name Description
request ListCollectionsRequest
Returns
Type Description
ListCollectionsResponse

listCorpora(ListCorporaRequest request)

public ListCorporaResponse listCorpora(ListCorporaRequest request)

Lists all corpora in a project.

Parameter
Name Description
request ListCorporaRequest
Returns
Type Description
ListCorporaResponse

listDataSchemas(ListDataSchemasRequest request)

public ListDataSchemasResponse listDataSchemas(ListDataSchemasRequest request)

Lists a list of data schemas inside corpus.

Parameter
Name Description
request ListDataSchemasRequest
Returns
Type Description
ListDataSchemasResponse

listIndexEndpoints(ListIndexEndpointsRequest request)

public ListIndexEndpointsResponse listIndexEndpoints(ListIndexEndpointsRequest request)

Lists all IndexEndpoints in a project.

Parameter
Name Description
request ListIndexEndpointsRequest
Returns
Type Description
ListIndexEndpointsResponse

listIndexes(ListIndexesRequest request)

public ListIndexesResponse listIndexes(ListIndexesRequest request)

List all Indexes in a given Corpus.

Parameter
Name Description
request ListIndexesRequest
Returns
Type Description
ListIndexesResponse

listSearchConfigs(ListSearchConfigsRequest request)

public ListSearchConfigsResponse listSearchConfigs(ListSearchConfigsRequest request)

Lists all search configurations inside a corpus.

Parameter
Name Description
request ListSearchConfigsRequest
Returns
Type Description
ListSearchConfigsResponse

listSearchHypernyms(ListSearchHypernymsRequest request)

public ListSearchHypernymsResponse listSearchHypernyms(ListSearchHypernymsRequest request)

Lists SearchHypernyms inside a corpus.

Parameter
Name Description
request ListSearchHypernymsRequest
Returns
Type Description
ListSearchHypernymsResponse

removeCollectionItem(RemoveCollectionItemRequest request)

public RemoveCollectionItemResponse removeCollectionItem(RemoveCollectionItemRequest request)

Removes an item from a collection.

Parameter
Name Description
request RemoveCollectionItemRequest
Returns
Type Description
RemoveCollectionItemResponse

removeIndexAsset(RemoveIndexAssetRequest request)

public Operation removeIndexAsset(RemoveIndexAssetRequest request)

Remove one asset's index data for search. Supported corpus type: Corpus.Type.VIDEO_ON_DEMAND

Parameter
Name Description
request RemoveIndexAssetRequest
Returns
Type Description
Operation

searchAssets(SearchAssetsRequest request)

public SearchAssetsResponse searchAssets(SearchAssetsRequest request)

Search media asset.

Parameter
Name Description
request SearchAssetsRequest
Returns
Type Description
SearchAssetsResponse

searchIndexEndpoint(SearchIndexEndpointRequest request)

public SearchIndexEndpointResponse searchIndexEndpoint(SearchIndexEndpointRequest request)

Search a deployed index endpoint (IMAGE corpus type only).

Parameter
Name Description
request SearchIndexEndpointRequest
Returns
Type Description
SearchIndexEndpointResponse

undeployIndex(UndeployIndexRequest request)

public Operation undeployIndex(UndeployIndexRequest request)

Undeploys an Index from IndexEndpoint.

Parameter
Name Description
request UndeployIndexRequest
Returns
Type Description
Operation

updateAnnotation(UpdateAnnotationRequest request)

public Annotation updateAnnotation(UpdateAnnotationRequest request)

Updates annotation inside asset.

Parameter
Name Description
request UpdateAnnotationRequest
Returns
Type Description
Annotation

updateAsset(UpdateAssetRequest request)

public Asset updateAsset(UpdateAssetRequest request)

Updates an asset inside corpus.

Parameter
Name Description
request UpdateAssetRequest
Returns
Type Description
Asset

updateCollection(UpdateCollectionRequest request)

public Collection updateCollection(UpdateCollectionRequest request)

Updates a collection.

Parameter
Name Description
request UpdateCollectionRequest
Returns
Type Description
Collection

updateCorpus(UpdateCorpusRequest request)

public Corpus updateCorpus(UpdateCorpusRequest request)

Updates a corpus in a project.

Parameter
Name Description
request UpdateCorpusRequest
Returns
Type Description
Corpus

updateDataSchema(UpdateDataSchemaRequest request)

public DataSchema updateDataSchema(UpdateDataSchemaRequest request)

Updates data schema inside corpus.

Parameter
Name Description
request UpdateDataSchemaRequest
Returns
Type Description
DataSchema

updateIndex(UpdateIndexRequest request)

public Operation updateIndex(UpdateIndexRequest request)

Updates an Index under the corpus. Users can perform a metadata-only update or trigger a full index rebuild with different update_mask values.

Parameter
Name Description
request UpdateIndexRequest
Returns
Type Description
Operation

updateIndexEndpoint(UpdateIndexEndpointRequest request)

public Operation updateIndexEndpoint(UpdateIndexEndpointRequest request)

Updates an IndexEndpoint.

Parameter
Name Description
request UpdateIndexEndpointRequest
Returns
Type Description
Operation

updateSearchConfig(UpdateSearchConfigRequest request)

public SearchConfig updateSearchConfig(UpdateSearchConfigRequest request)

Updates a search configuration inside a corpus. Please follow the rules below to create a valid UpdateSearchConfigRequest. --- General Rules ---

  1. Request.search_configuration.name must already exist.
  2. Request must contain at least one non-empty search_criteria_property or facet_property.
  3. mapped_fields must not be empty, and must map to existing UGA keys.
  4. All mapped_fields must be of the same type.
  5. All mapped_fields must share the same granularity.
  6. All mapped_fields must share the same semantic SearchConfig match options. For property-specific rules, please reference the comments for FacetProperty and SearchCriteriaProperty.
Parameter
Name Description
request UpdateSearchConfigRequest
Returns
Type Description
SearchConfig

updateSearchHypernym(UpdateSearchHypernymRequest request)

public SearchHypernym updateSearchHypernym(UpdateSearchHypernymRequest request)

Updates a SearchHypernym inside a corpus.

Parameter
Name Description
request UpdateSearchHypernymRequest
Returns
Type Description
SearchHypernym

uploadAsset(UploadAssetRequest request)

public Operation uploadAsset(UploadAssetRequest request)

Upload asset by specifing the asset Cloud Storage uri. For video warehouse, it requires users who call this API have read access to the cloud storage file. Once it is uploaded, it can be retrieved by GenerateRetrievalUrl API which by default, only can retrieve cloud storage files from the same project of the warehouse. To allow retrieval cloud storage files that are in a separate project, it requires to find the vision ai service account (Go to IAM, check checkbox to show "Include Google-provided role grants", search for "Cloud Vision AI Service Agent") and grant the read access of the cloud storage files to that service account.

Parameter
Name Description
request UploadAssetRequest
Returns
Type Description
Operation

viewCollectionItems(ViewCollectionItemsRequest request)

public ViewCollectionItemsResponse viewCollectionItems(ViewCollectionItemsRequest request)

View items inside a collection.

Parameter
Name Description
request ViewCollectionItemsRequest
Returns
Type Description
ViewCollectionItemsResponse

viewIndexedAssets(ViewIndexedAssetsRequest request)

public ViewIndexedAssetsResponse viewIndexedAssets(ViewIndexedAssetsRequest request)

Lists assets inside an index.

Parameter
Name Description
request ViewIndexedAssetsRequest
Returns
Type Description
ViewIndexedAssetsResponse