অনুমতি API

যেকোনো হোম API ব্যবহার করার আগে, অ্যাপটির অবশ্যই ব্যবহারকারীর বাড়িতে ডিভাইস অ্যাক্সেস করার অনুমতি থাকতে হবে, যা API-এ কাঠামো হিসাবে উল্লেখ করা হয়েছে।

হোম APIগুলি কাঠামোর ডিভাইসগুলিতে অ্যাক্সেস দেওয়ার জন্য OAuth 2.0 ব্যবহার করে৷ OAuth একজন ব্যবহারকারীকে তাদের লগইন শংসাপত্রগুলি প্রকাশ না করেই একটি অ্যাপ বা পরিষেবার অনুমতি দেওয়ার অনুমতি দেয়৷ পারমিশন এপিআই-এর সাহায্যে ব্যবহারকারী তাদের Google অ্যাকাউন্ট ব্যবহার করে হোম এপিআই অ্যাপকে তাদের বাড়ির ডিভাইসে অ্যাক্সেস দিতে পারে।

পারমিশন এপিআই ব্যবহার করার জন্য আপনার অ্যাপ, Google ক্লাউড এবং Google Home Developer Console বেশ কয়েকটি ধাপ জড়িত:

1. Google ক্লাউডে OAuth সেট আপ করুন
   1. অ্যাপটিতে সাইন ইন করুন
   2. OAuth সম্মতি স্ক্রিন সেট আপ করুন
   3. অ্যাপটি নিবন্ধন করুন এবং শংসাপত্র তৈরি করুন
2. পারমিশন এপিআই ইন্টিগ্রেট করুন
   1. অনুমতির জন্য চেক করুন
   2. অনুমতি অনুরোধ
3. অনুমতি দিন
   1. অনুমতি পরিবর্তন করুন
   2. অনুমতি প্রত্যাহার করুন

Google ক্লাউডে OAuth সেট আপ করুন

আপনার যদি ইতিমধ্যেই একটি যাচাইকৃত OAuth ক্লায়েন্ট থাকে, তাহলে আপনি একটি নতুন সেট আপ না করেই সেই ক্লায়েন্টটি ব্যবহার করতে পারেন। আরও তথ্যের জন্য, আপনার যদি কোনো বিদ্যমান OAuth ক্লায়েন্ট থাকে তাহলে পড়ুন।

অ্যাপটিতে সাইন ইন করুন

1. Android Studio অ্যাপটি চালিয়ে একটি OAuth কী তৈরি করুন। আপনি যখন Android Studio একটি অ্যাপ চালান বা ডিবাগ করেন, তখন এটি স্বয়ংক্রিয়ভাবে বিকাশ এবং ডিবাগিংয়ের উদ্দেশ্যে একটি OAuth কী তৈরি করে। অ্যান্ড্রয়েড স্টুডিও দেখুন: সম্পূর্ণ ব্যাখ্যার জন্য আপনার ডিবাগ বিল্ড সাইন করুন ।

   আপনার স্থানীয় মেশিনে আপনার মোবাইল ডিভাইস সংযোগ করুন. Android Studio মডেল নম্বর দ্বারা আপনার সংযুক্ত ডিভাইস তালিকাভুক্ত করবে। তালিকা থেকে আপনার ডিভাইস নির্বাচন করুন, তারপর প্রকল্প চালান ক্লিক করুন। এটি আপনার মোবাইল ডিভাইসে নমুনা অ্যাপ তৈরি করে এবং ইনস্টল করে।

   আরও বিশদ নির্দেশাবলীর জন্য, Android বিকাশকারী সাইটে একটি হার্ডওয়্যার ডিভাইসে অ্যাপ্লিকেশন চালান দেখুন৷

   এখন চলমান অ্যাপটি বন্ধ করুন।

2. Google ক্লাউড কনসোল সহায়তা সাইটে OAuth 2.0 / নেটিভ অ্যাপ্লিকেশন / Android সেট আপ করার জন্য বিশদ নির্দেশাবলী অনুসরণ করে OAuth শংসাপত্রের SHA-1 ফিঙ্গারপ্রিন্ট পান৷

OAuth সম্মতি স্ক্রিন সেট আপ করুন

1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক ড্যাশবোর্ডে যান এবং OAuth শংসাপত্র তৈরি করতে আপনি যে প্রকল্পটি ব্যবহার করতে চান সেটি নির্বাচন করুন৷
2. APIs এবং পরিষেবা পৃষ্ঠাতে যান এবং নেভিগেশন মেনুতে শংসাপত্রে ক্লিক করুন।

3. আপনি যদি এখনও এই Google ক্লাউড প্রকল্পের জন্য আপনার সম্মতি স্ক্রীন কনফিগার না করে থাকেন, তাহলে কনফিগার সম্মতি স্ক্রীন বোতামটি প্রদর্শিত হবে। সেই ক্ষেত্রে, নিম্নলিখিত পদ্ধতি ব্যবহার করে আপনার সম্মতি স্ক্রিন কনফিগার করুন। অন্যথায়, পরবর্তী বিভাগে যান।

   1. সম্মতি স্ক্রীন কনফিগার করুন ক্লিক করুন। OAuth সম্মতি স্ক্রীন পৃষ্ঠা দেখায়।
   2. আপনার ব্যবহারের ক্ষেত্রে নির্ভর করে, অভ্যন্তরীণ বা বাহ্যিক নির্বাচন করুন এবং তারপরে তৈরি করুন ক্লিক করুন। OAuth সম্মতি স্ক্রিন প্যানে প্রদর্শিত হয়।
   3. অন-স্ক্রীন নির্দেশাবলী অনুসারে অ্যাপ তথ্য পৃষ্ঠায় তথ্য লিখুন এবং তারপর সংরক্ষণ করুন এবং চালিয়ে যান ক্লিক করুন। স্কোপস ফলক প্রদর্শন করে।
   4. আপনাকে কোনো স্কোপ যোগ করতে হবে না, তাই সংরক্ষণ করুন এবং চালিয়ে যান এ ক্লিক করুন। পরীক্ষা ব্যবহারকারী ফলক প্রদর্শন করে।
   5. আপনি যদি আপনার অ্যাপে অ্যাক্সেস পরীক্ষা করার জন্য ব্যবহারকারীদের যোগ করতে চান, ব্যবহারকারীদের যোগ করুন ক্লিক করুন। ব্যবহারকারী যোগ করুন ফলক প্রদর্শন করে। পরীক্ষা ব্যবহারকারীদের আপনার অ্যাপে অনুমতি দেওয়ার বিশেষাধিকার রয়েছে।
   6. খালি ক্ষেত্রে, এক বা একাধিক Google অ্যাকাউন্ট ইমেল ঠিকানা যোগ করুন এবং তারপর যোগ করুন ক্লিক করুন।
   7. সংরক্ষণ করুন এবং চালিয়ে যান ক্লিক করুন। সারাংশ ফলক প্রদর্শন করে।
   8. আপনার OAuth সম্মতি স্ক্রীন তথ্য পর্যালোচনা করুন, এবং তারপর ড্যাশবোর্ডে ফিরে যান ক্লিক করুন।

সম্পূর্ণ বিবরণের জন্য Google ক্লাউড কনসোল সহায়তা সাইটে আপনার OAuth সম্মতি স্ক্রীন সেট আপ করা দেখুন।

অ্যাপটি নিবন্ধন করুন এবং শংসাপত্র তৈরি করুন

OAuth 2.0 এর জন্য অ্যাপটি নিবন্ধন করতে এবং OAuth শংসাপত্র তৈরি করতে, OAuth 2.0 সেট আপ করার নির্দেশাবলী অনুসরণ করুন। আপনাকে অ্যাপের ধরন নির্দেশ করতে হবে, যা নেটিভ/অ্যান্ড্রয়েড অ্যাপ ।

Google ক্লাউড কনসোল সহায়তা সাইটে OAuth 2.0 / নেটিভ অ্যাপ্লিকেশান সেট আপ করার নির্দেশাবলী অনুসরণ করে Google ক্লাউড কনসোলে সেট আপ করা OAuth ক্লায়েন্টে অ্যাপটিতে সাইন করার সময় আপনি যে SHA-1 ফিঙ্গারপ্রিন্ট পেয়েছেন তা যোগ করুন।

আপনার স্থানীয় মেশিনের সাথে সংযুক্ত আপনার মোবাইল ডিভাইসের সাথে, তালিকা থেকে আপনার ডিভাইস নির্বাচন করুন, তারপর এটি চালানোর জন্য আবার প্রকল্প চালান ক্লিক করুন। আরও বিশদ নির্দেশাবলীর জন্য, Android বিকাশকারী সাইটে একটি হার্ডওয়্যার ডিভাইসে অ্যাপ্লিকেশন চালান দেখুন৷

পারমিশন এপিআই ইন্টিগ্রেট করুন

প্রদত্ত কাঠামোর মধ্যে ডিভাইসগুলি অ্যাক্সেস করার জন্য ব্যবহারকারীদের অবশ্যই আপনার অ্যাপে অনুমতি দিতে হবে। শুরু করার জন্য, নিশ্চিত করুন যে আপনি হোম এপিআইগুলি শুরু করেছেন। এই ধাপের homeManager উদাহরণ এখানে সমস্ত অনুমতি উদাহরণে ব্যবহৃত হয়।

প্রথমে, SDK-এর সাথে একটি ActivityResultCaller নিবন্ধন করুন। উদাহরণস্বরূপ, নমুনা অ্যাপটি এটি কীভাবে পরিচালনা করে:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    homeManager.registerActivityResultCallerForPermissions(this)
  }

অনুমতির জন্য চেক করুন

অনুমতির অনুরোধ করার আগে, আমরা আপনাকে অ্যাপের ব্যবহারকারী ইতিমধ্যে সম্মতি দিয়েছে কিনা তা পরীক্ষা করে দেখার পরামর্শ দিচ্ছি। এটি করার জন্য, PermissionsState মানগুলির একটি Flow পেতে হোম ইনস্ট্যান্সের hasPermissions() পদ্ধতিতে কল করুন:

val permissionsReadyState =
  homeManager.hasPermissions().collect { state ->
    state == PermissionsState.GRANTED ||
      state == PermissionsState.PERMISSIONS_STATE_UNAVAILABLE ||
      state == PermissionsState.NOT_GRANTED
    when (permissionsReadyState) {
      PermissionsState.GRANTED -> println("Permissions granted, no need to request permissions")
      PermissionsState.PERMISSIONS_STATE_UNAVAILABLE ->
        println("Permissions state unavailable, request permissions")
      PermissionsState.NOT_GRANTED ->
        println("OAuth permission is enabled but not granted yet, request permissions")
      else ->
        throw IllegalStateException(
          "HomeClient.hasPermissions state should be PermissionsState.GRANTED or " +
            "PermissionsState.PERMISSIONS_STATE_UNAVAILABLE")
  }
}

চেকটি যদি NOT_GRANTED বা PERMISSIONS_STATE_UNAVAILABLE এর একটি PermissionsState ফেরত দেয়, তাহলে আপনি অনুমতির জন্য অনুরোধ করতে চাইবেন৷ চেকটি যদি GRANTED একটি PermissionsState ফেরত দেয় কিন্তু structures() এর পরবর্তী কলে কোনো স্ট্রাকচার না আসে, তাহলে ব্যবহারকারী Google Home app (GHA) সেটিংস পৃষ্ঠার মাধ্যমে অ্যাপে অ্যাক্সেস প্রত্যাহার করেছেন এবং আপনার অনুমতির অনুরোধ করা উচিত। অন্যথায়, ব্যবহারকারীর ইতিমধ্যে অ্যাক্সেস থাকা উচিত।

অনুমতি অনুরোধ

একটি প্রদত্ত কাঠামোর মধ্যে কাঠামো এবং ডিভাইসগুলি অ্যাক্সেস করার জন্য আপনার অ্যাপকে অনুমতি দিতে হবে।

যদি ব্যবহারকারী ইতিমধ্যে অনুমতি না দিয়ে থাকেন, তাহলে অনুমতি UI চালু করতে হোম ইন্সট্যান্সের requestPermissions() পদ্ধতি ব্যবহার করুন এবং ফলাফল প্রক্রিয়া করুন:

fun requestPermissions(scope: CoroutineScope, onShowSnackbar: (String) -> Unit) {
  scope.launch {
    val result =
      try {
        homeManager.requestPermissions()
      } catch (e: HomeException) {
        PermissionsResult(
          PermissionsResultStatus.ERROR,
          "Got HomeException with error: ${e.message}",
        )
      }
    when (result.status) {
      PermissionsResultStatus.SUCCESS -> {
        Log.i(TAG, "Permissions successfully granted.")
      }
      PermissionsResultStatus.CANCELLED -> {
        Log.i(TAG, "User cancelled Permissions flow.")
        onShowSnackbar("User cancelled Permissions flow")
      }
      else -> {
        Log.e(
          TAG,
          "Failed to grant permissions with error: ${result.status}, ${result.errorMessage}",
        )
        onShowSnackbar("Failed to grant permissions with error: ${result.errorMessage}")
      }
    }
  }
}

অনুমতি UI সঠিকভাবে লঞ্চ করার জন্য, আপনি ইতিমধ্যেই আপনার অ্যাপের জন্য OAuth সেট আপ করেছেন।

অনুমতি দিন

এখন আপনি আপনার অ্যাপটি চালাতে সক্ষম হবেন এবং ব্যবহারকারীর অনুমতি দিতে হবে। আপনি Developer Console আপনার অ্যাপটি নিবন্ধিত করেছেন কিনা তার উপর নির্ভর করে যে ধরনের ব্যবহারকারীরা অনুমতি দিতে পারেন এবং যে ধরনের ডিভাইসের জন্য অনুমতি দেওয়ার জন্য উপলব্ধ তা আলাদা হবে৷

হোম API ব্যবহার করে একটি অ্যাপ প্রকাশ করতে Developer Console নিবন্ধন প্রয়োজন৷ হোম এপিআই পরীক্ষা এবং ব্যবহার করার প্রয়োজন নেই। কনসোল রেজিস্ট্রেশন বৈশিষ্ট্য অ্যাক্সেসের জন্য, আপনার Google Technical Account Manager (TAM) সাথে যোগাযোগ করুন।

যদি একটি অ্যাপ Developer Console নিবন্ধিত না থাকে , তাহলে এটি একটি যাচাইকৃত অবস্থায় থাকবে। হোম এপিআই-এর ব্যবহার পরীক্ষার জন্য এটি সুপারিশ করা হয়:

• শুধুমাত্র OAuth কনসোলে পরীক্ষামূলক ব্যবহারকারী হিসেবে নিবন্ধিত ব্যবহারকারীরাই অ্যাপের জন্য অনুমতি দিতে পারেন। একটি অসমাপ্ত অ্যাপের জন্য 100 জন পরীক্ষার্থীর সীমা রয়েছে৷

• একটি অযাচাই করা অ্যাপ হোম এপিআই ( Developer Console ডিভাইসের প্রকারের তালিকা) এর জন্য OAuth দ্বারা সমর্থিত যেকোনও ধরনের ডিভাইসের ডিভাইসে অ্যাক্সেস পাবে। একটি কাঠামোর সমস্ত ডিভাইস মঞ্জুর করা হবে।

যদি কোনো অ্যাপ Developer Console নিবন্ধিত থাকে এবং এক বা একাধিক ডিভাইস ধরনের অ্যাক্সেসের জন্য অনুমোদিত হয়েছে, এবং OAuth-এর জন্য ব্র্যান্ড যাচাইকরণ সম্পন্ন হয়েছে , এটি একটি যাচাইকৃত অবস্থায় থাকবে। উৎপাদনে একটি অ্যাপ চালু করার জন্য এই অবস্থার প্রয়োজন:

• পরীক্ষার ব্যবহারকারীর সীমা আর প্রযোজ্য নয়। যেকোন ব্যবহারকারী অ্যাপটিকে অনুমতি দিতে পারেন।
• ব্যবহারকারী শুধুমাত্র Developer Console অনুমোদিত ডিভাইসের প্রকারের অনুমতি দিতে পারে৷

এখন যেহেতু OAuth সেট আপ করা হয়েছে, অ্যাপ্লিকেশনটির requestPermissions() এর কল নিম্নলিখিত ডায়ালগগুলিকে ট্রিগার করে:

1. ব্যবহারকারীকে তারা যে Google অ্যাকাউন্টটি ব্যবহার করতে চান তা নির্বাচন করতে বলা হয়।
2. ব্যবহারকারীকে তারা অ্যাপটিকে অ্যাক্সেস দিতে চান এমন কাঠামো নির্বাচন করতে বলা হয়।
   1. একটি অযাচাই করা অ্যাপের জন্য, হোম এপিআই দ্বারা সমর্থিত সমস্ত ধরনের ডিভাইস অ্যাপে উপলব্ধ।
   2. একটি যাচাইকৃত অ্যাপের জন্য, ব্যবহারকারী শুধুমাত্র Developer Console অনুমোদিত ডিভাইসের প্রকারের অনুমতি দিতে পারে।
   3. সংবেদনশীল ডিভাইসের ধরনগুলির জন্য যেগুলি পরিচালনা করার জন্য অ্যাপটির অ্যাক্সেস রয়েছে, ব্যবহারকারী প্রতি-ডিভাইসের ভিত্তিতে অ্যাক্সেস সীমাবদ্ধ করতে পারেন। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারীর তিনটি লক থাকে, তবে তারা সেই লকগুলির মধ্যে শুধুমাত্র একটিতে অ্যাক্সেস মঞ্জুর করতে পারে।

একবার অনুমতি দেওয়া হলে, অ্যাপটি হোম এপিআই ব্যবহার করে কাঠামোর ডিভাইসগুলির অবস্থা পড়তে এবং নিয়ন্ত্রণ করতে পারে। ব্যবহারকারী যদি একটি নির্দিষ্ট ডিভাইসের ধরন বা সংবেদনশীল ডিভাইসের জন্য অ্যাপটিকে অনুমতি না দেন, তাহলে অ্যাপটি হোম API ব্যবহার করতে পারবে না, এটি অ্যাক্সেস, নিয়ন্ত্রণ বা স্বয়ংক্রিয়ভাবে করতে পারবে।

অনুমতি পরিবর্তন করুন

একটি ভিন্ন কাঠামোতে ডিভাইসগুলি অ্যাক্সেস করার অনুমতি দেওয়ার জন্য, ব্যবহারকারীকে Google অ্যাকাউন্ট এবং কাঠামো বাছাই করার অনুমতি দেওয়ার জন্য অ্যাকাউন্ট পিকার চালু করা যেতে পারে। এই প্রক্রিয়া চলাকালীন, ব্যবহারকারীকে আবার সম্মতি স্ক্রীনের সাথে উপস্থাপন করা হবে, এমনকি পূর্বে সম্মতি দেওয়া হলেও।

forceLaunch ফ্ল্যাগটি true হিসাবে সেট করে পুনরায় requestPermissions() কল করে এটি করা যেতে পারে:

homeManager.requestPermissions(forceLaunch=true)

অনুমতি প্রত্যাহার করুন

ব্যবহারকারীরা পূর্বে দেওয়া অ্যাক্সেস প্রত্যাহার করতে পারেন:

1. Google MyAccounts পৃষ্ঠা > ডেটা এবং গোপনীয়তা > তৃতীয় পক্ষের অ্যাপ ও পরিষেবার মাধ্যমে। এটি OAuth টোকেনটিকে প্রত্যাহার করবে যা প্রাথমিক সম্মতি প্রদানের সময় ইস্যু করা হয়েছিল এবং ব্যবহারকারী সমস্ত পৃষ্ঠায় (ফোন) এবং কাঠামো জুড়ে ব্যবহার করা অ্যাপের যেকোন উদাহরণে অ্যাক্সেস প্রত্যাহার করবে।

2. GHA > সেটিংস > লিঙ্কড অ্যাপস পৃষ্ঠার মাধ্যমে। GHA এর settings ক্লিক করলে সেটিংস পৃষ্ঠায় চলে যাবে। সেখান থেকে, লিঙ্কড অ্যাপস টাইলে ক্লিক করুন যা আপনাকে সম্মতি স্ক্রিনের মতো দেখতে একটি পৃষ্ঠায় নিয়ে যায়। এই পৃষ্ঠা থেকে ব্যবহারকারী অ্যাপের অ্যাক্সেস সরাতে পারেন। কোন ডিভাইসের ধরন বা নির্দিষ্ট সংবেদনশীল ডিভাইসগুলি অ্যাপটিতে অ্যাক্সেসযোগ্য তা পরিবর্তন করতে ব্যবহারকারী এই একই পৃষ্ঠাটি ব্যবহার করতে পারেন।

3. সরাসরি ওয়েবে লিঙ্কড অ্যাপস পৃষ্ঠার মাধ্যমে।

যদি আপনার একটি বিদ্যমান OAuth ক্লায়েন্ট থাকে

আপনার যদি ইতিমধ্যেই একটি প্রকাশিত অ্যাপের জন্য একটি যাচাইকৃত OAuth ক্লায়েন্ট থাকে, তাহলে আপনি হোম API পরীক্ষা করতে আপনার বিদ্যমান OAuth ক্লায়েন্ট ব্যবহার করতে পারেন।

হোম API গুলি পরীক্ষা এবং ব্যবহার করার জন্য Developer Console নিবন্ধনের প্রয়োজন নেই৷ যাইহোক, অন্য ইন্টিগ্রেশন থেকে আপনার যাচাইকৃত OAuth ক্লায়েন্ট থাকলেও আপনার অ্যাপটি প্রকাশ করার জন্য আপনাকে এখনও একটি অনুমোদিত Developer Console নিবন্ধনের প্রয়োজন হবে।

নিম্নলিখিত বিবেচনা প্রযোজ্য:

• একটি বিদ্যমান OAuth ক্লায়েন্ট ব্যবহার করার সময় 100-ব্যবহারকারীর সীমা রয়েছে। পরীক্ষার ব্যবহারকারীদের যোগ করার বিষয়ে তথ্যের জন্য, OAuth সম্মতি স্ক্রীন সেট আপ করুন দেখুন। OAuth যাচাইকরণের থেকে স্বাধীন, 100 জন ব্যবহারকারীর একটি Home API- আরোপিত সীমা রয়েছে যারা আপনার আবেদনের অনুমতি দিতে পারে। Developer Console নিবন্ধন সম্পূর্ণ হওয়ার পরে এই সীমাবদ্ধতা প্রত্যাহার করা হয়৷

• Developer Console নিবন্ধন হোম API-এর সাথে আপনার অ্যাপ আপডেট করার প্রস্তুতির জন্য আপনি যখন OAuth-এর মাধ্যমে ডিভাইস-টাইপ অনুদান সীমাবদ্ধ করতে প্রস্তুত তখন অনুমোদনের জন্য পাঠানো উচিত।

Google Cloud অ্যাপগুলির জন্য যেগুলি এখনও OAuth যাচাইকরণ মুলতুবি রয়েছে, যাচাইকরণ সম্পূর্ণ না হওয়া পর্যন্ত ব্যবহারকারীরা OAuth ফ্লো সম্পূর্ণ করতে পারবেন না। নিম্নলিখিত ত্রুটির সাথে অনুমতি দেওয়ার প্রচেষ্টা ব্যর্থ হবে:

Access blocked: <Project Name> has not completed the Google verification process.

OkGoogle অনুমতি

okGoogle কমান্ড একটি কাঠামো-স্তরের কমান্ড এবং কাঠামোর যেকোনো ডিভাইসকে স্বয়ংক্রিয় করতে ব্যবহার করা যেতে পারে। যাইহোক, একটি Home APIs অ্যাপের প্রতিটি ডিভাইসে অ্যাক্সেস নাও থাকতে পারে। নিম্নলিখিত সারণী বর্ণনা করে যে এই ধরনের ক্ষেত্রে অনুমতিগুলি কীভাবে প্রয়োগ করা হয়।