fix(retail): update the API

#### retail:v2alpha

The following keys were changed:
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.dataset.description
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.enableAttributeSuggestions.description
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.entity.description
- schemas.GoogleCloudRetailV2alphaCompleteQueryResponse.properties.attributeResults.description
- schemas.GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResult.properties.attributes.description
- schemas.GoogleCloudRetailV2alphaLocalInventory.properties.availability.description
- schemas.GoogleCloudRetailV2alphaLocalInventory.properties.placeId.description
- schemas.GoogleCloudRetailV2alphaSearchRequestBoostSpec.properties.conditionBoostSpecs.description

#### retail:v2beta

The following keys were changed:
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.dataset.description
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.enableAttributeSuggestions.description
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.entity.description
- schemas.GoogleCloudRetailV2betaCompleteQueryResponse.properties.attributeResults.description
- schemas.GoogleCloudRetailV2betaCompleteQueryResponseCompletionResult.properties.attributes.description
- schemas.GoogleCloudRetailV2betaLocalInventory.properties.availability.description
- schemas.GoogleCloudRetailV2betaLocalInventory.properties.placeId.description
- schemas.GoogleCloudRetailV2betaSearchRequestBoostSpec.properties.conditionBoostSpecs.description

#### retail:v2

The following keys were changed:
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.dataset.description
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.enableAttributeSuggestions.description
- resources.projects.resources.locations.resources.catalogs.methods.completeQuery.parameters.entity.description
- schemas.GoogleCloudRetailV2CompleteQueryResponse.properties.attributeResults.description
- schemas.GoogleCloudRetailV2CompleteQueryResponseCompletionResult.properties.attributes.description
- schemas.GoogleCloudRetailV2LocalInventory.properties.availability.description
- schemas.GoogleCloudRetailV2LocalInventory.properties.placeId.description
- schemas.GoogleCloudRetailV2SearchRequestBoostSpec.properties.conditionBoostSpecs.description

Author: yoshi-automation

discovery/retail-v2.json

@@ -128,7 +128,7 @@
                       "type": "string"
                     },
                     "dataset": {
-                      "description": "Determines which dataset to use for fetching completion. \"user-data\" will use the imported dataset through CompletionService.ImportCompletionData. \"cloud-retail\" will use the dataset generated by cloud retail based on user events. If leave empty, it will use the \"user-data\". Current supported values: * user-data * cloud-retail: This option requires enabling auto-learning function first. See [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-completion-dataset).",
+                      "description": "Determines which dataset to use for fetching completion. \"user-data\" will use the dataset imported through CompletionService.ImportCompletionData. `cloud-retail` will use the dataset generated by Cloud Retail based on user events. If left empty, completions will be fetched from the `user-data` dataset. Current supported values: * user-data * cloud-retail: This option requires enabling auto-learning function first. See [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-completion-dataset).",
                       "location": "query",
                       "type": "string"
                     },
@@ -138,12 +138,12 @@
                       "type": "string"
                     },
                     "enableAttributeSuggestions": {
-                      "description": "If true, attribute suggestions are enabled and provided in the response. This field is only available for the \"cloud-retail\" dataset.",
+                      "description": "If true, attribute suggestions are enabled and provided in the response. This field is only available for the `cloud-retail` dataset.",
                       "location": "query",
                       "type": "boolean"
                     },
                     "entity": {
-                      "description": "The entity for customers who run multiple entities, domains, sites, or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it must be an exact match with UserEvent.entity to get per-entity autocomplete results. Also, this entity should be limited to 256 characters, if too long, it will be truncated to 256 characters in both generation and serving time, and may lead to mis-match. To ensure it works, please set the entity with string within 256 characters.",
+                      "description": "The entity for customers who run multiple entities, domains, sites, or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it must be an exact match with UserEvent.entity to get per-entity autocomplete results. This field will be applied to `completion_results` only. It has no effect on the `attribute_results`. Also, this entity should be limited to 256 characters, if too long, it will be truncated to 256 characters in both generation and serving time, and may lead to mis-match. To ensure it works, please set the entity with string within 256 characters.",
                       "location": "query",
                       "type": "string"
                     },
@@ -2223,7 +2223,7 @@
       }
     }
   },
-  "revision": "20250314",
+  "revision": "20250417",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -2893,7 +2893,7 @@
           "additionalProperties": {
             "$ref": "GoogleCloudRetailV2CompleteQueryResponseAttributeResult"
           },
-          "description": "A map of matched attribute suggestions. This field is only available for \"cloud-retail\" dataset. Current supported keys: * `brands` * `categories`",
+          "description": "A map of matched attribute suggestions. This field is only available for `cloud-retail` dataset. Current supported keys: * `brands` * `categories`",
           "type": "object"
         },
         "attributionToken": {
@@ -2940,7 +2940,7 @@
           "additionalProperties": {
             "$ref": "GoogleCloudRetailV2CustomAttribute"
           },
-          "description": "Custom attributes for the suggestion term. * For \"user-data\", the attributes are additional custom attributes ingested through BigQuery. * For \"cloud-retail\", the attributes are product attributes generated by Cloud Retail. It requires UserEvent.product_details is imported properly.",
+          "description": "Custom attributes for the suggestion term. * For `user-data`, the attributes are additional custom attributes ingested through BigQuery. * For `cloud-retail`, the attributes are product attributes generated by Cloud Retail. It requires UserEvent.product_details is imported properly.",
           "type": "object"
         },
         "suggestion": {
@@ -3778,7 +3778,7 @@
           "type": "object"
         },
         "availability": {
-          "description": "Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered \"in stock\" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).",
+          "description": "Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered \"in stock\" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.",
           "enum": [
             "AVAILABILITY_UNSPECIFIED",
             "IN_STOCK",
@@ -3803,7 +3803,7 @@
           "type": "array"
         },
         "placeId": {
-          "description": "Required. The place ID for the current set of inventory information.",
+          "description": "Optional. The place ID for the current set of inventory information.",
           "type": "string"
         },
         "priceInfo": {
@@ -5275,7 +5275,7 @@
       "id": "GoogleCloudRetailV2SearchRequestBoostSpec",
       "properties": {
         "conditionBoostSpecs": {
-          "description": "Condition boost specifications. If a product matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
+          "description": "Condition boost specifications. If a product matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
           "items": {
             "$ref": "GoogleCloudRetailV2SearchRequestBoostSpecConditionBoostSpec"
           },

discovery/retail-v2alpha.json

@@ -326,7 +326,7 @@
                       "type": "string"
                     },
                     "dataset": {
-                      "description": "Determines which dataset to use for fetching completion. \"user-data\" will use the imported dataset through CompletionService.ImportCompletionData. \"cloud-retail\" will use the dataset generated by cloud retail based on user events. If leave empty, it will use the \"user-data\". Current supported values: * user-data * cloud-retail: This option requires enabling auto-learning function first. See [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-completion-dataset).",
+                      "description": "Determines which dataset to use for fetching completion. \"user-data\" will use the dataset imported through CompletionService.ImportCompletionData. `cloud-retail` will use the dataset generated by Cloud Retail based on user events. If left empty, completions will be fetched from the `user-data` dataset. Current supported values: * user-data * cloud-retail: This option requires enabling auto-learning function first. See [guidelines](https://cloud.google.com/retail/docs/completion-overview#generated-completion-dataset).",
                       "location": "query",
                       "type": "string"
                     },
@@ -336,12 +336,12 @@
                       "type": "string"
                     },
                     "enableAttributeSuggestions": {
-                      "description": "If true, attribute suggestions are enabled and provided in the response. This field is only available for the \"cloud-retail\" dataset.",
+                      "description": "If true, attribute suggestions are enabled and provided in the response. This field is only available for the `cloud-retail` dataset.",
                       "location": "query",
                       "type": "boolean"
                     },
                     "entity": {
-                      "description": "The entity for customers who run multiple entities, domains, sites, or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it must be an exact match with UserEvent.entity to get per-entity autocomplete results. Also, this entity should be limited to 256 characters, if too long, it will be truncated to 256 characters in both generation and serving time, and may lead to mis-match. To ensure it works, please set the entity with string within 256 characters.",
+                      "description": "The entity for customers who run multiple entities, domains, sites, or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it must be an exact match with UserEvent.entity to get per-entity autocomplete results. This field will be applied to `completion_results` only. It has no effect on the `attribute_results`. Also, this entity should be limited to 256 characters, if too long, it will be truncated to 256 characters in both generation and serving time, and may lead to mis-match. To ensure it works, please set the entity with string within 256 characters.",
                       "location": "query",
                       "type": "string"
                     },
@@ -2800,7 +2800,7 @@
       }
     }
   },
-  "revision": "20250314",
+  "revision": "20250417",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -4260,7 +4260,7 @@
           "additionalProperties": {
             "$ref": "GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult"
           },
-          "description": "A map of matched attribute suggestions. This field is only available for \"cloud-retail\" dataset. Current supported keys: * `brands` * `categories`",
+          "description": "A map of matched attribute suggestions. This field is only available for `cloud-retail` dataset. Current supported keys: * `brands` * `categories`",
           "type": "object"
         },
         "attributionToken": {
@@ -4307,7 +4307,7 @@
           "additionalProperties": {
             "$ref": "GoogleCloudRetailV2alphaCustomAttribute"
           },
-          "description": "Custom attributes for the suggestion term. * For \"user-data\", the attributes are additional custom attributes ingested through BigQuery. * For \"cloud-retail\", the attributes are product attributes generated by Cloud Retail. It requires UserEvent.product_details is imported properly.",
+          "description": "Custom attributes for the suggestion term. * For `user-data`, the attributes are additional custom attributes ingested through BigQuery. * For `cloud-retail`, the attributes are product attributes generated by Cloud Retail. It requires UserEvent.product_details is imported properly.",
           "type": "object"
         },
         "facets": {
@@ -5578,7 +5578,7 @@
           "type": "object"
         },
         "availability": {
-          "description": "Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered \"in stock\" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).",
+          "description": "Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered \"in stock\" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.",
           "enum": [
             "AVAILABILITY_UNSPECIFIED",
             "IN_STOCK",
@@ -5603,7 +5603,7 @@
           "type": "array"
         },
         "placeId": {
-          "description": "Required. The place ID for the current set of inventory information.",
+          "description": "Optional. The place ID for the current set of inventory information.",
           "type": "string"
         },
         "priceInfo": {
@@ -7414,7 +7414,7 @@
       "id": "GoogleCloudRetailV2alphaSearchRequestBoostSpec",
       "properties": {
         "conditionBoostSpecs": {
-          "description": "Condition boost specifications. If a product matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
+          "description": "Condition boost specifications. If a product matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.",
           "items": {
             "$ref": "GoogleCloudRetailV2alphaSearchRequestBoostSpecConditionBoostSpec"
           },