fix(retail): update the API

#### retail:v2alpha

The following keys were changed:
- schemas.GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult.description
- schemas.GoogleCloudRetailV2alphaProduct.properties.availability.description

#### retail:v2beta

The following keys were changed:
- schemas.GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult.description
- schemas.GoogleCloudRetailV2betaProduct.properties.availability.description

#### retail:v2

The following keys were changed:
- schemas.GoogleCloudRetailV2CompleteQueryResponseAttributeResult.description
- schemas.GoogleCloudRetailV2Product.properties.availability.description

Author: yoshi-automation

discovery/retail-v2.json

@@ -2092,7 +2092,7 @@
       }
     }
   },
-  "revision": "20240816",
+  "revision": "20240822",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -2732,7 +2732,7 @@
       "type": "object"
     },
     "GoogleCloudRetailV2CompleteQueryResponseAttributeResult": {
-      "description": "Resource that represents attribute results.",
+      "description": "Resource that represents attribute results. The list of suggestions for the attribute.",
       "id": "GoogleCloudRetailV2CompleteQueryResponseAttributeResult",
       "properties": {
         "suggestions": {
@@ -3945,7 +3945,7 @@
           "description": "The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product."
         },
         "availability": {
-          "description": "The online availability of the Product. Default to Availability.IN_STOCK. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).",
+          "description": "The online availability of the Product. 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).",
           "enum": [
             "AVAILABILITY_UNSPECIFIED",
             "IN_STOCK",

discovery/retail-v2alpha.json

@@ -2613,7 +2613,7 @@
       }
     }
   },
-  "revision": "20240816",
+  "revision": "20240822",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -4043,7 +4043,7 @@
       "type": "object"
     },
     "GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult": {
-      "description": "Resource that represents attribute results.",
+      "description": "Resource that represents attribute results. The list of suggestions for the attribute.",
       "id": "GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult",
       "properties": {
         "suggestions": {
@@ -5768,7 +5768,7 @@
           "description": "The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product."
         },
         "availability": {
-          "description": "The online availability of the Product. Default to Availability.IN_STOCK. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).",
+          "description": "The online availability of the Product. 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).",
           "enum": [
             "AVAILABILITY_UNSPECIFIED",
             "IN_STOCK",

discovery/retail-v2beta.json

@@ -2237,7 +2237,7 @@
       }
     }
   },
-  "revision": "20240816",
+  "revision": "20240822",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -4386,7 +4386,7 @@
       "type": "object"
     },
     "GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult": {
-      "description": "Resource that represents attribute results.",
+      "description": "Resource that represents attribute results. The list of suggestions for the attribute.",
       "id": "GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult",
       "properties": {
         "suggestions": {
@@ -5746,7 +5746,7 @@
           "description": "The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product."
         },
         "availability": {
-          "description": "The online availability of the Product. Default to Availability.IN_STOCK. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).",
+          "description": "The online availability of the Product. 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).",
           "enum": [
             "AVAILABILITY_UNSPECIFIED",
             "IN_STOCK",

src/apis/retail/v2.ts

@@ -1539,7 +1539,7 @@ export namespace retail_v2 {
     recentSearchResults?: Schema$GoogleCloudRetailV2CompleteQueryResponseRecentSearchResult[];
   }
   /**
-   * Resource that represents attribute results.
+   * Resource that represents attribute results. The list of suggestions for the attribute.
    */
   export interface Schema$GoogleCloudRetailV2CompleteQueryResponseAttributeResult {
     suggestions?: string[] | null;
@@ -2409,7 +2409,7 @@ export namespace retail_v2 {
      */
     audience?: Schema$GoogleCloudRetailV2Audience;
     /**
-     * The online availability of the Product. Default to Availability.IN_STOCK. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+     * The online availability of the Product. 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).
      */
     availability?: string | null;
     /**

src/apis/retail/v2alpha.ts

@@ -723,7 +723,7 @@ export namespace retail_v2alpha {
     recentSearchResults?: Schema$GoogleCloudRetailV2alphaCompleteQueryResponseRecentSearchResult[];
   }
   /**
-   * Resource that represents attribute results.
+   * Resource that represents attribute results. The list of suggestions for the attribute.
    */
   export interface Schema$GoogleCloudRetailV2alphaCompleteQueryResponseAttributeResult {
     suggestions?: string[] | null;
@@ -1938,7 +1938,7 @@ export namespace retail_v2alpha {
      */
     audience?: Schema$GoogleCloudRetailV2alphaAudience;
     /**
-     * The online availability of the Product. Default to Availability.IN_STOCK. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+     * The online availability of the Product. 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).
      */
     availability?: string | null;
     /**

src/apis/retail/v2beta.ts

@@ -1212,7 +1212,7 @@ export namespace retail_v2beta {
     recentSearchResults?: Schema$GoogleCloudRetailV2betaCompleteQueryResponseRecentSearchResult[];
   }
   /**
-   * Resource that represents attribute results.
+   * Resource that represents attribute results. The list of suggestions for the attribute.
    */
   export interface Schema$GoogleCloudRetailV2betaCompleteQueryResponseAttributeResult {
     suggestions?: string[] | null;
@@ -2197,7 +2197,7 @@ export namespace retail_v2beta {
      */
     audience?: Schema$GoogleCloudRetailV2betaAudience;
     /**
-     * The online availability of the Product. Default to Availability.IN_STOCK. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+     * The online availability of the Product. 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).
      */
     availability?: string | null;
     /**