বৈশিষ্ট্য

32 এল

SDM API-এর একটি বৈশিষ্ট্যের মধ্যে রয়েছে ক্ষেত্র , কমান্ড এবং ইভেন্ট ।

এসডিএম এপিআই-তে সমস্ত কল নিম্নলিখিত শেষ পয়েন্ট ব্যবহার করা উচিত:
https://smartdevicemanagement.googleapis.com/v1

ক্ষেত্র

ক্ষেত্রগুলি হল সাধারণ ডেটা প্রকারের মান, যেমন একটি সংখ্যা বা একটি স্ট্রিং। উদাহরণস্বরূপ, একটি ফিল্ডে একটি বর্তমান মোড বা Google নেস্ট থার্মোস্ট্যাটের পরিবেষ্টিত আর্দ্রতা থাকতে পারে।

পছন্দসই API এন্ডপয়েন্টে একটি GET কল দিয়ে বৈশিষ্ট্য এবং ক্ষেত্রগুলি দেখা যেতে পারে:

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

ডিভাইসের ধরন

sdm.devices.types. device-type SDM API দ্বারা প্রত্যাবর্তিত sdm.devices.types. device-type প্রকৃত ডিভাইসের কার্যকারিতা অনুমান করতে বা অনুমান করতে ব্যবহার করা উচিত নয় যা এটিকে বরাদ্দ করা হয়েছে৷ SDM API-তে আরও বৈশিষ্ট্য যুক্ত হওয়ার কারণে একটি নির্দিষ্ট ডিভাইসের জন্য একটি ডিভাইসের ধরন স্থিতিশীল থাকবে এমন কোনো গ্যারান্টি নেই। পরিবর্তে, ডিভাইসের জন্য ফিরে আসা বৈশিষ্ট্য ব্যবহার করুন।

পিতামাতার সম্পর্ক

parentRelations অবজেক্ট বর্তমান রিসোর্সের প্যারেন্ট রিসোর্স, হয় একটি স্ট্রাকচার বা রুম প্রতিনিধিত্ব করে। ডিসপ্লে নাম এর জন্য একটি স্ট্রাকচার-প্লেসহোল্ডার2201 intractureRoomInfo বৈশিষ্ট্য রুম প্যারেন্ট সহ ডিভাইসগুলির জন্য।

কমান্ড

কমান্ডগুলি একটি বৈশিষ্ট্যের সাথে যুক্ত অনুরোধ। যেমন, Google Nest Thermostat-এ বর্তমান মোড বা তাপমাত্রা সেটপয়েন্ট পরিবর্তন করা।

একটি কমান্ড একটি executeCommand API কল দ্বারা পাঠানো হয়:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

একটি কমান্ডের বেশিরভাগ প্রতিক্রিয়া একটি সাধারণ সাফল্য বা ব্যর্থতা। নির্দিষ্ট কমান্ড ব্যবহারের উদাহরণের জন্য পৃথক বৈশিষ্ট্য নির্দেশিকা দেখুন।

ঘটনা

Project ID প্রতি একটি একক বিষয়ে ইভেন্টগুলি অ্যাসিঙ্ক্রোনাস এবং Google Cloud Pub/Sub দ্বারা পরিচালিত।

একটি বৈশিষ্ট্য ক্ষেত্রের মান পরিবর্তনের জন্য ইভেন্টগুলি ডিফল্টরূপে পাঠানো হয়। এগুলি নির্দিষ্ট ডিভাইসের ক্রিয়া বা সংস্থান নিয়োগের পরিবর্তনের প্রতিক্রিয়া হিসাবেও পাঠানো যেতে পারে। আরও তথ্যের জন্য ইভেন্ট দেখুন।

বৈশিষ্ট্য বিভাগ

গঠন

বৈশিষ্ট্য
তথ্য	sdm.structures.traits.Info এই বৈশিষ্ট্যটি কাঠামো সম্পর্কিত তথ্যের জন্য যে কোনও কাঠামোর অন্তর্গত।
RoomInfo	sdm.structures.traits.RoomInfo এই বৈশিষ্ট্যটি রুম সম্পর্কিত তথ্যের জন্য যেকোন রুমের অন্তর্গত।

যন্ত্র

বৈশিষ্ট্য
সংযোগ	sdm.devices.traits.Connectivity এই বৈশিষ্ট্যটি যেকোন ডিভাইসের অন্তর্গত যা সংযোগের তথ্য রয়েছে৷
ফ্যান	sdm.devices.traits.Fan এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যার ফ্যান নিয়ন্ত্রণ করার সিস্টেম ক্ষমতা রয়েছে।
আর্দ্রতা	sdm.devices.traits.Humidity এই বৈশিষ্ট্যটি আর্দ্রতা পরিমাপ করার জন্য একটি সেন্সর আছে এমন যেকোনো ডিভাইসের অন্তর্গত।
তথ্য	sdm.devices.traits.Info ডিভাইস-সম্পর্কিত তথ্যের জন্য এই বৈশিষ্ট্যটি যেকোনো ডিভাইসের অন্তর্গত।
সেটিংস	sdm.devices.traits.Settings ডিভাইস-সম্পর্কিত সেটিংস তথ্যের জন্য এই বৈশিষ্ট্যটি যেকোনো ডিভাইসের অন্তর্গত।
তাপমাত্রা	sdm.devices.traits.Temperature এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যার তাপমাত্রা পরিমাপ করার জন্য একটি সেন্সর রয়েছে।

তাপস্থাপক

বৈশিষ্ট্য
ThermostatEco	sdm.devices.traits.ThermostatEco এই বৈশিষ্ট্যটি ইকো মোড সমর্থন করে এমন থার্মোস্ট্যাট ধরনের ডিভাইসের অন্তর্গত।
ThermostatHvac	sdm.devices.traits.ThermostatHvac এই বৈশিষ্ট্যটি থার্মোস্ট্যাটের ধরনের ডিভাইসের অন্তর্গত যা HVAC বিবরণ রিপোর্ট করতে পারে।
ThermostatMode	sdm.devices.traits.ThermostatMode এই বৈশিষ্ট্যটি বিভিন্ন থার্মোস্ট্যাট মোড সমর্থন করে এমন থার্মোস্ট্যাটের ডিভাইসের অন্তর্গত।
থার্মোস্ট্যাট তাপমাত্রা সেটপয়েন্ট	sdm.devices.traits.ThermostatTemperatureSetpoint এই বৈশিষ্ট্যটি থার্মোস্ট্যাটের ডিভাইসের অন্তর্গত যা লক্ষ্য তাপমাত্রা এবং তাপমাত্রা পরিসীমা নির্ধারণ করতে সহায়তা করে।

ক্যামেরা

বৈশিষ্ট্য
CameraClipPreview	sdm.devices.traits.CameraClipPreview এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা একটি ক্লিপ প্রিভিউ ডাউনলোড সমর্থন করে৷
CameraEvent Image	sdm.devices.traits.CameraEventImage এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ইভেন্ট থেকে ছবি তৈরি করতে সহায়তা করে।
Camera Image	sdm.devices.traits.CameraImage এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ছবি তোলা সমর্থন করে।
CameraLiveStream	sdm.devices.traits.CameraLiveStream এই বৈশিষ্ট্যটি লাইভ স্ট্রিমিং সমর্থন করে এমন যেকোনো ডিভাইসের অন্তর্গত।
CameraMotion	sdm.devices.traits.CameraMotion এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা গতি সনাক্তকরণ ইভেন্টগুলিকে সমর্থন করে৷
CameraPerson	sdm.devices.traits.CameraPerson এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা ব্যক্তি সনাক্তকরণ ইভেন্টগুলিকে সমর্থন করে৷
CameraSound	sdm.devices.traits.CameraSound এই বৈশিষ্ট্যটি যে কোনও ডিভাইসের অন্তর্গত যা শব্দ সনাক্তকরণ ইভেন্টগুলিকে সমর্থন করে৷

ডোরবেল

বৈশিষ্ট্য
DoorbellChime	sdm.devices.traits.DoorbellChime এই বৈশিষ্ট্যটি যেকোনও ডিভাইসের অন্তর্গত যা ডোরবেল কাইম এবং সম্পর্কিত প্রেস ইভেন্ট সমর্থন করে।