feat(retail): update the api

#### retail:v2

The following keys were added:
- schemas.GoogleCloudRetailV2Rule.properties.pinAction.$ref (Total Keys: 1)
- schemas.GoogleCloudRetailV2RulePinAction (Total Keys: 4)

#### retail:v2alpha

The following keys were added:
- schemas.GoogleCloudRetailV2alphaRule.properties.pinAction.$ref (Total Keys: 1)
- schemas.GoogleCloudRetailV2alphaRulePinAction (Total Keys: 4)

#### retail:v2beta

The following keys were added:
- schemas.GoogleCloudRetailV2betaRule.properties.pinAction.$ref (Total Keys: 1)
- schemas.GoogleCloudRetailV2betaRulePinAction (Total Keys: 4)

Author: yoshi-automation

docs/dyn/retail_v2.projects.locations.catalogs.controls.html

@@ -176,6 +176,11 @@ <h3>Method Details</h3>
         &quot;A String&quot;,
       ],
     },
+    &quot;pinAction&quot;: { # 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&#x27;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 is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` 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. # Pins one or more specified products to a specific position in the results.
+      &quot;pinMap&quot;: { # 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](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+        &quot;a_key&quot;: &quot;A String&quot;,
+      },
+    },
     &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
       &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
     },
@@ -280,6 +285,11 @@ <h3>Method Details</h3>
         &quot;A String&quot;,
       ],
     },
+    &quot;pinAction&quot;: { # 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&#x27;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 is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` 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. # Pins one or more specified products to a specific position in the results.
+      &quot;pinMap&quot;: { # 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](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+        &quot;a_key&quot;: &quot;A String&quot;,
+      },
+    },
     &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
       &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
     },
@@ -408,6 +418,11 @@ <h3>Method Details</h3>
         &quot;A String&quot;,
       ],
     },
+    &quot;pinAction&quot;: { # 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&#x27;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 is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` 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. # Pins one or more specified products to a specific position in the results.
+      &quot;pinMap&quot;: { # 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](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+        &quot;a_key&quot;: &quot;A String&quot;,
+      },
+    },
     &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
       &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
     },
@@ -523,6 +538,11 @@ <h3>Method Details</h3>
             &quot;A String&quot;,
           ],
         },
+        &quot;pinAction&quot;: { # 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&#x27;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 is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` 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. # Pins one or more specified products to a specific position in the results.
+          &quot;pinMap&quot;: { # 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](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+            &quot;a_key&quot;: &quot;A String&quot;,
+          },
+        },
         &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
           &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
         },
@@ -645,6 +665,11 @@ <h3>Method Details</h3>
         &quot;A String&quot;,
       ],
     },
+    &quot;pinAction&quot;: { # 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&#x27;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 is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` 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. # Pins one or more specified products to a specific position in the results.
+      &quot;pinMap&quot;: { # 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](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+        &quot;a_key&quot;: &quot;A String&quot;,
+      },
+    },
     &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
       &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
     },
@@ -749,6 +774,11 @@ <h3>Method Details</h3>
         &quot;A String&quot;,
       ],
     },
+    &quot;pinAction&quot;: { # 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&#x27;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 is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` 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. # Pins one or more specified products to a specific position in the results.
+      &quot;pinMap&quot;: { # 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](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
+        &quot;a_key&quot;: &quot;A String&quot;,
+      },
+    },
     &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
       &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
     },