এডুকেশন প্লাস লাইসেন্সধারী নির্দিষ্ট ব্যক্তি বা গোষ্ঠীকে নিম্নলিখিত কাজগুলি করার অনুমতি দেওয়ার জন্য অ্যাডমিনিস্ট্রেটররা অ্যাডমিন কনসোলে কাস্টম অ্যাডমিনিস্ট্রেটর ভূমিকা তৈরি করতে পারেন:
অ্যাসাইনমেন্ট সমাপ্তি, গ্রেড ট্রেন্ড এবং ক্লাসরুম গ্রহণের মতো ডেটা বোঝার জন্য ক্লাসরুম বিশ্লেষণ দেখুন ।
স্থায়ী সহ-শিক্ষক হিসেবে নিযুক্ত না হয়েও শিক্ষকদের সহায়তা করার জন্য, ঘোষণা পোস্ট করার জন্য এবং আরও অনেক কিছু করার জন্য Classroom-এ সাময়িকভাবে ক্লাস অ্যাক্সেস করুন ।
এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে Google API ব্যবহার করে আপনার ডোমেনে এই বৈশিষ্ট্যগুলি সেট আপ করবেন।
কাস্টম ভূমিকা নির্ধারণ প্রক্রিয়া স্বয়ংক্রিয় করুন
কাস্টম ভূমিকা নির্ধারণ প্রক্রিয়া স্বয়ংক্রিয় করতে:
- এই বৈশিষ্ট্যগুলি অ্যাক্সেস করতে পারে এমন ব্যবহারকারীদের সংগঠিত করার জন্য নিরাপত্তা গোষ্ঠী তৈরি করুন।
- গ্রুপগুলিতে সদস্য যোগ করুন।
- সঠিক অধিকার নির্বাচন করে একটি কাস্টম প্রশাসক ভূমিকা তৈরি করুন।
- সাংগঠনিক ইউনিট আইডিগুলি পুনরুদ্ধার করুন।
- নতুন তৈরি গ্রুপগুলিতে কাস্টম প্রশাসকের ভূমিকা প্রয়োগ করুন।
পূর্বশর্ত
- জাভাস্ক্রিপ্ট, পাইথন এবং জাভার মতো ভাষায় গুগল এপিআই ব্যবহার করে কীভাবে একটি অ্যাপ্লিকেশন সেট আপ এবং চালাতে হয় তা বুঝতে কুইকস্টার্ট নির্দেশিকাগুলি পড়ুন।
- গ্রুপ API ওভারভিউ পড়ুন।
- এই নির্দেশিকায় বর্ণিত যেকোনো ক্লাউড আইডেন্টিটি API ব্যবহার করার আগে, আপনাকে অবশ্যই ক্লাউড আইডেন্টিটি সেট আপ করতে হবে। এই API গুলি প্রশাসকের বিশেষাধিকার নির্ধারণের জন্য গ্রুপ তৈরি করতে ব্যবহৃত হয়।
- গ্রুপ API সেট আপ করুন ।
নিরাপত্তা গোষ্ঠী তৈরি করুন
groups.create পদ্ধতি ব্যবহার করে একটি নিরাপত্তা গোষ্ঠী তৈরি করুন। অনুরোধের labels ক্ষেত্রে নিরাপত্তা লেবেল অন্তর্ভুক্ত করা হলে একটি গোষ্ঠীকে নিরাপত্তা গোষ্ঠী হিসেবে সেট করা যেতে পারে। নিরাপত্তা গোষ্ঠী তৈরির বিষয়ে আরও তথ্য এবং সীমাবদ্ধতার জন্য, নিরাপত্তা গোষ্ঠী তৈরির নির্দেশিকাটি পড়ুন।
POST https://cloudidentity.googleapis.com/v1/groups
ঐচ্ছিকভাবে, আপনি গ্রুপের মালিককে আরম্ভ করার জন্য InitialGroupConfig কোয়েরি প্যারামিটার অন্তর্ভুক্ত করতে পারেন:
POST https://cloudidentity.googleapis.com/v1/groups&initialGroupConfig={initialGroupConfig}
এই অনুরোধকারী অ্যাকাউন্টের জন্য নিম্নলিখিত সুযোগগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/cloud-identity.groups -
https://www.googleapis.com/auth/cloud-identity -
https://www.googleapis.com/auth/cloud-platform
অনুরোধের মূল অংশ
অনুরোধের অংশে তৈরি করা গ্রুপের বিশদ বিবরণ থাকে। customerId অবশ্যই "C" দিয়ে শুরু হতে হবে (উদাহরণস্বরূপ, C046psxkn )। আপনার গ্রাহক আইডি খুঁজুন ।
{
parent: "customers/<customer-id>",
description: "This is the leadership group of school A.",
displayName: "Leadership School A",
groupKey: {
id: "leadership_school_a@example.com"
},
labels: {
"cloudidentity.googleapis.com/groups.security": "",
"cloudidentity.googleapis.com/groups.discussion_forum": ""
}
}
প্রতিক্রিয়া
প্রতিক্রিয়াটিতে Operation রিসোর্সের একটি নতুন উদাহরণ রয়েছে।
{
done: true,
response: {
@type: "type.googleapis.com/google.apps.cloudidentity.groups.v1.Group",
name: "groups/<group-id>", // unique group ID
groupKey: {
id: "leadership_school_a@example.com" // group email address
},
parent: "customers/<customer-id>",
displayName: "Leadership School A",
description: "This is the leadership group of school A.",
createTime: "<created time>",
updateTime: "<updated time>",
labels: {
"cloudidentity.googleapis.com/groups.security": "",
"cloudidentity.googleapis.com/groups.discussion_forum": ""
}
}
}
গ্রুপের সদস্যদের যোগ করুন
গ্রুপ তৈরি করার পর, পরবর্তী ধাপ হল সদস্যদের যোগ করা। একজন গ্রুপ সদস্য একজন ব্যবহারকারী অথবা অন্য কোন নিরাপত্তা গ্রুপ হতে পারে। যদি আপনি অন্য গ্রুপের সদস্য হিসেবে একটি গ্রুপ যোগ করেন, তাহলে সদস্যপদ প্রচারের জন্য ১০ মিনিট পর্যন্ত বিলম্ব হতে পারে। এছাড়াও, API গ্রুপ সদস্যপদে চক্রের জন্য একটি ত্রুটি ফেরত দেয়। উদাহরণস্বরূপ, যদি group1 group2 এর সদস্য হয়, group2 group1 এর সদস্য হতে পারে না।
একটি গ্রুপে একজন সদস্য যোগ করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন।
ডিরেক্টরি API members.insert করুন :
POST https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/members
groupKey পাথ প্যারামিটার হল নতুন সদস্যের গ্রুপ ইমেল ঠিকানা অথবা গ্রুপের অনন্য আইডি।
POST অনুরোধকারী অ্যাকাউন্টের জন্য নিম্নলিখিত স্কোপগুলির মধ্যে একটি প্রয়োজন:
-
https://apps-apis.google.com/a/feeds/groups/ -
https://www.googleapis.com/auth/admin.directory.group -
https://www.googleapis.com/auth/admin.directory.group.member
অনুরোধের মূল অংশ
অনুরোধের বডিতে তৈরি করা member বিবরণ থাকে।
{
email: "person_one@example.com",
role: "MEMBER", // can be `MEMBER`, `OWNER`, `MANAGER`
}
প্রতিক্রিয়া
প্রতিক্রিয়াটিতে সদস্যের নতুন উদাহরণ রয়েছে।
{
kind: "admin#directory#member",
etag: "<etag-value>", // role's unique ETag
id: "4567", // group member's unique ID
email: "person_one@example.com",
role: "MEMBER",
type: "GROUP",
status: "ACTIVE"
}
এই অনুরোধটি আপনার সদস্য হিসেবে যোগ করতে চান এমন প্রতিটি ব্যবহারকারীর জন্য করা আবশ্যক। আপনার ক্লায়েন্টের HTTP সংযোগের সংখ্যা কমাতে আপনি এই অনুরোধগুলি ব্যাচ করতে পারেন।
একটি বিশেষাধিকারপ্রাপ্ত কাস্টম প্রশাসক ভূমিকা তৈরি করুন
ডিরেক্টরি API আপনাকে আপনার Google Workspace ডোমেনের বৈশিষ্ট্যগুলিতে অ্যাক্সেস পরিচালনা করতে ভূমিকা-ভিত্তিক অ্যাক্সেস নিয়ন্ত্রণ (RBAC) ব্যবহার করতে দেয়। আপনি Google Workspace-এর সাথে প্রদত্ত পূর্বনির্ধারিত ভূমিকাগুলির চেয়ে প্রশাসকের অ্যাক্সেসকে আরও সুনির্দিষ্টভাবে সীমাবদ্ধ করার জন্য বিশেষাধিকার সহ কাস্টম ভূমিকা তৈরি করতে পারেন। আপনি ব্যবহারকারী বা সুরক্ষা গোষ্ঠীগুলিকে ভূমিকা বরাদ্দ করতে পারেন। ভূমিকা তৈরির সীমাবদ্ধতা সম্পর্কে আরও বিস্তারিত তথ্যের জন্য, কাস্টম ভূমিকা এবং ভূমিকা বরাদ্দের সীমাবদ্ধতাগুলি দেখুন।
একটি নতুন ভূমিকা তৈরি করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন।
ডিরেক্টরি API roles.insert :
POST https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles
customerId এই নির্দেশিকার ধাপ ১- এ ব্যবহৃত আইডির মতোই।
POST অনুরোধকারী অ্যাকাউন্টের জন্য নিম্নলিখিত সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/admin.directory.rolemanagement
অনুরোধের মূল অংশ
অনুরোধের অংশে তৈরি করা role বিশদ বিবরণ থাকে। এই ভূমিকার সাথে প্রদত্ত প্রতিটি বিশেষাধিকারের জন্য একটি privilegeName এবং serviceId যোগ করুন।
শ্রেণীকক্ষ বিশ্লেষণ
019c6y1840fzfkt তে সেট করা serviceId সহ, বিশ্লেষণ ডেটা অ্যাক্সেস করতে পারে এমন একটি কাস্টম ভূমিকা তৈরি করার জন্য EDU_ANALYTICS_DATA_ACCESS সুবিধা প্রয়োজন।
{
roleName: "Education Admin", // customize as needed
roleDescription: "Access to view analytics data", // customize as needed
rolePrivileges: [
{
privilegeName: "EDU_ANALYTICS_DATA_ACCESS",
serviceId: "019c6y1840fzfkt"
}
]
}
অস্থায়ী ক্লাস অ্যাক্সেস
019c6y1840fzfkt তে সেট করা serviceId সহ, অস্থায়ীভাবে ক্লাস অ্যাক্সেস করতে পারে এমন একটি কাস্টম ভূমিকা তৈরি করার জন্য ADMIN_OVERSIGHT_MANAGE_CLASSES সুবিধা প্রয়োজন।
{
roleName: "Education Admin", // customize as needed
roleDescription: "Access to manage classes privilege", // customize as needed
rolePrivileges: [
{
privilegeName: "ADMIN_OVERSIGHT_MANAGE_CLASSES",
serviceId: "019c6y1840fzfkt"
}
]
}
privilegeIds এবং serviceIds এর তালিকা পুনরুদ্ধার করতে privileges.list পদ্ধতিতে কল করুন।
প্রতিক্রিয়া
প্রতিক্রিয়াটিতে ভূমিকার নতুন উদাহরণ রয়েছে।
শ্রেণীকক্ষ বিশ্লেষণ
{
kind: "admin#directory#role",
etag: "<etag-value>", // role's unique ETag
roleId: "<role-id>", // role's unique ID
roleName: "Education Admin",
roleDescription: "Access to view analytics data",
rolePrivileges: [
{
privilegeName: "EDU_ANALYTICS_DATA_ACCESS",
serviceId: "019c6y1840fzfkt"
}
],
isSystemRole: false,
isSuperAdminRole: false
}
অস্থায়ী ক্লাস অ্যাক্সেস
{
kind: "admin#directory#role",
etag: "<etag-value>", // role's unique ETag
roleId: "<role-id>", // role's unique ID
roleName: "Education Admin",
roleDescription: "Access to manage classes privilege",
rolePrivileges: [
{
privilegeName: "ADMIN_OVERSIGHT_MANAGE_CLASSES",
serviceId: "019c6y1840fzfkt"
}
],
isSystemRole: false,
isSuperAdminRole: false
}
সাংগঠনিক ইউনিট আইডিগুলি পুনরুদ্ধার করুন
আপনি সাংগঠনিক ইউনিট আইডি ব্যবহার করে এক বা একাধিক সাংগঠনিক ইউনিটের মধ্যে কাস্টম অ্যাডমিনিস্ট্রেটর ভূমিকার অ্যাক্সেস সীমিত করতে পারেন। orgUnitId পুনরুদ্ধার করতে OrgUnit API ব্যবহার করুন।
শ্রেণীকক্ষ বিশ্লেষণ
কোনও নির্দিষ্ট ব্যবহারকারী বা গোষ্ঠীকে কাস্টম প্রশাসকের ভূমিকা অর্পণ করার সময়, আপনাকে একটি ছাত্র সাংগঠনিক ইউনিট এবং শিক্ষক সাংগঠনিক ইউনিট নির্বাচন করার পরামর্শ দেওয়া হচ্ছে। এটি করার ফলে কাস্টম প্রশাসকের বিশেষাধিকারপ্রাপ্ত ব্যবহারকারীরা সাংগঠনিক ইউনিটগুলির জন্য ছাত্র এবং শ্রেণী-স্তরের ডেটা অ্যাক্সেস করতে পারবেন। যদি ছাত্র সাংগঠনিক ইউনিট বাদ দেওয়া হয়, তাহলে মনোনীত ব্যবহারকারীরা ছাত্র ডেটা অ্যাক্সেস করতে পারবেন না। যদি শিক্ষক সাংগঠনিক ইউনিট বাদ দেওয়া হয়, তাহলে মনোনীত ব্যবহারকারীরা শ্রেণী-স্তরের ডেটা অ্যাক্সেস করতে পারবেন না।
অস্থায়ী ক্লাস অ্যাক্সেস
আপনি কাস্টম অ্যাডমিনিস্ট্রেটর ভূমিকা সম্পন্ন ব্যবহারকারীদের নির্দিষ্ট সাংগঠনিক ইউনিটের ক্লাসে অ্যাক্সেসের অনুমতি দিয়ে অস্থায়ী ক্লাস অ্যাক্সেসের সুবিধা সীমিত করতে পারেন। যদি কোনও সাংগঠনিক ইউনিটে অ্যাক্সেস সীমাবদ্ধ করা হয়, তাহলে কাস্টম অ্যাডমিনিস্ট্রেটর ভূমিকা নির্ধারিত গোষ্ঠীটি কেবলমাত্র সেই ক্লাসগুলিতে অ্যাক্সেস করতে পারবে যেখানে ক্লাসের প্রাথমিক শিক্ষক সেই সাংগঠনিক ইউনিটে থাকেন।
কাস্টম প্রশাসকের ভূমিকা নির্ধারণ করুন
একটি গ্রুপে কাস্টম অ্যাডমিনিস্ট্রেটর ভূমিকা নির্ধারণ করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন। ভূমিকা নির্ধারণের সীমার জন্য কাস্টম ভূমিকা এবং ভূমিকা নির্ধারণের সীমাবদ্ধতা নির্দেশিকা দেখুন।
ডিরেক্টরি API roleAssignments.insert :
POST https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roleassignments
একটি গ্রুপ বা স্বতন্ত্র ব্যবহারকারীকে বরাদ্দ করুন
যদি কোনও গ্রুপকে বিশেষাধিকার প্রদান করা হয়, তাহলে অনুরোধের বডিতে assignedTo ক্ষেত্রে groupId অন্তর্ভুক্ত করুন। নিরাপত্তা গোষ্ঠী তৈরি করুন ধাপে groupId টি প্রাপ্ত করা হয়েছে। যদি কোনও পৃথক ব্যবহারকারীকে বিশেষাধিকার প্রদান করা হয়, তাহলে অনুরোধের বডিতে assignedTo ক্ষেত্রে ব্যবহারকারীর আইডি অন্তর্ভুক্ত করুন। users.get এ কল করে এবং ব্যবহারকারীর ইমেল ঠিকানাটিকে userKey প্যারামিটার হিসাবে উল্লেখ করে অথবা users.list এ কল করে ব্যবহারকারীর আইডি পুনরুদ্ধার করা যেতে পারে।
POST অনুরোধকারী অ্যাকাউন্টের জন্য নিম্নলিখিত সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/admin.directory.rolemanagement
অনুরোধের মূল অংশ
অনুরোধের অংশে তৈরি করা RoleAssignment বিবরণ রয়েছে। আপনি এই গোষ্ঠীর সাথে সংযুক্ত করতে চান এমন প্রতিটি সাংগঠনিক ইউনিটের জন্য আপনাকে অবশ্যই একটি অনুরোধ করতে হবে।
{
roleId: "<role-id>", // role's unique ID obtained from Step 3
assignedTo: "<id>", // group ID or user ID
scopeType: "ORG_UNIT", // can be `ORG_UNIT` or `CUSTOMER`
orgUnitId: "<org-unit-id>" // organizational unit ID referenced in Step 4
}
প্রতিক্রিয়া
প্রতিক্রিয়াটিতে RoleAssignment এর নতুন উদাহরণ রয়েছে।
{
kind: "admin#directory#roleAssignment",
etag: "<etag-value>",
roleAssignmentId: "<role-assignment-id>",
roleId: "<role-id>",
assignedTo: "<group-id or user-id>",
assigneeType: "GROUP",
scopeType: "ORG_UNIT",
orgUnitId: "<org-unit-id>"
}
রিসোর্স
অতিরিক্ত তথ্য এখানে পাওয়া যাবে:
- ডিরেক্টরি API ওভারভিউ
- ডিরেক্টরি API-নির্দিষ্ট প্রমাণীকরণ এবং অনুমোদন
- ডিরেক্টরি API REST ডকুমেন্টেশন
- অ্যাডমিন SDK API ডেভেলপার সাপোর্ট