com.google.cloud.recommendationengine.v1beta1
A client to Recommendations AI
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);
}