--- /dev/null
+// Copyright 2018 Google Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.home.graph.v1;
+
+import "google/protobuf/struct.proto";
+
+option go_package = "google.golang.org/genproto/googleapis/home/graph/v1;graph";
+option java_outer_classname = "DeviceProto";
+option java_package = "com.google.home.graph.v1";
+
+// Third-party partner's device definition.
+message Device {
+ // Third-party partner's device ID.
+ string id = 1;
+
+ // Hardware type of the device (e.g. light, outlet, etc).
+ string type = 2;
+
+ // Traits supported by the device.
+ repeated string traits = 3;
+
+ // Name of the device given by the third party. This includes names given to
+ // the device via third party device manufacturer's app, model names for the
+ // device, etc.
+ DeviceNames name = 4;
+
+ // Indicates whether the state of this device is being reported to Google
+ // through ReportStateAndNotification call.
+ bool will_report_state = 5;
+
+ // If the third-party partner's cloud configuration includes placing devices
+ // in rooms, the name of the room can be provided here.
+ string room_hint = 6;
+
+ // As in roomHint, for structures that users set up in the partner's system.
+ string structure_hint = 7;
+
+ // Device manufacturer, model, hardware version, and software version.
+ DeviceInfo device_info = 8;
+
+ // Attributes for the traits supported by the device.
+ google.protobuf.Struct attributes = 9;
+
+ // Custom JSON data provided by the manufacturer and attached to QUERY and
+ // EXECUTE requests in AoG.
+ string custom_data = 10;
+}
+
+// Different names for the device.
+message DeviceNames {
+ // Primary name of the device, generally provided by the user.
+ string name = 1;
+
+ // Additional names provided by the user for the device.
+ repeated string nicknames = 2;
+
+ // List of names provided by the partner rather than the user, often
+ // manufacturer names, SKUs, etc.
+ repeated string default_names = 3;
+}
+
+// Device information.
+message DeviceInfo {
+ // Device manufacturer.
+ string manufacturer = 1;
+
+ // Device model.
+ string model = 2;
+
+ // Device hardware version.
+ string hw_version = 3;
+
+ // Device software version.
+ string sw_version = 4;
+}