google-cloud-retail-v2 0.10.0 → 0.11.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (45) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/retail/v2/catalog_pb.rb +55 -0
  3. data/lib/google/cloud/retail/v2/catalog_service/client.rb +718 -0
  4. data/lib/google/cloud/retail/v2/catalog_service/paths.rb +38 -0
  5. data/lib/google/cloud/retail/v2/catalog_service_pb.rb +34 -0
  6. data/lib/google/cloud/retail/v2/catalog_service_services_pb.rb +38 -0
  7. data/lib/google/cloud/retail/v2/common_pb.rb +86 -0
  8. data/lib/google/cloud/retail/v2/completion_service/client.rb +4 -3
  9. data/lib/google/cloud/retail/v2/control_pb.rb +33 -0
  10. data/lib/google/cloud/retail/v2/control_service/client.rb +807 -0
  11. data/lib/google/cloud/retail/v2/control_service/credentials.rb +51 -0
  12. data/lib/google/cloud/retail/v2/control_service/paths.rb +73 -0
  13. data/lib/google/cloud/retail/v2/control_service.rb +49 -0
  14. data/lib/google/cloud/retail/v2/control_service_pb.rb +57 -0
  15. data/lib/google/cloud/retail/v2/control_service_services_pb.rb +65 -0
  16. data/lib/google/cloud/retail/v2/prediction_service_pb.rb +0 -1
  17. data/lib/google/cloud/retail/v2/product_pb.rb +1 -0
  18. data/lib/google/cloud/retail/v2/product_service/client.rb +42 -12
  19. data/lib/google/cloud/retail/v2/product_service_services_pb.rb +35 -0
  20. data/lib/google/cloud/retail/v2/search_service/client.rb +12 -1
  21. data/lib/google/cloud/retail/v2/search_service_pb.rb +1 -0
  22. data/lib/google/cloud/retail/v2/serving_config_pb.rb +44 -0
  23. data/lib/google/cloud/retail/v2/serving_config_service/client.rb +998 -0
  24. data/lib/google/cloud/retail/v2/serving_config_service/credentials.rb +51 -0
  25. data/lib/google/cloud/retail/v2/serving_config_service/paths.rb +73 -0
  26. data/lib/google/cloud/retail/v2/serving_config_service.rb +49 -0
  27. data/lib/google/cloud/retail/v2/serving_config_service_pb.rb +66 -0
  28. data/lib/google/cloud/retail/v2/serving_config_service_services_pb.rb +74 -0
  29. data/lib/google/cloud/retail/v2/user_event_service/client.rb +2 -2
  30. data/lib/google/cloud/retail/v2/user_event_service_pb.rb +0 -1
  31. data/lib/google/cloud/retail/v2/user_event_service_services_pb.rb +2 -2
  32. data/lib/google/cloud/retail/v2/version.rb +1 -1
  33. data/lib/google/cloud/retail/v2.rb +2 -0
  34. data/proto_docs/google/cloud/retail/v2/catalog.rb +233 -0
  35. data/proto_docs/google/cloud/retail/v2/catalog_service.rb +133 -0
  36. data/proto_docs/google/cloud/retail/v2/common.rb +314 -4
  37. data/proto_docs/google/cloud/retail/v2/completion_service.rb +2 -1
  38. data/proto_docs/google/cloud/retail/v2/control.rb +76 -0
  39. data/proto_docs/google/cloud/retail/v2/control_service.rb +122 -0
  40. data/proto_docs/google/cloud/retail/v2/import_config.rb +20 -35
  41. data/proto_docs/google/cloud/retail/v2/product.rb +7 -1
  42. data/proto_docs/google/cloud/retail/v2/search_service.rb +29 -2
  43. data/proto_docs/google/cloud/retail/v2/serving_config.rb +238 -0
  44. data/proto_docs/google/cloud/retail/v2/serving_config_service.rb +143 -0
  45. metadata +20 -2
@@ -0,0 +1,51 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "googleauth"
20
+
21
+ module Google
22
+ module Cloud
23
+ module Retail
24
+ module V2
25
+ module ControlService
26
+ # Credentials for the ControlService API.
27
+ class Credentials < ::Google::Auth::Credentials
28
+ self.scope = [
29
+ "https://www.googleapis.com/auth/cloud-platform"
30
+ ]
31
+ self.env_vars = [
32
+ "RETAIL_CREDENTIALS",
33
+ "RETAIL_KEYFILE",
34
+ "GOOGLE_CLOUD_CREDENTIALS",
35
+ "GOOGLE_CLOUD_KEYFILE",
36
+ "GCLOUD_KEYFILE",
37
+ "RETAIL_CREDENTIALS_JSON",
38
+ "RETAIL_KEYFILE_JSON",
39
+ "GOOGLE_CLOUD_CREDENTIALS_JSON",
40
+ "GOOGLE_CLOUD_KEYFILE_JSON",
41
+ "GCLOUD_KEYFILE_JSON"
42
+ ]
43
+ self.paths = [
44
+ "~/.config/google_cloud/application_default_credentials.json"
45
+ ]
46
+ end
47
+ end
48
+ end
49
+ end
50
+ end
51
+ end
@@ -0,0 +1,73 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module Retail
23
+ module V2
24
+ module ControlService
25
+ # Path helper methods for the ControlService API.
26
+ module Paths
27
+ ##
28
+ # Create a fully-qualified Catalog resource string.
29
+ #
30
+ # The resource will be in the following format:
31
+ #
32
+ # `projects/{project}/locations/{location}/catalogs/{catalog}`
33
+ #
34
+ # @param project [String]
35
+ # @param location [String]
36
+ # @param catalog [String]
37
+ #
38
+ # @return [::String]
39
+ def catalog_path project:, location:, catalog:
40
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
41
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
42
+
43
+ "projects/#{project}/locations/#{location}/catalogs/#{catalog}"
44
+ end
45
+
46
+ ##
47
+ # Create a fully-qualified Control resource string.
48
+ #
49
+ # The resource will be in the following format:
50
+ #
51
+ # `projects/{project}/locations/{location}/catalogs/{catalog}/controls/{control}`
52
+ #
53
+ # @param project [String]
54
+ # @param location [String]
55
+ # @param catalog [String]
56
+ # @param control [String]
57
+ #
58
+ # @return [::String]
59
+ def control_path project:, location:, catalog:, control:
60
+ raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
61
+ raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
62
+ raise ::ArgumentError, "catalog cannot contain /" if catalog.to_s.include? "/"
63
+
64
+ "projects/#{project}/locations/#{location}/catalogs/#{catalog}/controls/#{control}"
65
+ end
66
+
67
+ extend self
68
+ end
69
+ end
70
+ end
71
+ end
72
+ end
73
+ end
@@ -0,0 +1,49 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/common"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/retail/v2/version"
24
+
25
+ require "google/cloud/retail/v2/control_service/credentials"
26
+ require "google/cloud/retail/v2/control_service/paths"
27
+ require "google/cloud/retail/v2/control_service/client"
28
+
29
+ module Google
30
+ module Cloud
31
+ module Retail
32
+ module V2
33
+ ##
34
+ # Service for modifying Control.
35
+ #
36
+ # To load this service and instantiate a client:
37
+ #
38
+ # require "google/cloud/retail/v2/control_service"
39
+ # client = ::Google::Cloud::Retail::V2::ControlService::Client.new
40
+ #
41
+ module ControlService
42
+ end
43
+ end
44
+ end
45
+ end
46
+ end
47
+
48
+ helper_path = ::File.join __dir__, "control_service", "helpers.rb"
49
+ require "google/cloud/retail/v2/control_service/helpers" if ::File.file? helper_path
@@ -0,0 +1,57 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # source: google/cloud/retail/v2/control_service.proto
3
+
4
+ require 'google/protobuf'
5
+
6
+ require 'google/api/annotations_pb'
7
+ require 'google/api/client_pb'
8
+ require 'google/api/field_behavior_pb'
9
+ require 'google/api/resource_pb'
10
+ require 'google/cloud/retail/v2/control_pb'
11
+ require 'google/protobuf/empty_pb'
12
+ require 'google/protobuf/field_mask_pb'
13
+
14
+ Google::Protobuf::DescriptorPool.generated_pool.build do
15
+ add_file("google/cloud/retail/v2/control_service.proto", :syntax => :proto3) do
16
+ add_message "google.cloud.retail.v2.CreateControlRequest" do
17
+ optional :parent, :string, 1
18
+ optional :control, :message, 2, "google.cloud.retail.v2.Control"
19
+ optional :control_id, :string, 3
20
+ end
21
+ add_message "google.cloud.retail.v2.UpdateControlRequest" do
22
+ optional :control, :message, 1, "google.cloud.retail.v2.Control"
23
+ optional :update_mask, :message, 2, "google.protobuf.FieldMask"
24
+ end
25
+ add_message "google.cloud.retail.v2.DeleteControlRequest" do
26
+ optional :name, :string, 1
27
+ end
28
+ add_message "google.cloud.retail.v2.GetControlRequest" do
29
+ optional :name, :string, 1
30
+ end
31
+ add_message "google.cloud.retail.v2.ListControlsRequest" do
32
+ optional :parent, :string, 1
33
+ optional :page_size, :int32, 2
34
+ optional :page_token, :string, 3
35
+ optional :filter, :string, 4
36
+ end
37
+ add_message "google.cloud.retail.v2.ListControlsResponse" do
38
+ repeated :controls, :message, 1, "google.cloud.retail.v2.Control"
39
+ optional :next_page_token, :string, 2
40
+ end
41
+ end
42
+ end
43
+
44
+ module Google
45
+ module Cloud
46
+ module Retail
47
+ module V2
48
+ CreateControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.CreateControlRequest").msgclass
49
+ UpdateControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.UpdateControlRequest").msgclass
50
+ DeleteControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.DeleteControlRequest").msgclass
51
+ GetControlRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.GetControlRequest").msgclass
52
+ ListControlsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListControlsRequest").msgclass
53
+ ListControlsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ListControlsResponse").msgclass
54
+ end
55
+ end
56
+ end
57
+ end
@@ -0,0 +1,65 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # Source: google/cloud/retail/v2/control_service.proto for package 'Google.Cloud.Retail.V2'
3
+ # Original file comments:
4
+ # Copyright 2021 Google LLC
5
+ #
6
+ # Licensed under the Apache License, Version 2.0 (the "License");
7
+ # you may not use this file except in compliance with the License.
8
+ # You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing, software
13
+ # distributed under the License is distributed on an "AS IS" BASIS,
14
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ # See the License for the specific language governing permissions and
16
+ # limitations under the License.
17
+ #
18
+
19
+ require 'grpc'
20
+ require 'google/cloud/retail/v2/control_service_pb'
21
+
22
+ module Google
23
+ module Cloud
24
+ module Retail
25
+ module V2
26
+ module ControlService
27
+ # Service for modifying Control.
28
+ class Service
29
+
30
+ include ::GRPC::GenericService
31
+
32
+ self.marshal_class_method = :encode
33
+ self.unmarshal_class_method = :decode
34
+ self.service_name = 'google.cloud.retail.v2.ControlService'
35
+
36
+ # Creates a Control.
37
+ #
38
+ # If the [Control][google.cloud.retail.v2.Control] to create already exists,
39
+ # an ALREADY_EXISTS error is returned.
40
+ rpc :CreateControl, ::Google::Cloud::Retail::V2::CreateControlRequest, ::Google::Cloud::Retail::V2::Control
41
+ # Deletes a Control.
42
+ #
43
+ # If the [Control][google.cloud.retail.v2.Control] to delete does not exist,
44
+ # a NOT_FOUND error is returned.
45
+ rpc :DeleteControl, ::Google::Cloud::Retail::V2::DeleteControlRequest, ::Google::Protobuf::Empty
46
+ # Updates a Control.
47
+ #
48
+ # [Control][google.cloud.retail.v2.Control] cannot be set to a different
49
+ # oneof field, if so an INVALID_ARGUMENT is returned. If the
50
+ # [Control][google.cloud.retail.v2.Control] to update does not exist, a
51
+ # NOT_FOUND error is returned.
52
+ rpc :UpdateControl, ::Google::Cloud::Retail::V2::UpdateControlRequest, ::Google::Cloud::Retail::V2::Control
53
+ # Gets a Control.
54
+ rpc :GetControl, ::Google::Cloud::Retail::V2::GetControlRequest, ::Google::Cloud::Retail::V2::Control
55
+ # Lists all Controls by their parent
56
+ # [Catalog][google.cloud.retail.v2.Catalog].
57
+ rpc :ListControls, ::Google::Cloud::Retail::V2::ListControlsRequest, ::Google::Cloud::Retail::V2::ListControlsResponse
58
+ end
59
+
60
+ Stub = Service.rpc_stub_class
61
+ end
62
+ end
63
+ end
64
+ end
65
+ end
@@ -6,7 +6,6 @@ require 'google/protobuf'
6
6
  require 'google/api/annotations_pb'
7
7
  require 'google/api/client_pb'
8
8
  require 'google/api/field_behavior_pb'
9
- require 'google/api/resource_pb'
10
9
  require 'google/cloud/retail/v2/user_event_pb'
11
10
  require 'google/protobuf/struct_pb'
12
11
 
@@ -46,6 +46,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
46
46
  optional :publish_time, :message, 33, "google.protobuf.Timestamp"
47
47
  optional :retrievable_fields, :message, 30, "google.protobuf.FieldMask"
48
48
  repeated :variants, :message, 31, "google.cloud.retail.v2.Product"
49
+ repeated :local_inventories, :message, 35, "google.cloud.retail.v2.LocalInventory"
49
50
  oneof :expiration do
50
51
  optional :expire_time, :message, 16, "google.protobuf.Timestamp"
51
52
  optional :ttl, :message, 17, "google.protobuf.Duration"
@@ -782,29 +782,24 @@ module Google
782
782
  # @param errors_config [::Google::Cloud::Retail::V2::ImportErrorsConfig, ::Hash]
783
783
  # The desired location of errors incurred during the Import.
784
784
  # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
785
- # Indicates which fields in the provided imported 'products' to update. If
786
- # not set, will by default update all fields.
785
+ # Indicates which fields in the provided imported `products` to update. If
786
+ # not set, all fields are updated.
787
787
  # @param reconciliation_mode [::Google::Cloud::Retail::V2::ImportProductsRequest::ReconciliationMode]
788
788
  # The mode of reconciliation between existing products and the products to be
789
789
  # imported. Defaults to
790
790
  # {::Google::Cloud::Retail::V2::ImportProductsRequest::ReconciliationMode::INCREMENTAL ReconciliationMode.INCREMENTAL}.
791
791
  # @param notification_pubsub_topic [::String]
792
792
  # Full Pub/Sub topic name for receiving notification. If this field is set,
793
- # when the import is finished, a notification will be sent to
794
- # specified Pub/Sub topic. The message data will be JSON string of a
793
+ # when the import is finished, a notification is sent to
794
+ # specified Pub/Sub topic. The message data is JSON string of a
795
795
  # {::Google::Longrunning::Operation Operation}.
796
796
  #
797
797
  # Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
798
798
  # to be within the same project as
799
799
  # {::Google::Cloud::Retail::V2::ImportProductsRequest#parent ImportProductsRequest.parent}.
800
- # Make sure that both
801
- # `cloud-retail-customer-data-access@system.gserviceaccount.com` and
802
- # `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
803
- # have the `pubsub.topics.publish` IAM permission on the topic.
804
- #
805
- # Only supported when
806
- # {::Google::Cloud::Retail::V2::ImportProductsRequest#reconciliation_mode ImportProductsRequest.reconciliation_mode}
807
- # is set to `FULL`.
800
+ # Make sure that `service-<project
801
+ # number>@gcp-sa-retail.iam.gserviceaccount.com` has the
802
+ # `pubsub.topics.publish` IAM permission on the topic.
808
803
  #
809
804
  # @yield [response, operation] Access the result along with the RPC operation
810
805
  # @yieldparam response [::Gapic::Operation]
@@ -920,6 +915,13 @@ module Google
920
915
  # and
921
916
  # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places ProductService.RemoveFulfillmentPlaces}.
922
917
  #
918
+ # The returned [Operation][]s will be obsolete after 1 day, and
919
+ # [GetOperation][] API will return NOT_FOUND afterwards.
920
+ #
921
+ # If conflicting updates are issued, the [Operation][]s associated with the
922
+ # stale updates will not be marked as [done][Operation.done] until being
923
+ # obsolete.
924
+ #
923
925
  # This feature is only available for users who have Retail Search enabled.
924
926
  # Please enable Retail Search on Cloud Console before using this feature.
925
927
  #
@@ -1103,6 +1105,13 @@ module Google
1103
1105
  # or
1104
1106
  # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
1105
1107
  #
1108
+ # The returned [Operation][]s will be obsolete after 1 day, and
1109
+ # [GetOperation][] API will return NOT_FOUND afterwards.
1110
+ #
1111
+ # If conflicting updates are issued, the [Operation][]s associated with the
1112
+ # stale updates will not be marked as [done][Operation.done] until being
1113
+ # obsolete.
1114
+ #
1106
1115
  # This feature is only available for users who have Retail Search enabled.
1107
1116
  # Please enable Retail Search on Cloud Console before using this feature.
1108
1117
  #
@@ -1264,6 +1273,13 @@ module Google
1264
1273
  # or
1265
1274
  # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ProductService.ListProducts}.
1266
1275
  #
1276
+ # The returned [Operation][]s will be obsolete after 1 day, and
1277
+ # [GetOperation][] API will return NOT_FOUND afterwards.
1278
+ #
1279
+ # If conflicting updates are issued, the [Operation][]s associated with the
1280
+ # stale updates will not be marked as [done][Operation.done] until being
1281
+ # obsolete.
1282
+ #
1267
1283
  # This feature is only available for users who have Retail Search enabled.
1268
1284
  # Please enable Retail Search on Cloud Console before using this feature.
1269
1285
  #
@@ -1427,6 +1443,13 @@ module Google
1427
1443
  # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
1428
1444
  # has no effect on local inventories.
1429
1445
  #
1446
+ # The returned [Operation][]s will be obsolete after 1 day, and
1447
+ # [GetOperation][] API will return NOT_FOUND afterwards.
1448
+ #
1449
+ # If conflicting updates are issued, the [Operation][]s associated with the
1450
+ # stale updates will not be marked as [done][Operation.done] until being
1451
+ # obsolete.
1452
+ #
1430
1453
  # This feature is only available for users who have Retail Search enabled.
1431
1454
  # Please enable Retail Search on Cloud Console before using this feature.
1432
1455
  #
@@ -1575,6 +1598,13 @@ module Google
1575
1598
  # {::Google::Cloud::Retail::V2::ProductService::Client#update_product ProductService.UpdateProduct}
1576
1599
  # has no effect on local inventories.
1577
1600
  #
1601
+ # The returned [Operation][]s will be obsolete after 1 day, and
1602
+ # [GetOperation][] API will return NOT_FOUND afterwards.
1603
+ #
1604
+ # If conflicting updates are issued, the [Operation][]s associated with the
1605
+ # stale updates will not be marked as [done][Operation.done] until being
1606
+ # obsolete.
1607
+ #
1578
1608
  # This feature is only available for users who have Retail Search enabled.
1579
1609
  # Please enable Retail Search on Cloud Console before using this feature.
1580
1610
  #
@@ -93,6 +93,13 @@ module Google
93
93
  # and
94
94
  # [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
95
95
  #
96
+ # The returned [Operation][]s will be obsolete after 1 day, and
97
+ # [GetOperation][] API will return NOT_FOUND afterwards.
98
+ #
99
+ # If conflicting updates are issued, the [Operation][]s associated with the
100
+ # stale updates will not be marked as [done][Operation.done] until being
101
+ # obsolete.
102
+ #
96
103
  # This feature is only available for users who have Retail Search enabled.
97
104
  # Please enable Retail Search on Cloud Console before using this feature.
98
105
  rpc :SetInventory, ::Google::Cloud::Retail::V2::SetInventoryRequest, ::Google::Longrunning::Operation
@@ -109,6 +116,13 @@ module Google
109
116
  # or
110
117
  # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
111
118
  #
119
+ # The returned [Operation][]s will be obsolete after 1 day, and
120
+ # [GetOperation][] API will return NOT_FOUND afterwards.
121
+ #
122
+ # If conflicting updates are issued, the [Operation][]s associated with the
123
+ # stale updates will not be marked as [done][Operation.done] until being
124
+ # obsolete.
125
+ #
112
126
  # This feature is only available for users who have Retail Search enabled.
113
127
  # Please enable Retail Search on Cloud Console before using this feature.
114
128
  rpc :AddFulfillmentPlaces, ::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest, ::Google::Longrunning::Operation
@@ -125,6 +139,13 @@ module Google
125
139
  # or
126
140
  # [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
127
141
  #
142
+ # The returned [Operation][]s will be obsolete after 1 day, and
143
+ # [GetOperation][] API will return NOT_FOUND afterwards.
144
+ #
145
+ # If conflicting updates are issued, the [Operation][]s associated with the
146
+ # stale updates will not be marked as [done][Operation.done] until being
147
+ # obsolete.
148
+ #
128
149
  # This feature is only available for users who have Retail Search enabled.
129
150
  # Please enable Retail Search on Cloud Console before using this feature.
130
151
  rpc :RemoveFulfillmentPlaces, ::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest, ::Google::Longrunning::Operation
@@ -148,6 +169,13 @@ module Google
148
169
  # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
149
170
  # has no effect on local inventories.
150
171
  #
172
+ # The returned [Operation][]s will be obsolete after 1 day, and
173
+ # [GetOperation][] API will return NOT_FOUND afterwards.
174
+ #
175
+ # If conflicting updates are issued, the [Operation][]s associated with the
176
+ # stale updates will not be marked as [done][Operation.done] until being
177
+ # obsolete.
178
+ #
151
179
  # This feature is only available for users who have Retail Search enabled.
152
180
  # Please enable Retail Search on Cloud Console before using this feature.
153
181
  rpc :AddLocalInventories, ::Google::Cloud::Retail::V2::AddLocalInventoriesRequest, ::Google::Longrunning::Operation
@@ -169,6 +197,13 @@ module Google
169
197
  # [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
170
198
  # has no effect on local inventories.
171
199
  #
200
+ # The returned [Operation][]s will be obsolete after 1 day, and
201
+ # [GetOperation][] API will return NOT_FOUND afterwards.
202
+ #
203
+ # If conflicting updates are issued, the [Operation][]s associated with the
204
+ # stale updates will not be marked as [done][Operation.done] until being
205
+ # obsolete.
206
+ #
172
207
  # This feature is only available for users who have Retail Search enabled.
173
208
  # Please enable Retail Search on Cloud Console before using this feature.
174
209
  rpc :RemoveLocalInventories, ::Google::Cloud::Retail::V2::RemoveLocalInventoriesRequest, ::Google::Longrunning::Operation
@@ -274,7 +274,9 @@ module Google
274
274
  # Boost specification to boost certain products. See more details at this
275
275
  # [user guide](https://cloud.google.com/retail/docs/boosting).
276
276
  #
277
- # Notice that if both [ServingConfig.boost_control_ids][] and
277
+ # Notice that if both
278
+ # {::Google::Cloud::Retail::V2::ServingConfig#boost_control_ids ServingConfig.boost_control_ids}
279
+ # and
278
280
  # {::Google::Cloud::Retail::V2::SearchRequest#boost_spec SearchRequest.boost_spec}
279
281
  # are set, the boost conditions from both places are evaluated. If a search
280
282
  # request matches multiple boost conditions, the final boost score is equal
@@ -372,6 +374,15 @@ module Google
372
374
  # request triggers both product search and faceted search.
373
375
  # @param personalization_spec [::Google::Cloud::Retail::V2::SearchRequest::PersonalizationSpec, ::Hash]
374
376
  # The specification for personalization.
377
+ #
378
+ # Notice that if both
379
+ # {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}
380
+ # and
381
+ # {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
382
+ # are set.
383
+ # {::Google::Cloud::Retail::V2::SearchRequest#personalization_spec SearchRequest.personalization_spec}
384
+ # will override
385
+ # {::Google::Cloud::Retail::V2::ServingConfig#personalization_spec ServingConfig.personalization_spec}.
375
386
  # @param labels [::Hash{::String => ::String}]
376
387
  # The labels applied to a resource must meet the following requirements:
377
388
  #
@@ -118,6 +118,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
118
118
  optional :matching_variant_count, :int32, 3
119
119
  map :matching_variant_fields, :string, :message, 4, "google.protobuf.FieldMask"
120
120
  map :variant_rollup_values, :string, :message, 5, "google.protobuf.Value"
121
+ repeated :personal_labels, :string, 7
121
122
  end
122
123
  add_message "google.cloud.retail.v2.SearchResponse.Facet" do
123
124
  optional :key, :string, 1
@@ -0,0 +1,44 @@
1
+ # Generated by the protocol buffer compiler. DO NOT EDIT!
2
+ # source: google/cloud/retail/v2/serving_config.proto
3
+
4
+ require 'google/protobuf'
5
+
6
+ require 'google/api/field_behavior_pb'
7
+ require 'google/api/resource_pb'
8
+ require 'google/cloud/retail/v2/common_pb'
9
+ require 'google/cloud/retail/v2/search_service_pb'
10
+
11
+ Google::Protobuf::DescriptorPool.generated_pool.build do
12
+ add_file("google/cloud/retail/v2/serving_config.proto", :syntax => :proto3) do
13
+ add_message "google.cloud.retail.v2.ServingConfig" do
14
+ optional :name, :string, 1
15
+ optional :display_name, :string, 2
16
+ optional :model_id, :string, 3
17
+ optional :price_reranking_level, :string, 4
18
+ repeated :facet_control_ids, :string, 5
19
+ optional :dynamic_facet_spec, :message, 6, "google.cloud.retail.v2.SearchRequest.DynamicFacetSpec"
20
+ repeated :boost_control_ids, :string, 7
21
+ repeated :filter_control_ids, :string, 9
22
+ repeated :redirect_control_ids, :string, 10
23
+ repeated :twoway_synonyms_control_ids, :string, 18
24
+ repeated :oneway_synonyms_control_ids, :string, 12
25
+ repeated :do_not_associate_control_ids, :string, 13
26
+ repeated :replacement_control_ids, :string, 14
27
+ repeated :ignore_control_ids, :string, 15
28
+ optional :diversity_level, :string, 8
29
+ optional :enable_category_filter_level, :string, 16
30
+ optional :personalization_spec, :message, 21, "google.cloud.retail.v2.SearchRequest.PersonalizationSpec"
31
+ repeated :solution_types, :enum, 19, "google.cloud.retail.v2.SolutionType"
32
+ end
33
+ end
34
+ end
35
+
36
+ module Google
37
+ module Cloud
38
+ module Retail
39
+ module V2
40
+ ServingConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.retail.v2.ServingConfig").msgclass
41
+ end
42
+ end
43
+ end
44
+ end