1717package com .google .api .services .homegraph .v1 .model ;
1818
1919/**
20- * Dynamic JSON trait state payload conforming to `json_trait_schema.md`. Used for Category 2
21- * (vendor Matter clusters) and Category 3 (non-Matter capabilities) traits across all wire and
22- * internal paths, and for Category 1 traits on external JSON-only wire paths (e.g., `Query` with
23- * `JSON_TRAIT_ONLY`).
20+ * Represents a dynamic JSON trait state payload that conforms to `json_trait_schema.md`. This
21+ * message is used for Category 2 (vendor Matter clusters) and Category 3 (non-Matter capabilities)
22+ * traits across all wire and internal paths, and for Category 1 traits on external JSON-only wire
23+ * paths (for example, `Query` with `JSON_TRAIT_ONLY`).
2424 *
2525 * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
2626 * transmitted over HTTP when working with the HomeGraph API. For a detailed explanation see:
3333public final class JsonTrait extends com .google .api .client .json .GenericJson {
3434
3535 /**
36- * Optional. Trait attribute map conforming to the trait's registered JSON Schema.
36+ * Optional. Holds the trait attributes, which conform to the trait's registered JSON Schema.
3737 * The value may be {@code null}.
3838 */
3939 @ com .google .api .client .util .Key
4040 private java .util .Map <String , java .lang .Object > data ;
4141
4242 /**
43- * Required. Canonical symbolic trait ID per `json_trait_schema.md`: - Standard Matter (Cat 1):
44- * `matter.` (e.g., `matter.thermostat`) - Google / vendor Matter (Cat 1/2): `matter..` (e.g.,
45- * `matter.google.`, `matter.eve.utility`) - Non-Matter (Cat 3, any provider incl. Google):
46- * `ghp..` (e.g., `ghp.acme.warranty`, `ghp.google.`)
43+ * Required. Identifies the trait by its canonical four-segment capability ID, `capability...`: *
44+ * Standard or Google Matter (Category 1): `capability.matter.standard.` or
45+ * `capability.matter.google.`, for example `capability.matter.standard.Thermostat`. * Vendor
46+ * Matter (Category 2): `capability.matter..`. * Non-Matter (Category 3, from any provider
47+ * including Google): `capability.generic..`, for example `capability.generic.acme.Warranty`.
4748 * The value may be {@code null}.
4849 */
4950 @ com .google .api .client .util .Key
5051 private java .lang .String id ;
5152
5253 /**
53- * Optional. Trait attribute map conforming to the trait's registered JSON Schema.
54+ * Optional. Holds the trait attributes, which conform to the trait's registered JSON Schema.
5455 * @return value or {@code null} for none
5556 */
5657 public java .util .Map <String , java .lang .Object > getData () {
5758 return data ;
5859 }
5960
6061 /**
61- * Optional. Trait attribute map conforming to the trait's registered JSON Schema.
62+ * Optional. Holds the trait attributes, which conform to the trait's registered JSON Schema.
6263 * @param data data or {@code null} for none
6364 */
6465 public JsonTrait setData (java .util .Map <String , java .lang .Object > data ) {
@@ -67,21 +68,23 @@ public JsonTrait setData(java.util.Map<String, java.lang.Object> data) {
6768 }
6869
6970 /**
70- * Required. Canonical symbolic trait ID per `json_trait_schema.md`: - Standard Matter (Cat 1):
71- * `matter.` (e.g., `matter.thermostat`) - Google / vendor Matter (Cat 1/2): `matter..` (e.g.,
72- * `matter.google.`, `matter.eve.utility`) - Non-Matter (Cat 3, any provider incl. Google):
73- * `ghp..` (e.g., `ghp.acme.warranty`, `ghp.google.`)
71+ * Required. Identifies the trait by its canonical four-segment capability ID, `capability...`: *
72+ * Standard or Google Matter (Category 1): `capability.matter.standard.` or
73+ * `capability.matter.google.`, for example `capability.matter.standard.Thermostat`. * Vendor
74+ * Matter (Category 2): `capability.matter..`. * Non-Matter (Category 3, from any provider
75+ * including Google): `capability.generic..`, for example `capability.generic.acme.Warranty`.
7476 * @return value or {@code null} for none
7577 */
7678 public java .lang .String getId () {
7779 return id ;
7880 }
7981
8082 /**
81- * Required. Canonical symbolic trait ID per `json_trait_schema.md`: - Standard Matter (Cat 1):
82- * `matter.` (e.g., `matter.thermostat`) - Google / vendor Matter (Cat 1/2): `matter..` (e.g.,
83- * `matter.google.`, `matter.eve.utility`) - Non-Matter (Cat 3, any provider incl. Google):
84- * `ghp..` (e.g., `ghp.acme.warranty`, `ghp.google.`)
83+ * Required. Identifies the trait by its canonical four-segment capability ID, `capability...`: *
84+ * Standard or Google Matter (Category 1): `capability.matter.standard.` or
85+ * `capability.matter.google.`, for example `capability.matter.standard.Thermostat`. * Vendor
86+ * Matter (Category 2): `capability.matter..`. * Non-Matter (Category 3, from any provider
87+ * including Google): `capability.generic..`, for example `capability.generic.acme.Warranty`.
8588 * @param id id or {@code null} for none
8689 */
8790 public JsonTrait setId (java .lang .String id ) {
0 commit comments