প্রাথমিক সেটআপ

ডেভেলপারের জন্য সেটআপ করুন

ক্লাউড প্রকল্পের জন্য API স্যুট সক্ষম করুন

  • ক্লাউড কনসোলে নেভিগেট করুন: https://console.cloud.google.com/
  • বিদ্যমান ক্লাউড প্রকল্প নির্বাচন করুন বা একটি নতুন তৈরি করুন।
  • APIs & Services > Enable APIs and Services
  • "Chrome" অনুসন্ধান করুন।
  • "Chrome Management API" নির্বাচন করুন।
  • পরিষেবার শর্তাবলীর সাথে নিজেকে পরিচিত করুন৷
  • Enable ক্লিক করুন।

শংসাপত্র তৈরি করুন

বিকল্প 1: OAuth 2.0 ক্লায়েন্ট আইডি

  • আপনি "OAuth 2.0 ক্লায়েন্ট আইডি" তৈরি করতে সক্ষম হওয়ার আগে আপনাকে প্রথমে আপনার আবেদন সম্পর্কে তথ্য সহ OAuth সম্মতি স্ক্রীন কনফিগার করতে হবে। ক্লাউড কনসোলে, APIs & Services > OAuth consent screen যান।
  • আপনার সম্মতি স্ক্রিন কনফিগারেশন পৃষ্ঠায়, স্কোপগুলি লিখুন:

    • রিপোর্ট API যোগ করার জন্য: https://www.googleapis.com/auth/chrome.management.reports.readonly
    • অ্যাপের বিবরণের জন্য API যোগ করুন: https://www.googleapis.com/auth/chrome.management.appdetails.readonly
    • টেলিমেট্রি API যোগ করার জন্য: https://www.googleapis.com/auth/chrome.management.telemetry.readonly

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

  • APIs & Services > Credentials > Create Credentials > OAuth client ID এবং শংসাপত্র তৈরি করতে পদক্ষেপগুলি অনুসরণ করুন।

  • ঐচ্ছিকভাবে, OAuth খেলার মাঠে আপনার অ্যাপটি পরীক্ষা করুন ( কীভাবে করবেন দেখুন)।

বিকল্প 2: পরিষেবা অ্যাকাউন্ট

  • APIs & Services > Credentials > Create Credentials > Service account যান।
  • পরিষেবা অ্যাকাউন্টের নাম লিখুন এবং Create ক্লিক করুন।
  • আপনার পরিষেবা অ্যাকাউন্টের জন্য একটি কী তৈরি করুন। Add Key ক্লিক করুন এবং "json" কী তৈরি করুন। একটি নিরাপদ অবস্থানে ফাইল ট্র্যাক রাখুন.
  • গ্রাহকের জন্য যথাযথ অ্যাডমিন সুবিধা সহ আপনার পরিষেবা অ্যাকাউন্ট ব্যবহার করুন:
    • গ্রাহক ডোমেন-ওয়াইড ডেলিগেশন সেট আপ করতে পারে এবং তারপর পরিষেবা অ্যাকাউন্টটি এমন একজন ব্যবহারকারী/প্রশাসকের ছদ্মবেশ ধারণ করতে পারে যার যথাযথ সুবিধা রয়েছে ( কীভাবে দেখুন)
    • অথবা গ্রাহক সরাসরি পরিষেবা অ্যাকাউন্টে যথাযথ সুযোগ-সুবিধা সহ একটি প্রশাসক ভূমিকা মঞ্জুর করতে পারে ( কীভাবে দেখুন)।

একটি গ্রাহকের জন্য সেটআপ

ডেভেলপার কোন ধরনের অ্যাপ্লিকেশন তৈরি করেছেন তার উপর নির্ভর করে গ্রাহক অ্যাডমিনের বিভিন্ন সেটআপ অপশন রয়েছে।

"OAuth 2.0 ক্লায়েন্ট" অ্যাপস

কোন বিশেষ সেটআপ প্রয়োজন নেই.

অ্যাপ ব্যবহারকারীদের যথাযথ অ্যাডমিন বিশেষাধিকার প্রয়োজন ( কীভাবে দেখুন)।

অ্যাপ ব্যবহারকারীদের অ্যাপ OAuth পপ-আপ সম্মতি স্ক্রিনে সম্মত হতে হবে। ঐচ্ছিকভাবে, আপনি এই অ্যাপটিকে ডোমেন-ওয়াইড ডেলিগেশন ( কীভাবে দেখুন) ব্যবহার করার অনুমতি দিতে পারেন, যা ব্যবহারকারীদের জন্য OAuth পপ-আপ সম্মতি স্ক্রীন বাদ দেবে।

ঐচ্ছিকভাবে অ্যাপটি ব্লক করা হয়নি কিনা তা যাচাই করুন, অথবা অ্যাপটিকে স্পষ্টভাবে বিশ্বাস করুন ( কীভাবে দেখুন)।

"পরিষেবা অ্যাকাউন্ট" অ্যাপস

পরিষেবা অ্যাকাউন্টটি অবশ্যই যথাযথ প্রশাসক বিশেষাধিকার প্রদান করতে হবে। আপনি দুটি উপায়ে এটি করতে পারেন:

  • ডোমেন-ওয়াইড ডেলিগেশনের অনুমতি দিন যাতে সার্ভিস অ্যাকাউন্ট এমন একজন প্রশাসকের ছদ্মবেশ ধারণ করতে পারে যার যথাযথ সুবিধা রয়েছে ( কীভাবে দেখুন)।
  • পরিষেবা অ্যাকাউন্টের জন্য সরাসরি প্রশাসক ভূমিকা প্রদান করুন ( কীভাবে দেখুন)।

"কিভাবে" নির্দেশিকা

কিভাবে একটি অ্যাপ্লিকেশন ব্লক বা বিশ্বাস

  • গ্রাহক অ্যাডমিন হিসাবে, অ্যাডমিন কনসোলে যান (https://admin.google.com/)।
  • Security > Access and data control > API controls নেভিগেট করুন।
  • App access control বিভাগে, Manage third party app access এ ক্লিক করুন।
  • আপনি 'সংযুক্ত অ্যাপস' তালিকায় অ্যাপটি দেখতে না পেলে, আপনি একটি নতুন অ্যাপ কনফিগার করতে পারেন।
  • আপনি এখন অ্যাপটিকে ব্লক করতে পারেন বা অ্যাপটিকে স্পষ্টভাবে বিশ্বাস করতে পারেন।

কিভাবে ডোমেইন-ওয়াইড ডেলিগেশন সক্ষম করবেন

  • গ্রাহক অ্যাডমিন হিসাবে, অ্যাডমিন কনসোলে যান (https://admin.google.com/)।
  • Security > Access and data control > API controls > Domain-wide delegation নেভিগেট করুন।
  • Add new ক্লিক করুন.
  • ক্লায়েন্ট আইডি লিখুন ("পরিষেবা অ্যাকাউন্ট অনন্য আইডি" বা "অ্যাপ ক্লায়েন্ট আইডি")।
  • সমস্ত প্রয়োজনীয় OAuth স্কোপ লিখুন। অ্যাপের উপর নির্ভর করে, আপনাকে ক্রোম ম্যানেজমেন্ট এপিআই-এর থেকেও বেশি কিছুর জন্য স্কোপ লিখতে হতে পারে; যেমন ডিভাইস, ব্যবহারকারী, ব্রাউজার, OU, গ্রুপ ইত্যাদি পরিচালনার জন্য ডিরেক্টরি API।
  • Authorize ক্লিক করুন.

প্রশাসক বিশেষাধিকারগুলি কীভাবে পরিচালনা করবেন

ক্রোম ম্যানেজমেন্ট API-এর বিভিন্ন অংশের জন্য, বিভিন্ন প্রশাসক বিশেষাধিকার প্রয়োজন। Reports API , App Details API , বা Telemetry API- এর জন্য কোন প্রশাসক বিশেষাধিকার প্রয়োজন তা দেখুন৷

বিশেষাধিকার প্রদান করতে:

  • গ্রাহক অ্যাডমিন হিসাবে, অ্যাডমিন কনসোলে যান (https://admin.google.com/)।
  • Admin roles পৃষ্ঠা নেভিগেট করুন.
  • একটি বিদ্যমান ভূমিকা খুঁজুন বা প্রয়োজনীয় সুযোগ-সুবিধা সহ একটি নতুন ভূমিকা তৈরি করুন৷
  • ব্যবহারকারীর ইমেল ঠিকানা বা পরিষেবা অ্যাকাউন্টের ইমেল ঠিকানায় এই ভূমিকাটি বরাদ্দ করুন।

OAuth খেলার মাঠে কীভাবে আপনার অ্যাপ পরীক্ষা করবেন

  • ক্লাউড কনসোলে, আপনার অ্যাপের জন্য একটি OAuth ক্লায়েন্ট আইডি তৈরি করার সময় (উপরে OAuth 2.0 ক্লায়েন্ট আইডি বিভাগ দেখুন) অ্যাপ্লিকেশনের ধরন "ওয়েব অ্যাপ্লিকেশন" নির্বাচন করুন।
  • একটি 'নাম' লিখুন।
  • আপনার অ্যাপ পরীক্ষা করতে, "অনুমোদিত পুনঃনির্দেশ URIs" ক্ষেত্রে https://developers.google.com/oauthplayground যোগ করুন। আপনার পরীক্ষা শেষ হয়ে গেলে আপনি আপনার অ্যাপ থেকে রিডাইরেক্ট URI মুছে ফেলতে পারেন।
  • "ক্লায়েন্ট আইডি" এবং "ক্লায়েন্ট সিক্রেট" Create এবং অনুলিপি করুন ক্লিক করুন।
  • OAuth খেলার মাঠে যান
  • উপরের ডানদিকের কোণায় গিয়ার আইকনে ক্লিক করুন ('OAuth 2.0 কনফিগারেশন'), Use your own OAuth credentials নির্বাচন করুন এবং "OAuth ক্লায়েন্ট আইডি" এবং "OAuth ক্লায়েন্ট সিক্রেট" লিখুন৷
  • OAuth খেলার মাঠে এই ধাপগুলি অনুসরণ করুন

    • API নির্বাচন করুন এবং অনুমোদন করুন।

      স্কোপ ইনপুট ক্ষেত্রে https://www.googleapis.com/auth/chrome.management.reports.readonly (বা অন্যান্য api স্কোপ) যোগ করুন এবং 'Authorize APIs'-এ ক্লিক করুন। একটি গ্রাহক অ্যাডমিন অ্যাকাউন্ট ব্যবহার করে অনুমোদন করুন। শর্তাবলী সম্মত.

    • টোকেন জন্য এক্সচেঞ্জ অনুমোদন কোড.

      Exchange authorization code for tokens ক্লিক করুন। ঐচ্ছিকভাবে, Auto-refresh the token before it expires ক্লিক করুন।

    • API এ অনুরোধ কনফিগার করুন।

      'রিকোয়েস্ট ইউআরআই' টেক্সট বক্সে আপনার API URL লিখুন। API স্পেসিফিকেশন অনুযায়ী 'HTTP মেথড', 'এন্টার রিকোয়েস্ট বডি', ইত্যাদি পরিবর্তন করুন। উদাহরণস্বরূপ, আপনার প্রতিষ্ঠানে ইনস্টল করা অ্যাপগুলি গণনা করতে নিম্নলিখিত URL ব্যবহার করুন: https://chromemanagement.googleapis.com/v1alpha1/customers/my_customer/reports:countInstalledApps