Generic product metadata

Represents generic product metadata, not specific to any product category.

Metadata attribute nameProducts count
colors10 388 654
contributors10 915 400
dimensions9 573 320
genderFit1 610 210
ingredients5 930 611
manufacturerCode9 592 563
numberOfItems889 221
power12 040
recommendedAge491 563
storageConditions182 268
volume780 975
weight4 759 440

generic.colors

Product color, an array of objects. See Product colors for the list of supported values and an example.

generic.contributors

Product contributors (book authors, music performers, etc.), a list of objects. Each contributor object has following attributes:

  • names — "lang" → "contributor" mapping
  • type — contributor type, string, one of the following:
    • author , editor , narrator , translator — for print and audio books
    • artist — artist (for music recordings: composer / musician etc.)
    • music_group — music group / band
    • choir — choir / chorus / large vocal ensemble
    • orchestra — large instrumental ensemble
{
    "product": {
        "metadata": {
            "generic": {
                "contributors": [
                    {
                        "names": {
                            "en": "John Smith"
                        },
                        "type": "author"
                    },
                    {
                        "names": {
                            "en": "Paul Jones"
                        },
                        "type": "editor"
                    }
                ]
            }
        }
    }
}

generic.dimensions

Product and packaging dimensions information. Product dimensions are represented by dimensions.product field, packaging dimensions — by dimensions.packaging . Each field can contain width, height, depth or length attributes, depending on the configuration of the product. Each of these attributes is a Measurement object.

"dimensions": {
    // Product dimensions, if available
    "product": {
        // Can contain "width", "height", "depth" and / or "length" attributes
        // Each attribute is a Measurement object
        "width": {
            "equals": {
                "value": 9.5,
                "unit": "cm"  // Supported values: ["cm"]
            }
        },
        "height": {
            "equals": {
                "value": 19.5,
                "unit": "cm"
            }
        }
        // ...
    },
    // Packaging dimensions, if available
    "packaging": {
        // Same structure as for product dimensions
    }
}

generic.genderFit

Gender fit of a product, string. Can be one of the following values: malefemaleunisex.

generic.ingredients

Product ingredients or materials. See Product ingredients for detailed information.

generic.manufacturerCode

Manufacturer product code, string.

generic.numberOfItems

Number of individual items that are included in the product as sold, a Measurement object.

generic.power

Mechanical or electrical product power (in watts), a Measurement object.

"power": {
    "equals": {
        "value": 750,
        "unit": "watt"
    }
}

generic.recommendedAge

Product's recommended age, a Measurement object. Most often contains a range, for example, 2-5 years or 18+ years.

"recommendedAge": {
    "greaterThan": {
        "value": 18,
        "unit": "year"
    }
}

generic.storageConditions

An object, describing product storage conditions. See Storage conditions for detailed information.

generic.volume

Product volume information, a Measurement object.

"volume": {
    "equals": {
        "value": 100,  // Volume value, floating point number
        "unit": "ml"   // Supported values: ["ml"]
    }
}

generic.weight

Product weight information, an object containing a combination of the following fields: net (net weight), gross (gross weight) or unknown (when we lack information whether it's net or gross weight). Each field is a Measurement object.

"weight": {
    "net": {
        "equals": {
            "value": 150.0,  // Weight value, floating point number
            "unit": "grams"  // Supported values: ["grams"]
        }
    },
    "gross": {
        "equals": {
            "value": 200.0,
            "unit": "grams"
        }
    }
}