google-cloud-retail-v2 0.10.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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