বৈশিষ্ট্য

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

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

কমান্ড

কমান্ড হলো কোনো বৈশিষ্ট্যের সাথে যুক্ত অনুরোধ। উদাহরণস্বরূপ, গুগল নেস্ট থার্মোস্ট্যাটের বর্তমান মোড বা তাপমাত্রা সেটপয়েন্ট পরিবর্তন করা।

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

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

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

ইভেন্টগুলি

ইভেন্টগুলি অ্যাসিঙ্ক্রোনাস এবং প্রতিটির জন্য একটি একক টপিকে গুগল ক্লাউড পাব/সাব দ্বারা পরিচালিত হয়। Project আইডি।

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

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

কাঠামো

ডিভাইস

থার্মোস্ট্যাট

ক্যামেরা

ডোরবেল