কীভাবে স্মার্ট হোম অ্যাকশন তৈরি করতে হয় তা শেখার নতুন গন্তব্য Google হোম ডেভেলপার সেন্টারে স্বাগতম। দ্রষ্টব্য: আপনি অ্যাকশন কনসোলে নির্মাণ কাজ চালিয়ে যাবেন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

action.devices.QUERY

এই অভিপ্রায় ডিভাইসের বর্তমান অবস্থার জন্য আপনার পূর্ণতা সম্পর্কে প্রশ্ন করে, যার মধ্যে ডিভাইসটি অনলাইন এবং পৌঁছানো যায় কিনা।

আপনার QUERY প্রতিক্রিয়া শুধুমাত্র রাষ্ট্রীয় তথ্য প্রদান করবে। ডিভাইসের বৈশিষ্ট্য এবং বৈশিষ্ট্য আপডেট করা SYNC প্রতিক্রিয়া দ্বারা পরিচালিত হয়।

আরো বিস্তারিত জানার জন্য, ক্যোয়ারী এবং এক্সিকিউট দেখুন।

বিন্যাস অনুরোধ

ক্ষেত্র	টাইপ	বর্ণনা
`requestId`	স্ট্রিং	প্রয়োজন। অনুরোধের আইডি।
`inputs`	অ্যারে	প্রয়োজন। অভিপ্রায় অনুরোধের সাথে মিলে যাওয়া ইনপুটগুলির তালিকা৷
`[ item, ... ]`	অবজেক্ট	উদ্দেশ্য অনুরোধের সাথে যুক্ত টাইপ এবং পেলোড।
`intent`		প্রয়োজন। (ধ্রুবক মান: `"action.devices.QUERY"` ) উদ্দেশ্য অনুরোধের ধরন।
`payload`	অবজেক্ট	প্রয়োজন। QUERY অনুরোধ পেলোড৷
`devices`	অ্যারে	প্রয়োজন। লক্ষ্য ডিভাইসের তালিকা.
`[ item, ... ]`	অবজেক্ট	ক্যোয়ারী করার জন্য ডিভাইস টার্গেট।
`id`	স্ট্রিং	প্রয়োজন। SYNC এ প্রদত্ত আইডি অনুযায়ী ডিভাইস আইডি।
`customData`	অবজেক্ট	অস্বচ্ছ কাস্টমডেটা অবজেক্টটি SYNC-তে প্রদান করা হলে, এটি এখানে পাঠানো হয়।

উদাহরণ

QUERY উদ্দেশ্য অনুরোধ

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123",
            "customData": {
              "fooValue": 74,
              "barValue": true,
              "bazValue": "foo"
            }
          },
          {
            "id": "456",
            "customData": {
              "fooValue": 12,
              "barValue": false,
              "bazValue": "bar"
            }
          }
        ]
      }
    }
  ]
}

প্রতিক্রিয়া বিন্যাস

ক্ষেত্র	টাইপ	বর্ণনা
`requestId`	স্ট্রিং	প্রয়োজন। সংশ্লিষ্ট অনুরোধের আইডি।
`payload`	অবজেক্ট	প্রয়োজন। অভিপ্রায় প্রতিক্রিয়া পেলোড.
`errorCode`	স্ট্রিং	প্রমাণীকরণ ব্যর্থতা এবং বিকাশকারী সিস্টেম অনুপলব্ধতার জন্য সমগ্র লেনদেনের জন্য একটি ত্রুটি কোড। পৃথক ডিভাইস ত্রুটির জন্য ডিভাইস অবজেক্টের মধ্যে ত্রুটি কোড ব্যবহার করুন।
`debugString`	স্ট্রিং	বিশদ ত্রুটি যা ব্যবহারকারীদের কাছে কখনই উপস্থাপিত হবে না তবে বিকাশের সময় লগ করা বা ব্যবহার করা যেতে পারে।
`devices`	অবজেক্ট	প্রয়োজন। ডিভাইসের মানচিত্র। রাষ্ট্রীয় বৈশিষ্ট্যের অবজেক্টে ম্যাপ ডেভেলপার ডিভাইস আইডি।
`<string>`	অবজেক্ট	ডিভাইসের অবস্থা।
`online`	বুলিয়ান	প্রয়োজন। ডিভাইসটি অনলাইনে আছে কিনা তা নির্দেশ করে (অর্থাৎ পৌঁছানো যায়) বা না।
`status`	স্ট্রিং	প্রয়োজন। কোয়েরি অপারেশনের ফলাফল। সমর্থিত মান: `SUCCESS` ক্যোয়ারী সফল হয়েছে তা নিশ্চিত করুন। `OFFLINE` টার্গেট ডিভাইস অফলাইন অবস্থায় আছে বা পৌঁছানো যাচ্ছে না। `EXCEPTIONS` একটি প্রশ্নের সাথে যুক্ত একটি সমস্যা বা সতর্কতা আছে৷ প্রশ্ন সফল বা ব্যর্থ হতে পারে. আপনি যখন অন্য সংযুক্ত ডিভাইস সম্পর্কে অতিরিক্ত তথ্য পাঠাতে চান তখন এই অবস্থার ধরনটি সাধারণত সেট করা হয়৷ `ERROR` টার্গেট ডিভাইস জিজ্ঞাসা করতে অক্ষম.
`errorCode`	স্ট্রিং	প্রিসেট ত্রুটি কোডগুলি থেকে প্রয়োজন হলে ERROR অবস্থা প্রসারিত করা হচ্ছে, যা ব্যবহারকারীদের কাছে উপস্থাপিত ত্রুটিগুলিকে ম্যাপ করবে৷

উদাহরণ

QUERY অভিপ্রায় প্রতিক্রিয়া

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "123": {
        "on": true,
        "online": true,
        "status": "SUCCESS"
      },
      "456": {
        "on": true,
        "online": true,
        "status": "SUCCESS",
        "brightness": 80,
        "color": {
          "spectrumRgb": 16711935
        }
      }
    }
  }
}