- 0.62.0 (latest)
- 0.61.0
- 0.60.0
- 0.59.0
- 0.58.0
- 0.56.0
- 0.55.0
- 0.54.0
- 0.53.0
- 0.52.0
- 0.51.0
- 0.50.0
- 0.49.0
- 0.48.0
- 0.47.0
- 0.46.0
- 0.44.0
- 0.43.0
- 0.42.0
- 0.41.0
- 0.40.0
- 0.39.0
- 0.38.0
- 0.37.0
- 0.36.0
- 0.35.0
- 0.34.0
- 0.31.0
- 0.30.0
- 0.29.0
- 0.28.0
- 0.27.0
- 0.26.0
- 0.25.0
- 0.24.0
- 0.23.0
- 0.22.0
- 0.21.0
- 0.20.0
- 0.19.0
- 0.18.0
- 0.16.0
- 0.15.0
- 0.14.0
- 0.13.0
- 0.12.0
- 0.11.0
- 0.10.4
- 0.8.10
The interfaces provided are listed below, along with usage samples.
CatalogServiceClient
Service Description: Service for ingesting catalog information of the customer's website.
Sample for CatalogServiceClient:
// 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
CatalogName parent = CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]");
CatalogItem catalogItem = CatalogItem.newBuilder().build();
CatalogItem response = catalogServiceClient.createCatalogItem(parent, catalogItem);
}
PredictionApiKeyRegistryClient
Service Description: Service for registering API keys for use with the predict
method. If
you use an API key to request predictions, you must first register the API key. Otherwise, your
prediction request is rejected. If you use OAuth to authenticate your predict
method call, you
do not need to register an API key. You can register up to 20 API keys per project.
Sample for PredictionApiKeyRegistryClient:
// 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 (PredictionApiKeyRegistryClient predictionApiKeyRegistryClient =
PredictionApiKeyRegistryClient.create()) {
EventStoreName parent =
EventStoreName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[EVENT_STORE]");
PredictionApiKeyRegistration predictionApiKeyRegistration =
PredictionApiKeyRegistration.newBuilder().build();
PredictionApiKeyRegistration response =
predictionApiKeyRegistryClient.createPredictionApiKeyRegistration(
parent, predictionApiKeyRegistration);
}
PredictionServiceClient
Service Description: Service for making recommendation prediction.
Sample for PredictionServiceClient:
// 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 (PredictionServiceClient predictionServiceClient = PredictionServiceClient.create()) {
PlacementName name =
PlacementName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[EVENT_STORE]", "[PLACEMENT]");
UserEvent userEvent = UserEvent.newBuilder().build();
for (Map.Entry<String, Value> element :
predictionServiceClient.predict(name, userEvent).iterateAll()) {
// doThingsWith(element);
}
}
UserEventServiceClient
Service Description: Service for ingesting end user actions on the customer website.
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()) {
EventStoreName parent =
EventStoreName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[EVENT_STORE]");
UserEvent userEvent = UserEvent.newBuilder().build();
UserEvent response = userEventServiceClient.writeUserEvent(parent, userEvent);
}
Classes
Catalog
CatalogInlineSource
The inline source for the input config for ImportCatalogItems method.
Protobuf type google.cloud.recommendationengine.v1beta1.CatalogInlineSource
CatalogInlineSource.Builder
The inline source for the input config for ImportCatalogItems method.
Protobuf type google.cloud.recommendationengine.v1beta1.CatalogInlineSource
CatalogItem
CatalogItem captures all metadata information of items to be recommended.
Protobuf type google.cloud.recommendationengine.v1beta1.CatalogItem
CatalogItem.Builder
CatalogItem captures all metadata information of items to be recommended.
Protobuf type google.cloud.recommendationengine.v1beta1.CatalogItem
CatalogItem.CategoryHierarchy
Category represents catalog item category hierarchy.
Protobuf type google.cloud.recommendationengine.v1beta1.CatalogItem.CategoryHierarchy
CatalogItem.CategoryHierarchy.Builder
Category represents catalog item category hierarchy.
Protobuf type google.cloud.recommendationengine.v1beta1.CatalogItem.CategoryHierarchy
CatalogItemPathName
CatalogItemPathName.Builder
Builder for projects/{project}/locations/{location}/catalogs/{catalog}/catalogItems/{catalog_item_path}.
CatalogName
CatalogName.Builder
Builder for projects/{project}/locations/{location}/catalogs/{catalog}.
CatalogServiceClient
Service Description: Service for ingesting catalog information of the customer's website.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
// 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 (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
CatalogName parent = CatalogName.of("[PROJECT]", "[LOCATION]", "[CATALOG]");
CatalogItem catalogItem = CatalogItem.newBuilder().build();
CatalogItem response = catalogServiceClient.createCatalogItem(parent, catalogItem);
}
Note: close() needs to be called on the CatalogServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
- A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
- A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
- A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of CatalogServiceSettings to create(). For example:
To customize credentials:
// 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
CatalogServiceSettings catalogServiceSettings =
CatalogServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
CatalogServiceClient catalogServiceClient = CatalogServiceClient.create(catalogServiceSettings);
To customize the endpoint:
// 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
CatalogServiceSettings catalogServiceSettings =
CatalogServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
CatalogServiceClient catalogServiceClient = CatalogServiceClient.create(catalogServiceSettings);
To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:
// 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
CatalogServiceSettings catalogServiceSettings =
CatalogServiceSettings.newHttpJsonBuilder().build();
CatalogServiceClient catalogServiceClient = CatalogServiceClient.create(catalogServiceSettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
CatalogServiceClient.ListCatalogItemsFixedSizeCollection
CatalogServiceClient.ListCatalogItemsPage
CatalogServiceClient.ListCatalogItemsPagedResponse
CatalogServiceGrpc
Service for ingesting catalog information of the customer's website.
CatalogServiceGrpc.CatalogServiceBlockingStub
Service for ingesting catalog information of the customer's website.
CatalogServiceGrpc.CatalogServiceFutureStub
Service for ingesting catalog information of the customer's website.
CatalogServiceGrpc.CatalogServiceImplBase
Service for ingesting catalog information of the customer's website.
CatalogServiceGrpc.CatalogServiceStub
Service for ingesting catalog information of the customer's website.
CatalogServiceOuterClass
CatalogServiceSettings
Settings class to configure an instance of CatalogServiceClient.
The default instance has everything set to sensible defaults:
- The default service address (recommendationengine.googleapis.com) and default port (443) are used.
- Credentials are acquired automatically through Application Default Credentials.
- Retries are configured for idempotent methods but not for non-idempotent methods.
The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.
For example, to set the total timeout of createCatalogItem to 30 seconds:
// 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
CatalogServiceSettings.Builder catalogServiceSettingsBuilder =
CatalogServiceSettings.newBuilder();
catalogServiceSettingsBuilder
.createCatalogItemSettings()
.setRetrySettings(
catalogServiceSettingsBuilder.createCatalogItemSettings().getRetrySettings().toBuilder()
.setTotalTimeout(Duration.ofSeconds(30))
.build());
CatalogServiceSettings catalogServiceSettings = catalogServiceSettingsBuilder.build();
CatalogServiceSettings.Builder
Builder for CatalogServiceSettings.
CollectUserEventRequest
Request message for CollectUserEvent method.
Protobuf type google.cloud.recommendationengine.v1beta1.CollectUserEventRequest
CollectUserEventRequest.Builder
Request message for CollectUserEvent method.
Protobuf type google.cloud.recommendationengine.v1beta1.CollectUserEventRequest
Common
CreateCatalogItemRequest
Request message for CreateCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.CreateCatalogItemRequest
CreateCatalogItemRequest.Builder
Request message for CreateCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.CreateCatalogItemRequest
CreatePredictionApiKeyRegistrationRequest
Request message for the CreatePredictionApiKeyRegistration
method.
Protobuf type
google.cloud.recommendationengine.v1beta1.CreatePredictionApiKeyRegistrationRequest
CreatePredictionApiKeyRegistrationRequest.Builder
Request message for the CreatePredictionApiKeyRegistration
method.
Protobuf type
google.cloud.recommendationengine.v1beta1.CreatePredictionApiKeyRegistrationRequest
DeleteCatalogItemRequest
Request message for DeleteCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.DeleteCatalogItemRequest
DeleteCatalogItemRequest.Builder
Request message for DeleteCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.DeleteCatalogItemRequest
DeletePredictionApiKeyRegistrationRequest
Request message for DeletePredictionApiKeyRegistration
method.
Protobuf type
google.cloud.recommendationengine.v1beta1.DeletePredictionApiKeyRegistrationRequest
DeletePredictionApiKeyRegistrationRequest.Builder
Request message for DeletePredictionApiKeyRegistration
method.
Protobuf type
google.cloud.recommendationengine.v1beta1.DeletePredictionApiKeyRegistrationRequest
EventDetail
User event details shared by all recommendation types.
Protobuf type google.cloud.recommendationengine.v1beta1.EventDetail
EventDetail.Builder
User event details shared by all recommendation types.
Protobuf type google.cloud.recommendationengine.v1beta1.EventDetail
EventStoreName
EventStoreName.Builder
Builder for projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}.
FeatureMap
FeatureMap represents extra features that customers want to include in the recommendation model for catalogs/user events as categorical/numerical features.
Protobuf type google.cloud.recommendationengine.v1beta1.FeatureMap
FeatureMap.Builder
FeatureMap represents extra features that customers want to include in the recommendation model for catalogs/user events as categorical/numerical features.
Protobuf type google.cloud.recommendationengine.v1beta1.FeatureMap
FeatureMap.FloatList
A list of float features.
Protobuf type google.cloud.recommendationengine.v1beta1.FeatureMap.FloatList
FeatureMap.FloatList.Builder
A list of float features.
Protobuf type google.cloud.recommendationengine.v1beta1.FeatureMap.FloatList
FeatureMap.StringList
A list of string features.
Protobuf type google.cloud.recommendationengine.v1beta1.FeatureMap.StringList
FeatureMap.StringList.Builder
A list of string features.
Protobuf type google.cloud.recommendationengine.v1beta1.FeatureMap.StringList
GcsSource
Google Cloud Storage location for input content. format.
Protobuf type google.cloud.recommendationengine.v1beta1.GcsSource
GcsSource.Builder
Google Cloud Storage location for input content. format.
Protobuf type google.cloud.recommendationengine.v1beta1.GcsSource
GetCatalogItemRequest
Request message for GetCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.GetCatalogItemRequest
GetCatalogItemRequest.Builder
Request message for GetCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.GetCatalogItemRequest
Image
Catalog item thumbnail/detail image.
Protobuf type google.cloud.recommendationengine.v1beta1.Image
Image.Builder
Catalog item thumbnail/detail image.
Protobuf type google.cloud.recommendationengine.v1beta1.Image
Import
ImportCatalogItemsRequest
Request message for Import methods.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportCatalogItemsRequest
ImportCatalogItemsRequest.Builder
Request message for Import methods.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportCatalogItemsRequest
ImportCatalogItemsResponse
Response of the ImportCatalogItemsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportCatalogItemsResponse
ImportCatalogItemsResponse.Builder
Response of the ImportCatalogItemsRequest. If the long running operation is done, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportCatalogItemsResponse
ImportErrorsConfig
Configuration of destination for Import related errors.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportErrorsConfig
ImportErrorsConfig.Builder
Configuration of destination for Import related errors.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportErrorsConfig
ImportMetadata
Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportMetadata
ImportMetadata.Builder
Metadata related to the progress of the Import operation. This will be returned by the google.longrunning.Operation.metadata field.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportMetadata
ImportUserEventsRequest
Request message for the ImportUserEvents request.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportUserEventsRequest
ImportUserEventsRequest.Builder
Request message for the ImportUserEvents request.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportUserEventsRequest
ImportUserEventsResponse
Response of the ImportUserEventsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportUserEventsResponse
ImportUserEventsResponse.Builder
Response of the ImportUserEventsRequest. If the long running operation was successful, then this message is returned by the google.longrunning.Operations.response field if the operation was successful.
Protobuf type google.cloud.recommendationengine.v1beta1.ImportUserEventsResponse
InputConfig
The input config source.
Protobuf type google.cloud.recommendationengine.v1beta1.InputConfig
InputConfig.Builder
The input config source.
Protobuf type google.cloud.recommendationengine.v1beta1.InputConfig
ListCatalogItemsRequest
Request message for ListCatalogItems method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListCatalogItemsRequest
ListCatalogItemsRequest.Builder
Request message for ListCatalogItems method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListCatalogItemsRequest
ListCatalogItemsResponse
Response message for ListCatalogItems method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListCatalogItemsResponse
ListCatalogItemsResponse.Builder
Response message for ListCatalogItems method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListCatalogItemsResponse
ListPredictionApiKeyRegistrationsRequest
Request message for the ListPredictionApiKeyRegistrations
.
Protobuf type
google.cloud.recommendationengine.v1beta1.ListPredictionApiKeyRegistrationsRequest
ListPredictionApiKeyRegistrationsRequest.Builder
Request message for the ListPredictionApiKeyRegistrations
.
Protobuf type
google.cloud.recommendationengine.v1beta1.ListPredictionApiKeyRegistrationsRequest
ListPredictionApiKeyRegistrationsResponse
Response message for the ListPredictionApiKeyRegistrations
.
Protobuf type
google.cloud.recommendationengine.v1beta1.ListPredictionApiKeyRegistrationsResponse
ListPredictionApiKeyRegistrationsResponse.Builder
Response message for the ListPredictionApiKeyRegistrations
.
Protobuf type
google.cloud.recommendationengine.v1beta1.ListPredictionApiKeyRegistrationsResponse
ListUserEventsRequest
Request message for ListUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListUserEventsRequest
ListUserEventsRequest.Builder
Request message for ListUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListUserEventsRequest
ListUserEventsResponse
Response message for ListUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListUserEventsResponse
ListUserEventsResponse.Builder
Response message for ListUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.ListUserEventsResponse
PlacementName
PlacementName.Builder
Builder for projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}/placements/{placement}.
PredictRequest
Request message for Predict method.
Protobuf type google.cloud.recommendationengine.v1beta1.PredictRequest
PredictRequest.Builder
Request message for Predict method.
Protobuf type google.cloud.recommendationengine.v1beta1.PredictRequest
PredictResponse
Response message for predict method.
Protobuf type google.cloud.recommendationengine.v1beta1.PredictResponse
PredictResponse.Builder
Response message for predict method.
Protobuf type google.cloud.recommendationengine.v1beta1.PredictResponse
PredictResponse.PredictionResult
PredictionResult represents the recommendation prediction results.
Protobuf type
google.cloud.recommendationengine.v1beta1.PredictResponse.PredictionResult
PredictResponse.PredictionResult.Builder
PredictionResult represents the recommendation prediction results.
Protobuf type
google.cloud.recommendationengine.v1beta1.PredictResponse.PredictionResult
PredictionApiKeyRegistration
Registered Api Key.
Protobuf type google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistration
PredictionApiKeyRegistration.Builder
Registered Api Key.
Protobuf type google.cloud.recommendationengine.v1beta1.PredictionApiKeyRegistration
PredictionApiKeyRegistrationName
PredictionApiKeyRegistrationName.Builder
Builder for projects/{project}/locations/{location}/catalogs/{catalog}/eventStores/{event_store}/predictionApiKeyRegistrations/{prediction_api_key_registration}.
PredictionApiKeyRegistryClient
Service Description: Service for registering API keys for use with the predict
method. If you
use an API key to request predictions, you must first register the API key. Otherwise, your
prediction request is rejected. If you use OAuth to authenticate your predict
method call, you
do not need to register an API key. You can register up to 20 API keys per project.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
// 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 (PredictionApiKeyRegistryClient predictionApiKeyRegistryClient =
PredictionApiKeyRegistryClient.create()) {
EventStoreName parent =
EventStoreName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[EVENT_STORE]");
PredictionApiKeyRegistration predictionApiKeyRegistration =
PredictionApiKeyRegistration.newBuilder().build();
PredictionApiKeyRegistration response =
predictionApiKeyRegistryClient.createPredictionApiKeyRegistration(
parent, predictionApiKeyRegistration);
}
Note: close() needs to be called on the PredictionApiKeyRegistryClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
- A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
- A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
- A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of PredictionApiKeyRegistrySettings to create(). For example:
To customize credentials:
// 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
PredictionApiKeyRegistrySettings predictionApiKeyRegistrySettings =
PredictionApiKeyRegistrySettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
PredictionApiKeyRegistryClient predictionApiKeyRegistryClient =
PredictionApiKeyRegistryClient.create(predictionApiKeyRegistrySettings);
To customize the endpoint:
// 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
PredictionApiKeyRegistrySettings predictionApiKeyRegistrySettings =
PredictionApiKeyRegistrySettings.newBuilder().setEndpoint(myEndpoint).build();
PredictionApiKeyRegistryClient predictionApiKeyRegistryClient =
PredictionApiKeyRegistryClient.create(predictionApiKeyRegistrySettings);
To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:
// 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
PredictionApiKeyRegistrySettings predictionApiKeyRegistrySettings =
PredictionApiKeyRegistrySettings.newHttpJsonBuilder().build();
PredictionApiKeyRegistryClient predictionApiKeyRegistryClient =
PredictionApiKeyRegistryClient.create(predictionApiKeyRegistrySettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
PredictionApiKeyRegistryClient.ListPredictionApiKeyRegistrationsFixedSizeCollection
PredictionApiKeyRegistryClient.ListPredictionApiKeyRegistrationsPage
PredictionApiKeyRegistryClient.ListPredictionApiKeyRegistrationsPagedResponse
PredictionApiKeyRegistryGrpc
Service for registering API keys for use with the predict
method. If you
use an API key to request predictions, you must first register the API key.
Otherwise, your prediction request is rejected. If you use OAuth to
authenticate your predict
method call, you do not need to register an API
key. You can register up to 20 API keys per project.
PredictionApiKeyRegistryGrpc.PredictionApiKeyRegistryBlockingStub
Service for registering API keys for use with the predict
method. If you
use an API key to request predictions, you must first register the API key.
Otherwise, your prediction request is rejected. If you use OAuth to
authenticate your predict
method call, you do not need to register an API
key. You can register up to 20 API keys per project.
PredictionApiKeyRegistryGrpc.PredictionApiKeyRegistryFutureStub
Service for registering API keys for use with the predict
method. If you
use an API key to request predictions, you must first register the API key.
Otherwise, your prediction request is rejected. If you use OAuth to
authenticate your predict
method call, you do not need to register an API
key. You can register up to 20 API keys per project.
PredictionApiKeyRegistryGrpc.PredictionApiKeyRegistryImplBase
Service for registering API keys for use with the predict
method. If you
use an API key to request predictions, you must first register the API key.
Otherwise, your prediction request is rejected. If you use OAuth to
authenticate your predict
method call, you do not need to register an API
key. You can register up to 20 API keys per project.
PredictionApiKeyRegistryGrpc.PredictionApiKeyRegistryStub
Service for registering API keys for use with the predict
method. If you
use an API key to request predictions, you must first register the API key.
Otherwise, your prediction request is rejected. If you use OAuth to
authenticate your predict
method call, you do not need to register an API
key. You can register up to 20 API keys per project.
PredictionApiKeyRegistrySettings
Settings class to configure an instance of PredictionApiKeyRegistryClient.
The default instance has everything set to sensible defaults:
- The default service address (recommendationengine.googleapis.com) and default port (443) are used.
- Credentials are acquired automatically through Application Default Credentials.
- Retries are configured for idempotent methods but not for non-idempotent methods.
The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.
For example, to set the total timeout of createPredictionApiKeyRegistration to 30 seconds:
// 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
PredictionApiKeyRegistrySettings.Builder predictionApiKeyRegistrySettingsBuilder =
PredictionApiKeyRegistrySettings.newBuilder();
predictionApiKeyRegistrySettingsBuilder
.createPredictionApiKeyRegistrationSettings()
.setRetrySettings(
predictionApiKeyRegistrySettingsBuilder
.createPredictionApiKeyRegistrationSettings()
.getRetrySettings()
.toBuilder()
.setTotalTimeout(Duration.ofSeconds(30))
.build());
PredictionApiKeyRegistrySettings predictionApiKeyRegistrySettings =
predictionApiKeyRegistrySettingsBuilder.build();
PredictionApiKeyRegistrySettings.Builder
Builder for PredictionApiKeyRegistrySettings.
PredictionApikeyRegistryService
PredictionServiceClient
Service Description: Service for making recommendation prediction.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
// 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 (PredictionServiceClient predictionServiceClient = PredictionServiceClient.create()) {
PlacementName name =
PlacementName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[EVENT_STORE]", "[PLACEMENT]");
UserEvent userEvent = UserEvent.newBuilder().build();
for (Map.Entry<String, Value> element :
predictionServiceClient.predict(name, userEvent).iterateAll()) {
// doThingsWith(element);
}
}
Note: close() needs to be called on the PredictionServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
- A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
- A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
- A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of PredictionServiceSettings to create(). For example:
To customize credentials:
// 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
PredictionServiceSettings predictionServiceSettings =
PredictionServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
PredictionServiceClient predictionServiceClient =
PredictionServiceClient.create(predictionServiceSettings);
To customize the endpoint:
// 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
PredictionServiceSettings predictionServiceSettings =
PredictionServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
PredictionServiceClient predictionServiceClient =
PredictionServiceClient.create(predictionServiceSettings);
To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:
// 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
PredictionServiceSettings predictionServiceSettings =
PredictionServiceSettings.newHttpJsonBuilder().build();
PredictionServiceClient predictionServiceClient =
PredictionServiceClient.create(predictionServiceSettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
PredictionServiceClient.PredictFixedSizeCollection
PredictionServiceClient.PredictPage
PredictionServiceClient.PredictPagedResponse
PredictionServiceGrpc
Service for making recommendation prediction.
PredictionServiceGrpc.PredictionServiceBlockingStub
Service for making recommendation prediction.
PredictionServiceGrpc.PredictionServiceFutureStub
Service for making recommendation prediction.
PredictionServiceGrpc.PredictionServiceImplBase
Service for making recommendation prediction.
PredictionServiceGrpc.PredictionServiceStub
Service for making recommendation prediction.
PredictionServiceOuterClass
PredictionServiceSettings
Settings class to configure an instance of PredictionServiceClient.
The default instance has everything set to sensible defaults:
- The default service address (recommendationengine.googleapis.com) and default port (443) are used.
- Credentials are acquired automatically through Application Default Credentials.
- Retries are configured for idempotent methods but not for non-idempotent methods.
The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.
For example, to set the total timeout of predict to 30 seconds:
// 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
PredictionServiceSettings.Builder predictionServiceSettingsBuilder =
PredictionServiceSettings.newBuilder();
predictionServiceSettingsBuilder
.predictSettings()
.setRetrySettings(
predictionServiceSettingsBuilder.predictSettings().getRetrySettings().toBuilder()
.setTotalTimeout(Duration.ofSeconds(30))
.build());
PredictionServiceSettings predictionServiceSettings = predictionServiceSettingsBuilder.build();
PredictionServiceSettings.Builder
Builder for PredictionServiceSettings.
ProductCatalogItem
ProductCatalogItem captures item metadata specific to retail products.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductCatalogItem
ProductCatalogItem.Builder
ProductCatalogItem captures item metadata specific to retail products.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductCatalogItem
ProductCatalogItem.ExactPrice
Exact product price.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductCatalogItem.ExactPrice
ProductCatalogItem.ExactPrice.Builder
Exact product price.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductCatalogItem.ExactPrice
ProductCatalogItem.PriceRange
Product price range when there are a range of prices for different variations of the same product.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductCatalogItem.PriceRange
ProductCatalogItem.PriceRange.Builder
Product price range when there are a range of prices for different variations of the same product.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductCatalogItem.PriceRange
ProductDetail
Detailed product information associated with a user event.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductDetail
ProductDetail.Builder
Detailed product information associated with a user event.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductDetail
ProductEventDetail
ProductEventDetail captures user event information specific to retail products.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductEventDetail
ProductEventDetail.Builder
ProductEventDetail captures user event information specific to retail products.
Protobuf type google.cloud.recommendationengine.v1beta1.ProductEventDetail
PurchaseTransaction
A transaction represents the entire purchase transaction.
Protobuf type google.cloud.recommendationengine.v1beta1.PurchaseTransaction
PurchaseTransaction.Builder
A transaction represents the entire purchase transaction.
Protobuf type google.cloud.recommendationengine.v1beta1.PurchaseTransaction
PurgeUserEventsMetadata
Metadata related to the progress of the PurgeUserEvents operation. This will be returned by the google.longrunning.Operation.metadata field.
Protobuf type google.cloud.recommendationengine.v1beta1.PurgeUserEventsMetadata
PurgeUserEventsMetadata.Builder
Metadata related to the progress of the PurgeUserEvents operation. This will be returned by the google.longrunning.Operation.metadata field.
Protobuf type google.cloud.recommendationengine.v1beta1.PurgeUserEventsMetadata
PurgeUserEventsRequest
Request message for PurgeUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.PurgeUserEventsRequest
PurgeUserEventsRequest.Builder
Request message for PurgeUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.PurgeUserEventsRequest
PurgeUserEventsResponse
Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.
Protobuf type google.cloud.recommendationengine.v1beta1.PurgeUserEventsResponse
PurgeUserEventsResponse.Builder
Response of the PurgeUserEventsRequest. If the long running operation is successfully done, then this message is returned by the google.longrunning.Operations.response field.
Protobuf type google.cloud.recommendationengine.v1beta1.PurgeUserEventsResponse
RecommendationengineResources
UpdateCatalogItemRequest
Request message for UpdateCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.UpdateCatalogItemRequest
UpdateCatalogItemRequest.Builder
Request message for UpdateCatalogItem method.
Protobuf type google.cloud.recommendationengine.v1beta1.UpdateCatalogItemRequest
UserEvent
UserEvent captures all metadata information recommendation engine needs to know about how end users interact with customers' website.
Protobuf type google.cloud.recommendationengine.v1beta1.UserEvent
UserEvent.Builder
UserEvent captures all metadata information recommendation engine needs to know about how end users interact with customers' website.
Protobuf type google.cloud.recommendationengine.v1beta1.UserEvent
UserEventImportSummary
A summary of import result. The UserEventImportSummary summarizes the import status for user events.
Protobuf type google.cloud.recommendationengine.v1beta1.UserEventImportSummary
UserEventImportSummary.Builder
A summary of import result. The UserEventImportSummary summarizes the import status for user events.
Protobuf type google.cloud.recommendationengine.v1beta1.UserEventImportSummary
UserEventInlineSource
The inline source for the input config for ImportUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.UserEventInlineSource
UserEventInlineSource.Builder
The inline source for the input config for ImportUserEvents method.
Protobuf type google.cloud.recommendationengine.v1beta1.UserEventInlineSource
UserEventOuterClass
UserEventServiceClient
Service Description: Service for ingesting end user actions on the customer website.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
// 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()) {
EventStoreName parent =
EventStoreName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[EVENT_STORE]");
UserEvent userEvent = UserEvent.newBuilder().build();
UserEvent response = userEventServiceClient.writeUserEvent(parent, userEvent);
}
Note: close() needs to be called on the UserEventServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
- A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
- A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
- A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of UserEventServiceSettings to create(). For example:
To customize credentials:
// 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
UserEventServiceSettings userEventServiceSettings =
UserEventServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
UserEventServiceClient userEventServiceClient =
UserEventServiceClient.create(userEventServiceSettings);
To customize the endpoint:
// 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
UserEventServiceSettings userEventServiceSettings =
UserEventServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
UserEventServiceClient userEventServiceClient =
UserEventServiceClient.create(userEventServiceSettings);
To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:
// 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
UserEventServiceSettings userEventServiceSettings =
UserEventServiceSettings.newHttpJsonBuilder().build();
UserEventServiceClient userEventServiceClient =
UserEventServiceClient.create(userEventServiceSettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
UserEventServiceClient.ListUserEventsFixedSizeCollection
UserEventServiceClient.ListUserEventsPage
UserEventServiceClient.ListUserEventsPagedResponse
UserEventServiceGrpc
Service for ingesting end user actions on the customer website.
UserEventServiceGrpc.UserEventServiceBlockingStub
Service for ingesting end user actions on the customer website.
UserEventServiceGrpc.UserEventServiceFutureStub
Service for ingesting end user actions on the customer website.
UserEventServiceGrpc.UserEventServiceImplBase
Service for ingesting end user actions on the customer website.
UserEventServiceGrpc.UserEventServiceStub
Service for ingesting end user actions on the customer website.
UserEventServiceOuterClass
UserEventServiceSettings
Settings class to configure an instance of UserEventServiceClient.
The default instance has everything set to sensible defaults:
- The default service address (recommendationengine.googleapis.com) and default port (443) are used.
- Credentials are acquired automatically through Application Default Credentials.
- Retries are configured for idempotent methods but not for non-idempotent methods.
The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.
For example, to set the total timeout of writeUserEvent to 30 seconds:
// 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
UserEventServiceSettings.Builder userEventServiceSettingsBuilder =
UserEventServiceSettings.newBuilder();
userEventServiceSettingsBuilder
.writeUserEventSettings()
.setRetrySettings(
userEventServiceSettingsBuilder.writeUserEventSettings().getRetrySettings().toBuilder()
.setTotalTimeout(Duration.ofSeconds(30))
.build());
UserEventServiceSettings userEventServiceSettings = userEventServiceSettingsBuilder.build();
UserEventServiceSettings.Builder
Builder for UserEventServiceSettings.
UserInfo
Information of end users.
Protobuf type google.cloud.recommendationengine.v1beta1.UserInfo
UserInfo.Builder
Information of end users.
Protobuf type google.cloud.recommendationengine.v1beta1.UserInfo
WriteUserEventRequest
Request message for WriteUserEvent method.
Protobuf type google.cloud.recommendationengine.v1beta1.WriteUserEventRequest
WriteUserEventRequest.Builder
Request message for WriteUserEvent method.
Protobuf type google.cloud.recommendationengine.v1beta1.WriteUserEventRequest
Interfaces
CatalogInlineSourceOrBuilder
CatalogItem.CategoryHierarchyOrBuilder
CatalogItemOrBuilder
CollectUserEventRequestOrBuilder
CreateCatalogItemRequestOrBuilder
CreatePredictionApiKeyRegistrationRequestOrBuilder
DeleteCatalogItemRequestOrBuilder
DeletePredictionApiKeyRegistrationRequestOrBuilder
EventDetailOrBuilder
FeatureMap.FloatListOrBuilder
FeatureMap.StringListOrBuilder
FeatureMapOrBuilder
GcsSourceOrBuilder
GetCatalogItemRequestOrBuilder
ImageOrBuilder
ImportCatalogItemsRequestOrBuilder
ImportCatalogItemsResponseOrBuilder
ImportErrorsConfigOrBuilder
ImportMetadataOrBuilder
ImportUserEventsRequestOrBuilder
ImportUserEventsResponseOrBuilder
InputConfigOrBuilder
ListCatalogItemsRequestOrBuilder
ListCatalogItemsResponseOrBuilder
ListPredictionApiKeyRegistrationsRequestOrBuilder
ListPredictionApiKeyRegistrationsResponseOrBuilder
ListUserEventsRequestOrBuilder
ListUserEventsResponseOrBuilder
PredictRequestOrBuilder
PredictResponse.PredictionResultOrBuilder
PredictResponseOrBuilder
PredictionApiKeyRegistrationOrBuilder
ProductCatalogItem.ExactPriceOrBuilder
ProductCatalogItem.PriceRangeOrBuilder
ProductCatalogItemOrBuilder
ProductDetailOrBuilder
ProductEventDetailOrBuilder
PurchaseTransactionOrBuilder
PurgeUserEventsMetadataOrBuilder
PurgeUserEventsRequestOrBuilder
PurgeUserEventsResponseOrBuilder
UpdateCatalogItemRequestOrBuilder
UserEventImportSummaryOrBuilder
UserEventInlineSourceOrBuilder
UserEventOrBuilder
UserInfoOrBuilder
WriteUserEventRequestOrBuilder
Enums
CatalogItem.RecommendationTypeCase
ImportErrorsConfig.DestinationCase
InputConfig.SourceCase
ProductCatalogItem.PriceCase
ProductCatalogItem.StockState
Item stock state. If this field is unspecified, the item is assumed to be in stock.
Protobuf enum google.cloud.recommendationengine.v1beta1.ProductCatalogItem.StockState
UserEvent.EventSource
User event source.
Protobuf enum google.cloud.recommendationengine.v1beta1.UserEvent.EventSource