Reference documentation and code samples for the Google Cloud Retail V2 Client class PinAction.
Pins one or more specified products to a specific position in the results.
- Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can't specify both.
- Action Input: mapping of
[pin_position, product_id]
pairs (pin position uses 1-based indexing). - Action Result: Will pin products with matching ids to the position
specified in the final result order.
Example: Suppose the query is
shoes
, the Condition.query_terms isshoes
and the pin_map has{1, "pid1"}
, then product withpid1
will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed.
Generated from protobuf message google.cloud.retail.v2.Rule.PinAction
Namespace
Google \ Cloud \ Retail \ V2 \ RuleMethods
__construct
Constructor.
Parameters | |
---|---|
Name | Description |
data |
array
Optional. Data for populating the Message object. |
↳ pin_map |
array|Google\Protobuf\Internal\MapField
Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that |
getPinMap
Required. A map of positions to product_ids.
Partial matches per action are allowed, if a certain position in the map
is already filled that [position, product_id]
pair will be ignored
but the rest may still be applied. This case will only occur if multiple
pin actions are matched to a single request, as the map guarantees that
pin positions are unique within the same action.
Duplicate product_ids are not permitted within a single pin map.
The max size of this map is 120, equivalent to the max request page
size.
Returns | |
---|---|
Type | Description |
Google\Protobuf\Internal\MapField |
setPinMap
Required. A map of positions to product_ids.
Partial matches per action are allowed, if a certain position in the map
is already filled that [position, product_id]
pair will be ignored
but the rest may still be applied. This case will only occur if multiple
pin actions are matched to a single request, as the map guarantees that
pin positions are unique within the same action.
Duplicate product_ids are not permitted within a single pin map.
The max size of this map is 120, equivalent to the max request page
size.
Parameter | |
---|---|
Name | Description |
var |
array|Google\Protobuf\Internal\MapField
|
Returns | |
---|---|
Type | Description |
$this |