Package google.assistant.devices.v1alpha2

সূচক

ডিভাইস প্ল্যাটফর্ম সার্ভিস

এই পরিষেবাটি নন-Google ডিভাইসগুলি পরিচালনা করে৷ বর্তমানে এটি বিকাশকারীদের প্রদান করে: * ডিভাইস মডেল নিবন্ধনের জন্য একটি API; * ডিভাইস ইনস্ট্যান্স রেজিস্ট্রেশনের জন্য একটি API।

ডিভাইস মডেল রেজিস্ট্রেশন ডিভাইস মডেল তৈরি এবং পরিচালনা করে, যার মধ্যে সেই মডেলের সমস্ত ডিভাইস জুড়ে শেয়ার করা ক্ষমতা এবং কনফিগারেশন রয়েছে।

ডিভাইস ইন্সট্যান্স রেজিস্ট্রেশন তার মডেলে সংজ্ঞায়িত ক্ষমতা এবং কনফিগারেশনের উপর ভিত্তি করে একটি ডিভাইসের ইন্সট্যান্স ইনস্ট্যান্সিয়েট করে এবং ডেভেলপারকে ডিভাইসের মধ্যে পরিবর্তিত কিছু অ্যাটির্বিউট সংজ্ঞায়িত করার অনুমতি দেয়। রেজিস্ট্রেশনের পরে এক্সিকিউশনের সময়, প্রতিটি gRPC অনুরোধে ডিভাইস_মডেল_আইডি এবং ডিভাইস_আইডি উভয়ই প্রয়োজন হয় এবং Google সহকারী API-এর প্রয়োজন উভয় আইডি ইতিমধ্যে নিবন্ধিত, অন্যথায় একটি ত্রুটি ফেরত দেওয়া হবে।

ডিভাইস তৈরি করুন

rpc CreateDevice( CreateDeviceRequest ) returns ( Device )

একটি ডিভাইস নিবন্ধন করুন, সফল হলে ডিভাইসটি ফেরত দিন বা ডিভাইসটি ইতিমধ্যে বিদ্যমান বা ব্যর্থ হলে ত্রুটি।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

ডিভাইস মডেল তৈরি করুন

rpc CreateDeviceModel( CreateDeviceModelRequest ) returns ( DeviceModel )

একটি 3p ডিভাইস মডেল তৈরি করুন।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

ডিভাইস মুছুন

rpc DeleteDevice( DeleteDeviceRequest ) returns ( Empty )

ব্যবহারকারীর মালিকানাধীন একটি নির্দিষ্ট ডিভাইস মুছে দেয়। সফল হলে খালি রিটার্ন করুন, অন্যথায় ডিভাইস খুঁজে পাওয়া যায়নি বা মুছে ফেলতে ব্যর্থ বলে একটি ত্রুটি।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

ডিভাইস মডেল মুছুন

rpc DeleteDeviceModel( DeleteDeviceModelRequest ) returns ( Empty )

একটি 3p ডিভাইস মডেল মুছুন।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

GetDevice

rpc GetDevice( GetDeviceRequest ) returns ( Device )

ব্যবহারকারীর মালিকানাধীন একটি নির্দিষ্ট ডিভাইসের সেটিং তথ্য পান, সফল হলে ডিভাইস ফেরত দিন বা ব্যর্থ হলে ত্রুটি।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

GetDeviceModel

rpc GetDeviceModel( GetDeviceModelRequest ) returns ( DeviceModel )

একটি ডিভাইস মডেল আইডি দেওয়া, একটি ডিভাইস মডেল ফেরত.

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

ListDeviceModels

rpc ListDeviceModels( ListDeviceModelsRequest ) returns ( ListDeviceModelsResponse )

এই REST API কলের সাথে যুক্ত প্রজেক্ট আইডির জন্য ডিভাইস মডেলের তালিকা করুন।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

তালিকা ডিভাইস

rpc ListDevices( ListDevicesRequest ) returns ( ListDevicesResponse )

oauth টোকেনে প্রদত্ত প্রজেক্ট_আইডির মালিকানাধীন ডিভাইসগুলির তালিকা পান৷ ইউআরএল চেক করতে হবে এবং টোকেন একই project_id আছে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

ডিভাইস মডেল আপডেট করুন

rpc UpdateDeviceModel( UpdateDeviceModelRequest ) returns ( DeviceModel )

একটি ডিভাইস মডেল আপডেট করে, মডেলের নতুন সংস্করণ প্রদান করে। দ্রষ্টব্য: এটি একটি সম্পূর্ণ আপডেট যার অর্থ আপনাকে আপডেটের জন্য পুরো ডিভাইস মডেলটি পাঠাতে হবে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/assistant-sdk-prototype

আরও তথ্যের জন্য, প্রমাণীকরণ নির্দেশিকা দেখুন।

DeviceModelRequest তৈরি করুন

DevicesPlatformService.CreateDeviceModel-এর জন্য বার্তার অনুরোধ করুন।

ক্ষেত্র
parent

string

প্রজেক্টের রিসোর্সের নাম যেখানে ডিভাইস মডেল তৈরি করা হবে, ফর্ম projects/{project_id}

device_model

DeviceModel

ডিভাইস_মডেল তৈরি করা হবে।

ডিভাইসের অনুরোধ তৈরি করুন

DevicesPlatformService.CreateDevice-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
device

Device

ব্যবহারকারীর দ্বারা সরবরাহ করা কাঁচা ডিভাইস তথ্য. ডিভাইস_আইডি প্রকল্পের মালিকের দ্বারা নির্ধারিত প্রকল্পে অনন্য হওয়া উচিত।

parent

string

প্রজেক্টের নাম যে ডিভাইসটির অন্তর্গত, ফর্ম projects/{project_id}

DeleteDeviceModelRequest

DevicesPlatformService.DeleteDeviceModel-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
name

string

প্রজেক্টের রিসোর্সের নাম যেখানে ডিভাইস মডেল মুছে ফেলা হবে, ফর্ম projects/{project_id}/deviceModels/{device_model_id}

Delete Device Request

DevicesPlatformService.DeleteDevice-এর জন্য বার্তার অনুরোধ করুন।

ক্ষেত্র
name

string

প্রজেক্টের রিসোর্স নাম যেখানে ডিভাইসটি মুছে ফেলা হবে, ফর্ম projects/{project_id}/devices/{device_id} ।

যন্ত্র

ক্ষেত্র
name

string

ডিভাইসের রিসোর্স নাম, ফর্ম projects/{project_id}/devices/{device_id} । একটি ডিভাইস তৈরি করার সময় নামটি উপেক্ষা করা হয়।

id

string

প্রয়োজন। প্রকল্পের সুযোগে অনন্য ডিভাইস আইডি, ফর্ম্যাটটি ডেভেলপার দ্বারা সংজ্ঞায়িত করা হয়, যেমন, "06ba29e5-5f1c-1a89-303c-22de2580f2e2"। কনভার্স RPC পাঠানোর সময় অবশ্যই DeviceConfig.device_id এর সাথে মিল থাকতে হবে। এই আইডিটি FDR-এর জন্য রিসেটযোগ্য।

nickname

string

এই ডিভাইসের ডাকনাম দ্বারা নির্দিষ্ট করা হয়েছে, যেটি স্পিচ রিকগনিশন এবং ডিভাইস টার্গেটিং এর জন্য ব্যবহার করা হবে যখন ব্যবহারকারী একটি ডিভাইসের সাথে কথা বলে, যেমন, ব্যবহারকারী বলতে পারে "মাই স্মার্ট রোবটকে বামে সরান" যখন তার "মাই স্মার্ট রোবট" নামে একটি ডিভাইস থাকে।

model_id

string

প্রয়োজন। এজেন্ট-আইডি, যেমন, "উৎপাদক-2017-v2"-এর জন্য সমস্ত ডিভাইসের মধ্যে ডিভাইসটিকে অনন্যভাবে "শ্রেণী" (মডেল) সনাক্ত করে। মনে রাখবেন যে একটি প্রকল্পে একাধিক ভিন্ন ডিভাইস মডেল থাকতে পারে।

client_type

ClientType

প্রয়োজন। সহকারী SDK আপনার ডিভাইসে সহকারীকে সংহত করার জন্য দুটি বিকল্প প্রদান করে। এই ক্ষেত্রটি ক্লায়েন্টটি সহকারী SDK লাইব্রেরির উপর ভিত্তি করে বা SDK পরিষেবা API কল করার জন্য কিনা তা সনাক্ত করার জন্য।

ক্লায়েন্ট টাইপ

ক্লায়েন্টের ধরন সনাক্ত করে।

Enums
CLIENT_TYPE_UNSPECIFIED ক্লায়েন্টের ধরন জানা নেই, ডিফল্ট মান।
SDK_SERVICE SDK gRPC পরিষেবা API-এর জন্য, যা একটি নিম্ন স্তরের API প্রকাশ করে যা সরাসরি সহকারী অনুরোধ এবং প্রতিক্রিয়ার অডিও বাইটগুলিকে ম্যানিপুলেট করে। Service
SDK_LIBRARY Google সহকারী ক্লায়েন্ট লাইব্রেরির জন্য, একটি উচ্চ স্তরের, ইভেন্ট-ভিত্তিক API সহ একটি টার্নকি সমাধান।

ডিভাইস মডেল

ডিভাইসগুলির একটি পরিবারের জন্য মেটাডেটা সংজ্ঞায়িত করে একটি ডিভাইস মডেল ডিভাইসগুলির একটি পরিবারের জন্য সাধারণ ক্ষমতাকেও সংজ্ঞায়িত করে৷

ক্ষেত্র
name

string

ডিভাইস মডেলের রিসোর্স নাম, ফর্ম projects/project-id/deviceModels/device-model-id

device_model_id

string

প্রয়োজন। ডেভেলপার দ্বারা নির্দিষ্ট করা গ্লোবাল ইউনিক আইডি, যেমন "comcast-voice-assistant-2017-v1"। যদি একটি ডিভাইস মডেল আইডি ইতিমধ্যেই বিদ্যমান থাকে, তাহলে একটি ত্রুটি ফেরত দেওয়া হবে৷

project_id

string

প্রয়োজন। ডিভাইস মডেলের সাথে যুক্ত ক্লাউড প্রকল্প আইডি। প্রতিটি প্রকল্প একাধিক ডিভাইস মডেল তৈরি করার অনুমতি দেওয়া হয়.

device_type

string

প্রয়োজন। কিছু বৈধ ডিভাইসের ধরন: "action.devices.types.LIGHT" "action.devices.types.OUTLET" "action.devices.types.SWITCH" "action.devices.types.AC_HEATING"

traits[]

string

ডিভাইসটি সমর্থন করতে পারে এমন অন্তর্নির্মিত বৈশিষ্ট্যগুলির ঐচ্ছিক তালিকা৷ যেমন: "action.devices.traits.OnOff"

manifest

Manifest

প্রয়োজন। মেটাডেটা যা ডিভাইস মডেল এবং প্রস্তুতকারকের বর্ণনা করে। এটি SDK কনসোল, মেট্রিক্স ড্যাশবোর্ড এবং অন্যান্য সম্পর্কিত ভিজ্যুয়াল ইন্টারফেসে দেখানো হবে।

execution_modes[]

ExecutionMode

ডিভাইস অ্যাকশনের জন্য ঐচ্ছিক এক্সিকিউশন মোড। DIRECT_RESPONSE সেট করা থাকলে, ডিভাইস নিয়ন্ত্রণের জন্য ডিভাইসগুলি সক্ষম করা হয়।

এক্সিকিউশন মোড

ডিভাইস অ্যাকশনের জন্য এক্সিকিউশন মোড, বর্তমান শুধুমাত্র সরাসরি প্রতিক্রিয়া সমর্থন করে।

Enums
MODE_UNSPECIFIED উল্লিখিত না.
DIRECT_RESPONSE ডিভাইস সরাসরি নির্বাহ সমর্থন করে। ডিভাইস থেকে আসা প্রশ্নের জন্য, সহকারী কমান্ড এবং প্যারাম সহ DeviceControlRequest ফেরত দেবে।

GetDeviceModelRequest

DevicesPlatformService.GetDeviceModel-এর জন্য বার্তার অনুরোধ করুন।

ক্ষেত্র
name

string

প্রজেক্টের রিসোর্সের নাম যেখানে একটি ডিভাইস মডেল পেতে হবে, ফর্ম projects/{project_id}/deviceModels/{device_model_id}

GetDeviceRequest

DevicesPlatformService.GetDevice-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
name

string

projects/{project_id}/devices/{device_id} ফর্মের একটি ডিভাইস পেতে রিসোর্স নাম।

ListDeviceModelsRequest

DevicesPlatformService.ListDeviceModel-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
parent

string

projects/{project_id} ফর্মের ডিভাইস মডেলের রিসোর্স নাম অনুরোধ করা হচ্ছে

ListDeviceModelsresponse

DevicesPlatformService.CreateDeviceModel-এর জন্য প্রতিক্রিয়া বার্তা।

ক্ষেত্র
device_models[]

DeviceModel

ListDevicesRequest

DevicesPlatformService.ListDevices-এর জন্য অনুরোধ বার্তা।

ক্ষেত্র
parent

string

যে প্রোজেক্টের ডিভাইসগুলিকে আমরা তালিকাভুক্ত করতে চাই, তার নাম `projects/{project_id}' ফর্মের।

ListDevices Response

DevicesPlatformService.ListDevices-এর জন্য প্রতিক্রিয়া বার্তা।

ক্ষেত্র
devices[]

Device

প্রদত্ত প্রকল্পে এই ব্যবহারকারীর মালিকানাধীন সমস্ত ডিভাইস।

উদ্ভাসিত

মেটাডেটা যা ডিভাইস মডেল এবং প্রস্তুতকারকের বর্ণনা করে। এটি SDK কনসোল, মেট্রিক্স ড্যাশবোর্ড এবং অন্যান্য সম্পর্কিত ভিজ্যুয়াল ইন্টারফেসে দেখানো হবে।

ক্ষেত্র
manufacturer

string

প্রয়োজন। এই ডিভাইসের নির্মাতা যেমন “Google”।

product_name

string

প্রয়োজন। এই ডিভাইস মডেলের জন্য ভোক্তার মুখোমুখি পণ্যের নাম, যেমন "Google অ্যাসিস্ট্যান্ট প্রোটোটাইপ ডিভাইস"।

device_description

string

এই ডিভাইস মডেলের ঐচ্ছিক বর্ণনা, যেমন "Google এর স্মার্ট স্পিকার, Google Assistant বিল্ট-ইন সহ"।

UpdateDeviceModelRequest

DevicesPlatformService.UpdateDeviceModel-এর জন্য বার্তার অনুরোধ করুন।

ক্ষেত্র
name

string

প্রজেক্টের রিসোর্সের নাম যেখানে ডিভাইস মডেল আপডেট করা হবে, ফর্ম projects/{project_id}/deviceModels/{device_model_id}

device_model

DeviceModel

নতুন ডিভাইস মডেল ডেভেলপার আপডেট করতে চায়.