Google Cloud Retail: updateMask values must be snake_case despite being camelCase on the Product Interface #4195

Hey everyone, I was using this package and found some struggles and thought about a suggestion to the documentation around the ProductService methods on Google Cloud Retail.

Basically, there's an interface called IProduct that represents a product on Cloud Retail Service (CRS) that has all its properties in camelCase. The issue is, when you want to partially update a product, you need to specify in a property called updateMaskan array of strings that represents the properties to be updated and they MUST be in snake_case and not on camelCase like in the product interface.

This is what I needed to send on the updateProduct method to have a successful request

const request: IUpdateProductRequest ={
  "product": {
    "colorInfo": { <---- in camelCase
      "colors": [
        "aaa"
      ]
    },
    "priceInfo": {
      "priceRange": {
        "price": {
          "maximum": 210,
          "minimum": 190
        }
      }
    },
    "name": "projects/YOUR_PROJECT/locations/global/catalogs/default_catalog/branches/1/products/PRODUCT_ID"
  },
  "allowMissing": true,
  "updateMask": {
    "paths": [
      "color_info.colors", <----- in snake_case
      "price_info.price_range.price.maximum",
      "price_info.price_range.price.minimum"
    ]
  }
};

And in the documentation, there's no reference to this difference.
Plus, another struggled I got was, to using updateProduct, getProduct, the property name is the full path (with location+catalog + branch+product) and not the product name. For the importProducts there's a parent proper for this but it's better documented on what should be value.

Hope it helps other people in the future that face the same issue :D