google-cloud-retail-v2 0.4.2 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b07d919181d8706e180a703f7cecd52fb464e69cfa4fd0ede43cf5b351a0e88e
4
- data.tar.gz: 04bee385524f62ef1d40025669309f5d094b228e5ec833805baad6bacd1d2365
3
+ metadata.gz: 4362ee1ee1297de1e4f20da8c2e02d5b20a38f5334da03e58db621276d2d767b
4
+ data.tar.gz: 7de1bf1b00e922ab9b07c4b7912161f3af7dce3cd46fb4bf4f139d4dd53fba1d
5
5
  SHA512:
6
- metadata.gz: f41c60eb5f15c54e8f4ac41a94be47f87013ece357de71a7699a3b6a8af7ddb0f5d955092c446df68c06ea1aad20d162aca6aa5785680ecf619af408e494a284
7
- data.tar.gz: 536710d9c52c19162bc9a2effd65d2f7861b1b81a50ad3c659a4b1d4034a9acbfbcdb4a205a4de36df434a338ceb076ee68de0566cc29d259449568d876c557f
6
+ metadata.gz: 1dca8e4dc874b55df773716b5115820d4e4f528a88673cf55107acaae041fd3aa8ee236b5bfaa20244172ae23a9b92053dfb10c77c6ee252610c635f19cc35a9
7
+ data.tar.gz: 66bc9026d1216894564f36f5fe8ed093225e7213ed85e3571dce187a4b9ab672023b51706d727ca4acee795ced47cbcfdb9e1aab84146ca75866546ffc15a8e4
@@ -358,8 +358,8 @@ module Google
358
358
  # \\{newBranch}.
359
359
  #
360
360
  # This feature is only available for users who have Retail Search enabled.
361
- # Contact Retail Support (retail-search-support@google.com) if you are
362
- # interested in using Retail Search.
361
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
362
+ # cloud sales if you are interested in using Retail Search.
363
363
  #
364
364
  # @overload set_default_branch(request, options = nil)
365
365
  # Pass arguments to `set_default_branch` via a request object, either of type
@@ -445,8 +445,8 @@ module Google
445
445
  # method under a specified parent catalog.
446
446
  #
447
447
  # This feature is only available for users who have Retail Search enabled.
448
- # Contact Retail Support (retail-search-support@google.com) if you are
449
- # interested in using Retail Search.
448
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
449
+ # cloud sales if you are interested in using Retail Search.
450
450
  #
451
451
  # @overload get_default_branch(request, options = nil)
452
452
  # Pass arguments to `get_default_branch` via a request object, either of type
@@ -73,16 +73,16 @@ module Google
73
73
  # {newBranch}.
74
74
  #
75
75
  # This feature is only available for users who have Retail Search enabled.
76
- # Contact Retail Support (retail-search-support@google.com) if you are
77
- # interested in using Retail Search.
76
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
77
+ # cloud sales if you are interested in using Retail Search.
78
78
  rpc :SetDefaultBranch, ::Google::Cloud::Retail::V2::SetDefaultBranchRequest, ::Google::Protobuf::Empty
79
79
  # Get which branch is currently default branch set by
80
80
  # [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
81
81
  # method under a specified parent catalog.
82
82
  #
83
83
  # This feature is only available for users who have Retail Search enabled.
84
- # Contact Retail Support (retail-search-support@google.com) if you are
85
- # interested in using Retail Search.
84
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
85
+ # cloud sales if you are interested in using Retail Search.
86
86
  rpc :GetDefaultBranch, ::Google::Cloud::Retail::V2::GetDefaultBranchRequest, ::Google::Cloud::Retail::V2::GetDefaultBranchResponse
87
87
  end
88
88
 
@@ -30,8 +30,8 @@ module Google
30
30
  # Auto-completion service for retail.
31
31
  #
32
32
  # This feature is only available for users who have Retail Search enabled.
33
- # Contact Retail Support (retail-search-support@google.com) if you are
34
- # interested in using Retail Search.
33
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
34
+ # cloud sales if you are interested in using Retail Search.
35
35
  #
36
36
  class Client
37
37
  include Paths
@@ -169,8 +169,8 @@ module Google
169
169
  # Completes the specified prefix with keyword suggestions.
170
170
  #
171
171
  # This feature is only available for users who have Retail Search enabled.
172
- # Contact Retail Support (retail-search-support@google.com) if you are
173
- # interested in using Retail Search.
172
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
173
+ # cloud sales if you are interested in using Retail Search.
174
174
  #
175
175
  # @overload complete_query(request, options = nil)
176
176
  # Pass arguments to `complete_query` via a request object, either of type
@@ -239,12 +239,14 @@ module Google
239
239
  # * user-data
240
240
  #
241
241
  # * cloud-retail
242
- # This option is not automatically enabled. Before using cloud-retail,
243
- # contact retail-search-support@google.com first.
242
+ # This option requires additional allowlisting. Before using cloud-retail,
243
+ # contact Cloud Retail support team first.
244
244
  # @param max_suggestions [::Integer]
245
- # Completion max suggestions.
245
+ # Completion max suggestions. If left unset or set to 0, then will fallback
246
+ # to the configured value [CompletionConfig.max_suggestions][].
246
247
  #
247
- # The maximum allowed max suggestions is 20. The default value is 20.
248
+ # The maximum allowed max suggestions is 20. If it is set higher, it will be
249
+ # capped by 20.
248
250
  #
249
251
  # @yield [response, operation] Access the result along with the RPC operation
250
252
  # @yieldparam response [::Google::Cloud::Retail::V2::CompleteQueryResponse]
@@ -299,8 +301,8 @@ module Google
299
301
  # Request processing may be synchronous. Partial updating is not supported.
300
302
  #
301
303
  # This feature is only available for users who have Retail Search enabled.
302
- # Contact Retail Support (retail-search-support@google.com) if you are
303
- # interested in using Retail Search.
304
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
305
+ # cloud sales if you are interested in using Retail Search.
304
306
  #
305
307
  # @overload import_completion_data(request, options = nil)
306
308
  # Pass arguments to `import_completion_data` via a request object, either of type
@@ -35,8 +35,8 @@ module Google
35
35
  # Auto-completion service for retail.
36
36
  #
37
37
  # This feature is only available for users who have Retail Search enabled.
38
- # Contact Retail Support (retail-search-support@google.com) if you are
39
- # interested in using Retail Search.
38
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
39
+ # cloud sales if you are interested in using Retail Search.
40
40
  #
41
41
  # To load this service and instantiate a client:
42
42
  #
@@ -27,8 +27,8 @@ module Google
27
27
  # Auto-completion service for retail.
28
28
  #
29
29
  # This feature is only available for users who have Retail Search enabled.
30
- # Contact Retail Support (retail-search-support@google.com) if you are
31
- # interested in using Retail Search.
30
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
31
+ # cloud sales if you are interested in using Retail Search.
32
32
  class Service
33
33
 
34
34
  include GRPC::GenericService
@@ -40,16 +40,16 @@ module Google
40
40
  # Completes the specified prefix with keyword suggestions.
41
41
  #
42
42
  # This feature is only available for users who have Retail Search enabled.
43
- # Contact Retail Support (retail-search-support@google.com) if you are
44
- # interested in using Retail Search.
43
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
44
+ # cloud sales if you are interested in using Retail Search.
45
45
  rpc :CompleteQuery, ::Google::Cloud::Retail::V2::CompleteQueryRequest, ::Google::Cloud::Retail::V2::CompleteQueryResponse
46
46
  # Bulk import of processed completion dataset.
47
47
  #
48
48
  # Request processing may be synchronous. Partial updating is not supported.
49
49
  #
50
50
  # This feature is only available for users who have Retail Search enabled.
51
- # Contact Retail Support (retail-search-support@google.com) if you are
52
- # interested in using Retail Search.
51
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
52
+ # cloud sales if you are interested in using Retail Search.
53
53
  rpc :ImportCompletionData, ::Google::Cloud::Retail::V2::ImportCompletionDataRequest, ::Google::Longrunning::Operation
54
54
  end
55
55
 
@@ -792,8 +792,8 @@ module Google
792
792
  # {::Google::Cloud::Retail::V2::ProductService::Client#remove_fulfillment_places RemoveFulfillmentPlaces}.
793
793
  #
794
794
  # This feature is only available for users who have Retail Search enabled.
795
- # Contact Retail Support (retail-search-support@google.com) if you are
796
- # interested in using Retail Search.
795
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
796
+ # cloud sales if you are interested in using Retail Search.
797
797
  #
798
798
  # @overload set_inventory(request, options = nil)
799
799
  # Pass arguments to `set_inventory` via a request object, either of type
@@ -927,8 +927,8 @@ module Google
927
927
  # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ListProducts}.
928
928
  #
929
929
  # This feature is only available for users who have Retail Search enabled.
930
- # Contact Retail Support (retail-search-support@google.com) if you are
931
- # interested in using Retail Search.
930
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
931
+ # cloud sales if you are interested in using Retail Search.
932
932
  #
933
933
  # @overload add_fulfillment_places(request, options = nil)
934
934
  # Pass arguments to `add_fulfillment_places` via a request object, either of type
@@ -1063,8 +1063,8 @@ module Google
1063
1063
  # {::Google::Cloud::Retail::V2::ProductService::Client#list_products ListProducts}.
1064
1064
  #
1065
1065
  # This feature is only available for users who have Retail Search enabled.
1066
- # Contact Retail Support (retail-search-support@google.com) if you are
1067
- # interested in using Retail Search.
1066
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
1067
+ # cloud sales if you are interested in using Retail Search.
1068
1068
  #
1069
1069
  # @overload remove_fulfillment_places(request, options = nil)
1070
1070
  # Pass arguments to `remove_fulfillment_places` via a request object, either of type
@@ -90,8 +90,8 @@ module Google
90
90
  # [RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
91
91
  #
92
92
  # This feature is only available for users who have Retail Search enabled.
93
- # Contact Retail Support (retail-search-support@google.com) if you are
94
- # interested in using Retail Search.
93
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
94
+ # cloud sales if you are interested in using Retail Search.
95
95
  rpc :SetInventory, ::Google::Cloud::Retail::V2::SetInventoryRequest, ::Google::Longrunning::Operation
96
96
  # Incrementally adds place IDs to
97
97
  # [Product.fulfillment_info.place_ids][google.cloud.retail.v2.FulfillmentInfo.place_ids].
@@ -106,8 +106,8 @@ module Google
106
106
  # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
107
107
  #
108
108
  # This feature is only available for users who have Retail Search enabled.
109
- # Contact Retail Support (retail-search-support@google.com) if you are
110
- # interested in using Retail Search.
109
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
110
+ # cloud sales if you are interested in using Retail Search.
111
111
  rpc :AddFulfillmentPlaces, ::Google::Cloud::Retail::V2::AddFulfillmentPlacesRequest, ::Google::Longrunning::Operation
112
112
  # Incrementally removes place IDs from a
113
113
  # [Product.fulfillment_info.place_ids][google.cloud.retail.v2.FulfillmentInfo.place_ids].
@@ -122,8 +122,8 @@ module Google
122
122
  # [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
123
123
  #
124
124
  # This feature is only available for users who have Retail Search enabled.
125
- # Contact Retail Support (retail-search-support@google.com) if you are
126
- # interested in using Retail Search.
125
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
126
+ # cloud sales if you are interested in using Retail Search.
127
127
  rpc :RemoveFulfillmentPlaces, ::Google::Cloud::Retail::V2::RemoveFulfillmentPlacesRequest, ::Google::Longrunning::Operation
128
128
  end
129
129
 
@@ -30,8 +30,8 @@ module Google
30
30
  # Service for search.
31
31
  #
32
32
  # This feature is only available for users who have Retail Search enabled.
33
- # Contact Retail Support (retail-search-support@google.com) if you are
34
- # interested in using Retail Search.
33
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
34
+ # cloud sales if you are interested in using Retail Search.
35
35
  #
36
36
  class Client
37
37
  include Paths
@@ -157,8 +157,8 @@ module Google
157
157
  # Performs a search.
158
158
  #
159
159
  # This feature is only available for users who have Retail Search enabled.
160
- # Contact Retail Support (retail-search-support@google.com) if you are
161
- # interested in using Retail Search.
160
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
161
+ # cloud sales if you are interested in using Retail Search.
162
162
  #
163
163
  # @overload search(request, options = nil)
164
164
  # Pass arguments to `search` via a request object, either of type
@@ -230,7 +230,8 @@ module Google
230
230
  # @param filter [::String]
231
231
  # The filter syntax consists of an expression language for constructing a
232
232
  # predicate from one or more fields of the products being filtered. Filter
233
- # expression is case-sensitive.
233
+ # expression is case-sensitive. See more details at this [user
234
+ # guide](/retail/private/docs/filter-and-order#filter).
234
235
  #
235
236
  # If this field is unrecognizable, an INVALID_ARGUMENT is returned.
236
237
  # @param canonical_filter [::String]
@@ -246,7 +247,9 @@ module Google
246
247
  # @param order_by [::String]
247
248
  # The order in which products are returned. Products can be ordered by
248
249
  # a field in an {::Google::Cloud::Retail::V2::Product Product} object. Leave it
249
- # unset if ordered by relevance. OrderBy expression is case-sensitive.
250
+ # unset if ordered by relevance. OrderBy expression is case-sensitive. See
251
+ # more details at this [user
252
+ # guide](/retail/private/docs/filter-and-order#order).
250
253
  #
251
254
  # If this field is unrecognizable, an INVALID_ARGUMENT is returned.
252
255
  # @param facet_specs [::Array<::Google::Cloud::Retail::V2::SearchRequest::FacetSpec, ::Hash>]
@@ -258,14 +261,15 @@ module Google
258
261
  # The specification for dynamically generated facets. Notice that only
259
262
  # textual facets can be dynamically generated.
260
263
  #
261
- # This feature requires additional allowlisting. Contact Retail Support
262
- # (retail-search-support@google.com) if you are interested in using dynamic
263
- # facet feature.
264
+ # This feature requires additional allowlisting. Contact Retail Search
265
+ # support team if you are interested in using dynamic facet feature.
264
266
  # @param boost_spec [::Google::Cloud::Retail::V2::SearchRequest::BoostSpec, ::Hash]
265
- # Boost specification to boost certain products.
267
+ # Boost specification to boost certain products. See more details at this
268
+ # [user guide](/retail/private/docs/boosting).
266
269
  # @param query_expansion_spec [::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec, ::Hash]
267
270
  # The query expansion specification that specifies the conditions under which
268
- # query expansion will occur.
271
+ # query expansion will occur. See more details at this [user
272
+ # guide](/retail/private/docs/result-size#query_expansion).
269
273
  # @param variant_rollup_keys [::Array<::String>]
270
274
  # The keys to fetch and rollup the matching
271
275
  # {::Google::Cloud::Retail::V2::Product::Type::VARIANT variant}
@@ -276,10 +280,9 @@ module Google
276
280
  # {::Google::Cloud::Retail::V2::Product Product}s attributes will lead to extra
277
281
  # query latency. Maximum number of keys is 10.
278
282
  #
279
- # For
280
- # {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info},
281
- # a fulfillment type and a fulfillment ID must be provided in the format of
282
- # "fulfillmentType.filfillmentId". E.g., in "pickupInStore.store123",
283
+ # For {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo}, a
284
+ # fulfillment type and a fulfillment ID must be provided in the format of
285
+ # "fulfillmentType.fulfillmentId". E.g., in "pickupInStore.store123",
283
286
  # "pickupInStore" is fulfillment type and "store123" is the store ID.
284
287
  #
285
288
  # Supported keys are:
@@ -290,24 +293,42 @@ module Google
290
293
  # * discount
291
294
  # * attributes.key, where key is any key in the
292
295
  # {::Google::Cloud::Retail::V2::Product#attributes Product.attributes} map.
293
- # * pickupInStore.id, where id is any [FulfillmentInfo.ids][] for type
294
- # [FulfillmentInfo.Type.PICKUP_IN_STORE][].
295
- # * shipToStore.id, where id is any [FulfillmentInfo.ids][] for type
296
- # [FulfillmentInfo.Type.SHIP_TO_STORE][].
297
- # * sameDayDelivery.id, where id is any [FulfillmentInfo.ids][] for type
298
- # [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].
299
- # * nextDayDelivery.id, where id is any [FulfillmentInfo.ids][] for type
300
- # [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].
301
- # * customFulfillment1.id, where id is any [FulfillmentInfo.ids][] for type
302
- # [FulfillmentInfo.Type.CUSTOM_TYPE_1][].
303
- # * customFulfillment2.id, where id is any [FulfillmentInfo.ids][] for type
304
- # [FulfillmentInfo.Type.CUSTOM_TYPE_2][].
305
- # * customFulfillment3.id, where id is any [FulfillmentInfo.ids][] for type
306
- # [FulfillmentInfo.Type.CUSTOM_TYPE_3][].
307
- # * customFulfillment4.id, where id is any [FulfillmentInfo.ids][] for type
308
- # [FulfillmentInfo.Type.CUSTOM_TYPE_4][].
309
- # * customFulfillment5.id, where id is any [FulfillmentInfo.ids][] for type
310
- # [FulfillmentInfo.Type.CUSTOM_TYPE_5][].
296
+ # * pickupInStore.id, where id is any
297
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
298
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
299
+ # "pickup-in-store".
300
+ # * shipToStore.id, where id is any
301
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
302
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
303
+ # "ship-to-store".
304
+ # * sameDayDelivery.id, where id is any
305
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
306
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
307
+ # "same-day-delivery".
308
+ # * nextDayDelivery.id, where id is any
309
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
310
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
311
+ # "next-day-delivery".
312
+ # * customFulfillment1.id, where id is any
313
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
314
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
315
+ # "custom-type-1".
316
+ # * customFulfillment2.id, where id is any
317
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
318
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
319
+ # "custom-type-2".
320
+ # * customFulfillment3.id, where id is any
321
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
322
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
323
+ # "custom-type-3".
324
+ # * customFulfillment4.id, where id is any
325
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
326
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
327
+ # "custom-type-4".
328
+ # * customFulfillment5.id, where id is any
329
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
330
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
331
+ # "custom-type-5".
311
332
  #
312
333
  # If this field is set to an invalid value other than these, an
313
334
  # INVALID_ARGUMENT error is returned.
@@ -34,8 +34,8 @@ module Google
34
34
  # Service for search.
35
35
  #
36
36
  # This feature is only available for users who have Retail Search enabled.
37
- # Contact Retail Support (retail-search-support@google.com) if you are
38
- # interested in using Retail Search.
37
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
38
+ # cloud sales if you are interested in using Retail Search.
39
39
  #
40
40
  # To load this service and instantiate a client:
41
41
  #
@@ -66,6 +66,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
66
66
  end
67
67
  add_message "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec" do
68
68
  optional :condition, :enum, 1, "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition"
69
+ optional :pin_unexpanded_results, :bool, 2
69
70
  end
70
71
  add_enum "google.cloud.retail.v2.SearchRequest.QueryExpansionSpec.Condition" do
71
72
  value :CONDITION_UNSPECIFIED, 0
@@ -103,6 +104,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
103
104
  end
104
105
  add_message "google.cloud.retail.v2.SearchResponse.QueryExpansionInfo" do
105
106
  optional :expanded_query, :bool, 1
107
+ optional :pinned_result_count, :int64, 2
106
108
  end
107
109
  end
108
110
  end
@@ -27,8 +27,8 @@ module Google
27
27
  # Service for search.
28
28
  #
29
29
  # This feature is only available for users who have Retail Search enabled.
30
- # Contact Retail Support (retail-search-support@google.com) if you are
31
- # interested in using Retail Search.
30
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
31
+ # cloud sales if you are interested in using Retail Search.
32
32
  class Service
33
33
 
34
34
  include GRPC::GenericService
@@ -40,8 +40,8 @@ module Google
40
40
  # Performs a search.
41
41
  #
42
42
  # This feature is only available for users who have Retail Search enabled.
43
- # Contact Retail Support (retail-search-support@google.com) if you are
44
- # interested in using Retail Search.
43
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
44
+ # cloud sales if you are interested in using Retail Search.
45
45
  rpc :Search, ::Google::Cloud::Retail::V2::SearchRequest, ::Google::Cloud::Retail::V2::SearchResponse
46
46
  end
47
47
 
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Retail
23
23
  module V2
24
- VERSION = "0.4.2"
24
+ VERSION = "0.5.0"
25
25
  end
26
26
  end
27
27
  end
@@ -80,13 +80,15 @@ module Google
80
80
  # * user-data
81
81
  #
82
82
  # * cloud-retail
83
- # This option is not automatically enabled. Before using cloud-retail,
84
- # contact retail-search-support@google.com first.
83
+ # This option requires additional allowlisting. Before using cloud-retail,
84
+ # contact Cloud Retail support team first.
85
85
  # @!attribute [rw] max_suggestions
86
86
  # @return [::Integer]
87
- # Completion max suggestions.
87
+ # Completion max suggestions. If left unset or set to 0, then will fallback
88
+ # to the configured value [CompletionConfig.max_suggestions][].
88
89
  #
89
- # The maximum allowed max suggestions is 20. The default value is 20.
90
+ # The maximum allowed max suggestions is 20. If it is set higher, it will be
91
+ # capped by 20.
90
92
  class CompleteQueryRequest
91
93
  include ::Google::Protobuf::MessageExts
92
94
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -105,9 +107,9 @@ module Google
105
107
  # performance.
106
108
  # @!attribute [rw] recent_search_results
107
109
  # @return [::Array<::Google::Cloud::Retail::V2::CompleteQueryResponse::RecentSearchResult>]
108
- # Matched recent searches of this user. This field is a restricted feature.
109
- # Contact Retail Support (retail-search-support@google.com) if you are
110
- # interested in enabling it.
110
+ # Matched recent searches of this user. The maximum number of recent searches
111
+ # is 10. This field is a restricted feature. Contact Retail Search support
112
+ # team if you are interested in enabling it.
111
113
  #
112
114
  # This feature is only available when
113
115
  # {::Google::Cloud::Retail::V2::CompleteQueryRequest#visitor_id CompleteQueryRequest.visitor_id}
@@ -201,13 +201,13 @@ module Google
201
201
  # Can only be while using
202
202
  # {::Google::Cloud::Retail::V2::BigQuerySource BigQuerySource}.
203
203
  #
204
- # Add the IAM permission BigQuery Data Viewer for
204
+ # Add the IAM permission "BigQuery Data Viewer" for
205
205
  # cloud-retail-customer-data-access@system.gserviceaccount.com before
206
206
  # using this feature otherwise an error is thrown.
207
207
  #
208
208
  # This feature is only available for users who have Retail Search enabled.
209
- # Contact Retail Support (retail-search-support@google.com) if you are
210
- # interested in using Retail Search.
209
+ # Please submit a form [here](https://cloud.google.com/contact) to contact
210
+ # cloud sales if you are interested in using Retail Search.
211
211
  FULL = 2
212
212
  end
213
213
  end
@@ -284,7 +284,7 @@ module Google
284
284
  # @return [::Google::Cloud::Retail::V2::BigQuerySource]
285
285
  # Required. BigQuery input source.
286
286
  #
287
- # Add the IAM permission BigQuery Data Viewer for
287
+ # Add the IAM permission "BigQuery Data Viewer" for
288
288
  # cloud-retail-customer-data-access@system.gserviceaccount.com before
289
289
  # using this feature otherwise an error is thrown.
290
290
  class CompletionDataInputConfig
@@ -230,13 +230,9 @@ module Google
230
230
  # This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT
231
231
  # error is returned:
232
232
  #
233
- # * Max entries count: 200 by default; 100 for
234
- # {::Google::Cloud::Retail::V2::Product::Type::VARIANT Type.VARIANT}.
233
+ # * Max entries count: 200.
235
234
  # * The key must be a UTF-8 encoded string with a length limit of 128
236
235
  # characters.
237
- # * Max indexable entries count: 200 by default; 40 for
238
- # {::Google::Cloud::Retail::V2::Product::Type::VARIANT Type.VARIANT}.
239
- # * Max searchable entries count: 30.
240
236
  # * For indexable attribute, the key must match the pattern:
241
237
  # [a-zA-Z0-9][a-zA-Z0-9_]*. For example, key0LikeThis or KEY_1_LIKE_THIS.
242
238
  # @!attribute [rw] tags
@@ -346,7 +342,7 @@ module Google
346
342
  # @return [::Array<::String>]
347
343
  # The material of the product. For example, "leather", "wooden".
348
344
  #
349
- # A maximum of 5 values are allowed. Each value must be a UTF-8 encoded
345
+ # A maximum of 20 values are allowed. Each value must be a UTF-8 encoded
350
346
  # string with a length limit of 128 characters. Otherwise, an
351
347
  # INVALID_ARGUMENT error is returned.
352
348
  #
@@ -445,8 +441,12 @@ module Google
445
441
  # * {::Google::Cloud::Retail::V2::Product#name name}
446
442
  # * {::Google::Cloud::Retail::V2::Product#color_info color_info}
447
443
  #
448
- # Maximum number of paths is 20. Otherwise, an INVALID_ARGUMENT error is
444
+ # Maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is
449
445
  # returned.
446
+ #
447
+ # Note: Returning more fields in
448
+ # {::Google::Cloud::Retail::V2::SearchResponse SearchResponse} may increase
449
+ # response payload size and serving latency.
450
450
  # @!attribute [r] variants
451
451
  # @return [::Array<::Google::Cloud::Retail::V2::Product>]
452
452
  # Output only. Product variants grouped together on primary product which
@@ -87,7 +87,8 @@ module Google
87
87
  # @return [::String]
88
88
  # The filter syntax consists of an expression language for constructing a
89
89
  # predicate from one or more fields of the products being filtered. Filter
90
- # expression is case-sensitive.
90
+ # expression is case-sensitive. See more details at this [user
91
+ # guide](/retail/private/docs/filter-and-order#filter).
91
92
  #
92
93
  # If this field is unrecognizable, an INVALID_ARGUMENT is returned.
93
94
  # @!attribute [rw] canonical_filter
@@ -105,7 +106,9 @@ module Google
105
106
  # @return [::String]
106
107
  # The order in which products are returned. Products can be ordered by
107
108
  # a field in an {::Google::Cloud::Retail::V2::Product Product} object. Leave it
108
- # unset if ordered by relevance. OrderBy expression is case-sensitive.
109
+ # unset if ordered by relevance. OrderBy expression is case-sensitive. See
110
+ # more details at this [user
111
+ # guide](/retail/private/docs/filter-and-order#order).
109
112
  #
110
113
  # If this field is unrecognizable, an INVALID_ARGUMENT is returned.
111
114
  # @!attribute [rw] facet_specs
@@ -119,16 +122,17 @@ module Google
119
122
  # The specification for dynamically generated facets. Notice that only
120
123
  # textual facets can be dynamically generated.
121
124
  #
122
- # This feature requires additional allowlisting. Contact Retail Support
123
- # (retail-search-support@google.com) if you are interested in using dynamic
124
- # facet feature.
125
+ # This feature requires additional allowlisting. Contact Retail Search
126
+ # support team if you are interested in using dynamic facet feature.
125
127
  # @!attribute [rw] boost_spec
126
128
  # @return [::Google::Cloud::Retail::V2::SearchRequest::BoostSpec]
127
- # Boost specification to boost certain products.
129
+ # Boost specification to boost certain products. See more details at this
130
+ # [user guide](/retail/private/docs/boosting).
128
131
  # @!attribute [rw] query_expansion_spec
129
132
  # @return [::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec]
130
133
  # The query expansion specification that specifies the conditions under which
131
- # query expansion will occur.
134
+ # query expansion will occur. See more details at this [user
135
+ # guide](/retail/private/docs/result-size#query_expansion).
132
136
  # @!attribute [rw] variant_rollup_keys
133
137
  # @return [::Array<::String>]
134
138
  # The keys to fetch and rollup the matching
@@ -140,10 +144,9 @@ module Google
140
144
  # {::Google::Cloud::Retail::V2::Product Product}s attributes will lead to extra
141
145
  # query latency. Maximum number of keys is 10.
142
146
  #
143
- # For
144
- # {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info},
145
- # a fulfillment type and a fulfillment ID must be provided in the format of
146
- # "fulfillmentType.filfillmentId". E.g., in "pickupInStore.store123",
147
+ # For {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo}, a
148
+ # fulfillment type and a fulfillment ID must be provided in the format of
149
+ # "fulfillmentType.fulfillmentId". E.g., in "pickupInStore.store123",
147
150
  # "pickupInStore" is fulfillment type and "store123" is the store ID.
148
151
  #
149
152
  # Supported keys are:
@@ -154,24 +157,42 @@ module Google
154
157
  # * discount
155
158
  # * attributes.key, where key is any key in the
156
159
  # {::Google::Cloud::Retail::V2::Product#attributes Product.attributes} map.
157
- # * pickupInStore.id, where id is any [FulfillmentInfo.ids][] for type
158
- # [FulfillmentInfo.Type.PICKUP_IN_STORE][].
159
- # * shipToStore.id, where id is any [FulfillmentInfo.ids][] for type
160
- # [FulfillmentInfo.Type.SHIP_TO_STORE][].
161
- # * sameDayDelivery.id, where id is any [FulfillmentInfo.ids][] for type
162
- # [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].
163
- # * nextDayDelivery.id, where id is any [FulfillmentInfo.ids][] for type
164
- # [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].
165
- # * customFulfillment1.id, where id is any [FulfillmentInfo.ids][] for type
166
- # [FulfillmentInfo.Type.CUSTOM_TYPE_1][].
167
- # * customFulfillment2.id, where id is any [FulfillmentInfo.ids][] for type
168
- # [FulfillmentInfo.Type.CUSTOM_TYPE_2][].
169
- # * customFulfillment3.id, where id is any [FulfillmentInfo.ids][] for type
170
- # [FulfillmentInfo.Type.CUSTOM_TYPE_3][].
171
- # * customFulfillment4.id, where id is any [FulfillmentInfo.ids][] for type
172
- # [FulfillmentInfo.Type.CUSTOM_TYPE_4][].
173
- # * customFulfillment5.id, where id is any [FulfillmentInfo.ids][] for type
174
- # [FulfillmentInfo.Type.CUSTOM_TYPE_5][].
160
+ # * pickupInStore.id, where id is any
161
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
162
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
163
+ # "pickup-in-store".
164
+ # * shipToStore.id, where id is any
165
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
166
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
167
+ # "ship-to-store".
168
+ # * sameDayDelivery.id, where id is any
169
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
170
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
171
+ # "same-day-delivery".
172
+ # * nextDayDelivery.id, where id is any
173
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
174
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
175
+ # "next-day-delivery".
176
+ # * customFulfillment1.id, where id is any
177
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
178
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
179
+ # "custom-type-1".
180
+ # * customFulfillment2.id, where id is any
181
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
182
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
183
+ # "custom-type-2".
184
+ # * customFulfillment3.id, where id is any
185
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
186
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
187
+ # "custom-type-3".
188
+ # * customFulfillment4.id, where id is any
189
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
190
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
191
+ # "custom-type-4".
192
+ # * customFulfillment5.id, where id is any
193
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
194
+ # for {::Google::Cloud::Retail::V2::FulfillmentInfo#type FulfillmentInfo.type}
195
+ # "custom-type-5".
175
196
  #
176
197
  # If this field is set to an invalid value other than these, an
177
198
  # INVALID_ARGUMENT error is returned.
@@ -269,35 +290,35 @@ module Google
269
290
  # {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#query FacetKey.query}
270
291
  # is not specified:
271
292
  #
272
- # Textual facet keys:
273
- # * brands
274
- # * categories
275
- # * genders
276
- # * ageGroups
277
- # * availability
278
- # * colorFamilies
279
- # * colors
280
- # * sizes
281
- # * materials
282
- # * patterns
283
- # * conditions
284
- # * attributes.key
285
- # * pickupInStore
286
- # * shipToStore
287
- # * sameDayDelivery
288
- # * nextDayDelivery
289
- # * customFulfillment1
290
- # * customFulfillment2
291
- # * customFulfillment3
292
- # * customFulfillment4
293
- # * customFulfillment5
293
+ # * textual_field =
294
+ # * "brands"
295
+ # * "categories"
296
+ # * "genders"
297
+ # * "ageGroups"
298
+ # * "availability"
299
+ # * "colorFamilies"
300
+ # * "colors"
301
+ # * "sizes"
302
+ # * "materials"
303
+ # * "patterns"
304
+ # * "conditions"
305
+ # * "attributes.key"
306
+ # * "pickupInStore"
307
+ # * "shipToStore"
308
+ # * "sameDayDelivery"
309
+ # * "nextDayDelivery"
310
+ # * "customFulfillment1"
311
+ # * "customFulfillment2"
312
+ # * "customFulfillment3"
313
+ # * "customFulfillment4"
314
+ # * "customFulfillment5"
294
315
  #
295
- # Numeric facet keys:
296
- # * price
297
- # * discount
298
- # * rating
299
- # * ratingCount
300
- # * attributes.key
316
+ # * numerical_field =
317
+ # * "price"
318
+ # * "discount"
319
+ # * "rating"
320
+ # * "ratingCount"
321
+ # * "attributes.key"
301
322
  # @!attribute [rw] intervals
302
323
  # @return [::Array<::Google::Cloud::Retail::V2::Interval>]
303
324
  # Set only if values should be bucketized into intervals. Must be set
@@ -361,7 +382,8 @@ module Google
361
382
  # order](https://en.wikipedia.org/wiki/Natural_sort_order); numerical
362
383
  # intervals are sorted in the order given by
363
384
  # {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#intervals FacetSpec.FacetKey.intervals};
364
- # [FulfillmentInfo.ids][] are sorted in the order given by
385
+ # {::Google::Cloud::Retail::V2::FulfillmentInfo#place_ids FulfillmentInfo.place_ids}
386
+ # are sorted in the order given by
365
387
  # {::Google::Cloud::Retail::V2::SearchRequest::FacetSpec::FacetKey#restricted_values FacetSpec.FacetKey.restricted_values}.
366
388
  # @!attribute [rw] query
367
389
  # @return [::String]
@@ -437,12 +459,11 @@ module Google
437
459
  # Examples:
438
460
  #
439
461
  # * To boost products with product ID "product_1" or "product_2", and
440
- # color "Red" or "Blue":
441
- # ```
442
- # (id: ANY("product_1", "product_2"))
443
- # AND
444
- # (colorFamilies: ANY("Red", "Blue"))
445
- # ```
462
+ # color
463
+ # "Red" or "Blue":<br>
464
+ # *(id: ANY("product_1", "product_2"))<br>*
465
+ # *AND<br>*
466
+ # *(colorFamilies: ANY("Red", "Blue"))<br>*
446
467
  # @!attribute [rw] boost
447
468
  # @return [::Float]
448
469
  # Strength of the condition boost, which should be in [-1, 1]. Negative
@@ -474,6 +495,11 @@ module Google
474
495
  # @return [::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec::Condition]
475
496
  # The condition under which query expansion should occur. Default to
476
497
  # {::Google::Cloud::Retail::V2::SearchRequest::QueryExpansionSpec::Condition::DISABLED Condition.DISABLED}.
498
+ # @!attribute [rw] pin_unexpanded_results
499
+ # @return [::Boolean]
500
+ # Whether to pin unexpanded results. If this field is set to true,
501
+ # unexpanded products are always at the top of the search results, followed
502
+ # by the expanded results.
477
503
  class QueryExpansionSpec
478
504
  include ::Google::Protobuf::MessageExts
479
505
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -605,10 +631,9 @@ module Google
605
631
  # }
606
632
  # }
607
633
  #
608
- # For
609
- # {::Google::Cloud::Retail::V2::Product#fulfillment_info Product.fulfillment_info},
610
- # the rollup values is a double value with type
611
- # {::Google::Protobuf::Value google.protobuf.Value}. For example:
634
+ # For {::Google::Cloud::Retail::V2::FulfillmentInfo FulfillmentInfo}, the rollup
635
+ # values is a double value with type
636
+ # {::Google::Protobuf::Value google.protobuf.Value}. For example,
612
637
  # `{key: "pickupInStore.store1" value { number_value: 10 }}` means a there
613
638
  # are 10 variants in this product are available in the store "store1".
614
639
  class SearchResult
@@ -670,6 +695,11 @@ module Google
670
695
  # @!attribute [rw] expanded_query
671
696
  # @return [::Boolean]
672
697
  # Bool describing whether query expansion has occurred.
698
+ # @!attribute [rw] pinned_result_count
699
+ # @return [::Integer]
700
+ # Number of pinned results. This field will only be set when expansion
701
+ # happens and [SearchRequest.query_expansion_spec.pin_unexpanded_results][]
702
+ # is set to true.
673
703
  class QueryExpansionInfo
674
704
  include ::Google::Protobuf::MessageExts
675
705
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -260,9 +260,21 @@ module Google
260
260
  # @return [::Google::Cloud::Retail::V2::Product]
261
261
  # Required. {::Google::Cloud::Retail::V2::Product Product} information.
262
262
  #
263
- # Only {::Google::Cloud::Retail::V2::Product#id Product.id} field is used when
264
- # ingesting an event, all other product fields are ignored as we will look
265
- # them up from the catalog.
263
+ # Required field(s):
264
+ #
265
+ # * {::Google::Cloud::Retail::V2::Product#id Product.id}
266
+ #
267
+ # Optional override field(s):
268
+ #
269
+ # * {::Google::Cloud::Retail::V2::Product#price_info Product.price_info}
270
+ #
271
+ # If any supported optional fields are provided, we will treat them as a full
272
+ # override when looking up product information from the catalog. Thus, it is
273
+ # important to ensure that the overriding fields are accurate and
274
+ # complete.
275
+ #
276
+ # All other product fields are ignored and instead populated via catalog
277
+ # lookup after event ingestion.
266
278
  # @!attribute [rw] quantity
267
279
  # @return [::Google::Protobuf::Int32Value]
268
280
  # Quantity of the product associated with the user event.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-retail-v2
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.2
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-08-11 00:00:00.000000000 Z
11
+ date: 2021-08-23 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common