chrome.permissions

বর্ণনা

ধারণা এবং ব্যবহার

একটি API দ্বারা প্রদত্ত ক্ষমতাগুলি বর্ণনা করার জন্য অনুমতি সতর্কতা বিদ্যমান, তবে এই সতর্কতাগুলির মধ্যে কিছু স্পষ্ট নাও হতে পারে৷ পারমিশন এপিআই ডেভেলপারদের অনুমতির সতর্কতা ব্যাখ্যা করতে এবং ধীরে ধীরে নতুন বৈশিষ্ট্য প্রবর্তন করতে দেয় যা ব্যবহারকারীদের এক্সটেনশনের ঝুঁকিমুক্ত ভূমিকা দেয়। এইভাবে, ব্যবহারকারীরা নির্দিষ্ট করতে পারেন যে তারা কতটা অ্যাক্সেস দিতে ইচ্ছুক এবং কোন বৈশিষ্ট্যগুলি তারা সক্ষম করতে চান৷

উদাহরণস্বরূপ, ঐচ্ছিক অনুমতি এক্সটেনশনের মূল কার্যকারিতা নতুন ট্যাব পৃষ্ঠাকে ওভাররাইড করছে৷ একটি বৈশিষ্ট্য ব্যবহারকারীর দিনের লক্ষ্য প্রদর্শন করছে। এই বৈশিষ্ট্যটির জন্য শুধুমাত্র স্টোরেজ অনুমতি প্রয়োজন, যার মধ্যে একটি সতর্কতা অন্তর্ভুক্ত নয়। এক্সটেনশনটির একটি অতিরিক্ত বৈশিষ্ট্য রয়েছে, যা ব্যবহারকারীরা নিম্নলিখিত বোতামে ক্লিক করে সক্ষম করতে পারেন:

ব্যবহারকারীর শীর্ষস্থানীয় সাইটগুলি প্রদর্শনের জন্য শীর্ষস্থানীয় সাইটগুলির অনুমতি প্রয়োজন, যার জন্য নিম্নলিখিত সতর্কতা রয়েছে৷

ঐচ্ছিক অনুমতি প্রয়োগ করুন

ধাপ 1: কোন অনুমতি প্রয়োজন এবং কোনটি ঐচ্ছিক তা নির্ধারণ করুন

একটি এক্সটেনশন প্রয়োজনীয় এবং ঐচ্ছিক উভয় অনুমতি ঘোষণা করতে পারে। সাধারণভাবে, আপনার উচিত:

• আপনার এক্সটেনশনের মৌলিক কার্যকারিতার জন্য প্রয়োজনীয় অনুমতিগুলি ব্যবহার করুন।
• আপনার এক্সটেনশনের ঐচ্ছিক বৈশিষ্ট্যগুলির জন্য যখন তাদের প্রয়োজন হয় তখন ঐচ্ছিক অনুমতিগুলি ব্যবহার করুন৷

প্রয়োজনীয় অনুমতির সুবিধা:

• কম প্রম্পট: একটি এক্সটেনশন ব্যবহারকারীকে একবার সমস্ত অনুমতি গ্রহণ করার জন্য অনুরোধ করতে পারে।
• সহজ উন্নয়ন: প্রয়োজনীয় অনুমতি উপস্থিত থাকার গ্যারান্টি দেওয়া হয়।

ঐচ্ছিক অনুমতির সুবিধা:

• উন্নত নিরাপত্তা: এক্সটেনশনগুলি কম অনুমতির সাথে চালিত হয় যেহেতু ব্যবহারকারীরা শুধুমাত্র প্রয়োজনীয় অনুমতিগুলি সক্ষম করে৷
• ব্যবহারকারীদের জন্য আরও ভাল তথ্য: একটি এক্সটেনশন ব্যাখ্যা করতে পারে কেন এটির একটি নির্দিষ্ট অনুমতি প্রয়োজন যখন ব্যবহারকারী প্রাসঙ্গিক বৈশিষ্ট্যটি সক্ষম করে৷
• আরও সহজ আপগ্রেড: আপনি যখন আপনার এক্সটেনশন আপগ্রেড করবেন, আপগ্রেড প্রয়োজনীয় অনুমতির পরিবর্তে ঐচ্ছিক যোগ করলে Chrome আপনার ব্যবহারকারীদের জন্য এটিকে অক্ষম করবে না।

ধাপ 2: ম্যানিফেস্টে ঐচ্ছিক অনুমতি ঘোষণা করুন

আপনার এক্সটেনশন ম্যানিফেস্টে ঐচ্ছিক অনুমতিগুলিকে optional_permissions কী দিয়ে ঘোষণা করুন, অনুমতি ক্ষেত্রের মতো একই বিন্যাস ব্যবহার করে:

{
  "name": "My extension",
  ...
  "optional_permissions": ["tabs"],
  "optional_host_permissions": ["https://www.google.com/"],
  ...
}

আপনি যদি এমন হোস্টগুলির জন্য অনুরোধ করতে চান যেগুলি আপনি শুধুমাত্র রানটাইমে আবিষ্কার করেন, তাহলে আপনার এক্সটেনশনের optional_host_permissions ক্ষেত্রে "https://*/*" অন্তর্ভুক্ত করুন। এটি আপনাকে "Permissions.origins" -এ যেকোন উত্স নির্দিষ্ট করতে দেয় যতক্ষণ না এটির একটি মিলে যাওয়া স্কিম থাকে৷

অনুমতি যে ঐচ্ছিক হিসাবে নির্দিষ্ট করা যাবে না

বেশিরভাগ Chrome এক্সটেনশন অনুমতিগুলি নিম্নলিখিত ব্যতিক্রমগুলি সহ ঐচ্ছিক হিসাবে নির্দিষ্ট করা যেতে পারে৷

উপলব্ধ অনুমতি এবং তাদের সতর্কতা সম্পর্কে আরও তথ্যের জন্য অনুমতি ঘোষণা দেখুন।

ধাপ 3: ঐচ্ছিক অনুমতির অনুরোধ করুন

permissions.request() ব্যবহার করে ব্যবহারকারীর অঙ্গভঙ্গির মধ্যে থেকে অনুমতির জন্য অনুরোধ করুন :

document.querySelector('#my-button').addEventListener('click', (event) => {
  // Permissions must be requested from inside a user gesture, like a button's
  // click handler.
  chrome.permissions.request({
    permissions: ['tabs'],
    origins: ['https://www.google.com/']
  }, (granted) => {
    // The callback argument will be true if the user granted the permissions.
    if (granted) {
      doSomething();
    } else {
      doSomethingElse();
    }
  });
});

ক্রোম ব্যবহারকারীকে অনুরোধ করে যদি অনুমতি যোগ করার ফলে ব্যবহারকারী ইতিমধ্যে দেখেছেন এবং গ্রহণ করেছেন তার চেয়ে ভিন্ন সতর্কতা বার্তা আসে। উদাহরণস্বরূপ, পূর্ববর্তী কোডটি এইরকম একটি প্রম্পট হতে পারে:

ধাপ 4: এক্সটেনশনের বর্তমান অনুমতি পরীক্ষা করুন

আপনার এক্সটেনশনের একটি নির্দিষ্ট অনুমতি বা অনুমতির সেট আছে কিনা তা পরীক্ষা করতে, permission.contains() ব্যবহার করুন :

chrome.permissions.contains({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (result) => {
  if (result) {
    // The extension has the permissions.
  } else {
    // The extension doesn't have the permissions.
  }
});

ধাপ 5: অনুমতিগুলি সরান

যখন আপনার আর প্রয়োজন হয় না তখন আপনার অনুমতিগুলি সরানো উচিত। অনুমতি মুছে ফেলার পরে, permissions.request() কল করলে সাধারণত ব্যবহারকারীকে অনুরোধ না করেই আবার অনুমতি যোগ করা হয়।

chrome.permissions.remove({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (removed) => {
  if (removed) {
    // The permissions have been removed.
  } else {
    // The permissions have not been removed (e.g., you tried to remove
    // required permissions).
  }
});

chrome.permissions.addHostAccessRequest(
  request: object,
  callback?: function,
)

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.getAll(
  callback?: function,
)

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.removeHostAccessRequest(
  request: object,
  callback?: function,
)

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.onAdded.addListener(
  callback: function,
)

chrome.permissions.onRemoved.addListener(
  callback: function,
)