ডিরেক্টরি API: গ্রুপ সদস্য

একটি গ্রুপে একজন সদস্য যোগ করুন

একটি গ্রুপে একজন সদস্য যোগ করতে, নিম্নলিখিত POST অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। একটি গ্রুপ সদস্য একটি ব্যবহারকারী বা অন্য গ্রুপ হতে পারে. groupKey হল নতুন সদস্যের গ্রুপ ইমেল ঠিকানা বা গ্রুপের অনন্য id । অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন:

POST https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members

আপনি যদি অন্য গোষ্ঠীর সদস্য হিসাবে একটি গোষ্ঠীকে যুক্ত করেন, তাহলে শিশু গোষ্ঠীর সদস্যদের অভিভাবক গোষ্ঠীর সদস্য হিসাবে উপস্থিত হওয়ার আগে 10 মিনিট পর্যন্ত বিলম্ব হতে পারে। উপরন্তু, API গ্রুপ সদস্যপদ চক্রের জন্য একটি ত্রুটি প্রদান করে। উদাহরণস্বরূপ, যদি গ্রুপ 1 গ্রুপ 2 এর সদস্য হয় তবে গ্রুপ 2 গ্রুপ 1 এর সদস্য হতে পারে না।

JSON অনুরোধ

নিম্নলিখিত JSON অনুরোধটি একটি নমুনা অনুরোধের বডি দেখায় যা একটি গ্রুপ সদস্য তৈরি করে। সদস্যের ইমেল ঠিকানা হল liz@example.com এবং গ্রুপে সদস্যের ভূমিকা একজন MEMBER হিসাবে। POST অনুরোধ groupKey জন্য NNNNN ব্যবহার করে:

POST https://admin.googleapis.com/admin/directory/v1/groups/NNNNN/members

{
   "email": "liz@example.com",
    "role": "MEMBER"
}

একটি গ্রুপ সদস্যের role হতে পারে:

  • OWNER - এই ভূমিকা গ্রুপে বার্তা পাঠাতে, সদস্যদের যোগ করতে বা সরাতে, সদস্যের ভূমিকা পরিবর্তন করতে, গ্রুপের সেটিংস পরিবর্তন করতে এবং গোষ্ঠীটি মুছে ফেলতে পারে। একজন OWNER অবশ্যই গ্রুপের সদস্য হতে হবে।
  • MANAGER – অ্যাডমিন কনসোল ব্যবহার করে Google Workspace চালু থাকলেই এই ভূমিকা পাওয়া যায়। একজন ম্যানেজারের ভূমিকা একজন মালিকের ভূমিকার দ্বারা সম্পন্ন করা সমস্ত কিছু করতে পারে ব্যতীত একজন সদস্যকে মালিক করা বা গ্রুপটি মুছে ফেলা। একটি গ্রুপে একাধিক OWNER এবং MANAGER সদস্য থাকতে পারে।
  • MEMBER - এই ভূমিকাটি একটি গোষ্ঠীতে সদস্যতা নিতে পারে, আলোচনার সংরক্ষণাগারগুলি দেখতে এবং গোষ্ঠীর সদস্যতার তালিকা দেখতে পারে৷ সদস্য ভূমিকা সম্পর্কে আরও তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন।

JSON প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং সদস্যের সদস্যতার তথ্য প্রদান করে। id সদস্যের অনন্য সদস্যতা আইডি:

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MEMBER",
   "type": "GROUP"
  }

একটি গ্রুপ সদস্যের type হতে পারে:

  • GROUP - সদস্য হল অন্য গ্রুপ।
  • MEMBER - সদস্য একজন ব্যবহারকারী

একটি গ্রুপ সদস্যপদ আপডেট করুন

একটি গ্রুপ সদস্যপদ আপডেট করতে, নিম্নলিখিত PUT অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গোষ্ঠীর ইমেল ঠিকানা বা গোষ্ঠীর অনন্য id , এবং memberKey হল ব্যবহারকারীর বা গোষ্ঠীর প্রাথমিক ইমেল ঠিকানা, একজন ব্যবহারকারীর উপনাম ইমেল ঠিকানা, বা ব্যবহারকারীর অনন্য id । অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন:

PUT https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

JSON অনুরোধ

নিম্নলিখিত JSON অনুরোধটি একটি নমুনা অনুরোধের বডি দেখায় যা একটি গ্রুপ সদস্যতা সেটিংস আপডেট করে। সদস্যের ইমেল ঠিকানা হল liz@example.com এবং গ্রুপে সদস্যের ভূমিকা একজন MEMBER থেকে একজন MANAGER এ পরিবর্তিত হয়। এই উদাহরণে PUT অনুরোধের groupKey হল NNNNN। সদস্য, মালিক এবং ম্যানেজারের ভূমিকা সম্পর্কে তথ্যের জন্য, প্রশাসন সহায়তা কেন্দ্র দেখুন:

PUT https://admin.googleapis.com/admin/directory/v1/groups/NNNNN/members/liz@example.com
{
   "email": "liz@example.com",
    "role": "MANAGER"
}

JSON প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং আপডেট করা সদস্যতা তথ্য প্রদান করে। id সদস্যের অনন্য সদস্যতা আইডি:

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MANAGER",
   "type": "GROUP"
  }

একটি দলের সদস্য পুনরুদ্ধার করুন

একটি গ্রুপ সদস্যপদ পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গোষ্ঠীর ইমেল ঠিকানা বা গোষ্ঠীর অনন্য id , এবং memberKey হল ব্যবহারকারীর বা গোষ্ঠীর প্রাথমিক ইমেল ঠিকানা, একজন ব্যবহারকারীর উপনাম ইমেল ঠিকানা, বা ব্যবহারকারীর অনন্য id । অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন:

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey

JSON প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং সদস্যের সদস্যতার তথ্য প্রদান করে। id সদস্যের অনন্য সদস্যতা আইডি: 

{
   "kind": "directory#member",
   "id": "group member's unique ID",
   "email": "liz@example.com",
   "role": "MANAGER",
   "type": "GROUP"
  }

সমস্ত গ্রুপ সদস্য পুনরুদ্ধার করুন

সমস্ত গ্রুপ সদস্যদের পুনরুদ্ধার করতে, নিম্নলিখিত GET অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গ্রুপের ইমেল ঠিকানা বা গ্রুপের অনন্য id । ঐচ্ছিক roles ক্যোয়ারী স্ট্রিং হল একটি ফিল্টার যা আপনাকে ভূমিকা দ্বারা গ্রুপ সদস্যদের পুনরুদ্ধার করতে দেয় এবং এর ফলে ভূমিকা সংগ্রহগুলি roles ফিল্টারে দেওয়া ক্রম অনুসারে হয়। অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন। পঠনযোগ্যতার জন্য, এই উদাহরণ লাইন রিটার্ন ব্যবহার করে: 

GET https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members
?pageToken=pagination token
&roles=one or more of OWNER,MANAGER,MEMBER separated by a comma
&maxResults=maximum results per response page

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

JSON প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড এবং সদস্য তথ্যের তালিকা প্রদান করে। id সদস্যের অনন্য সদস্যতা আইডি। এই প্রতিক্রিয়ায় গ্রুপ সদস্যদের ফলো-অন তালিকার জন্য একটি nextPageToken আছে: 

{
   "kind": "directory#members",
   "members": [
   {
    "kind": "directory#member",
    "id": "group member's unique ID",
    "email": "liz@example.com",
    "role": "MANAGER",
    "type": "USER"
   },
   {
    "kind": "directory#member",
    "id": "group member's unique ID",
    "email": "radhe@example.com",
    "role": "MANAGER",
    "type": "USER"
   }
  ],
   "nextPageToken": "NNNNN"
}

একটি গ্রুপে সদস্যতা মুছুন

একটি গ্রুপে একজন সদস্যের সদস্যতা মুছে ফেলতে, নিম্নলিখিত DELETE অনুরোধটি ব্যবহার করুন এবং অনুমোদনের অনুরোধে বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। groupKey হল গোষ্ঠীর অনন্য id , এবং memberKey হল মুছে ফেলা ব্যবহারকারী বা গোষ্ঠীর সদস্যের প্রাথমিক ইমেল ঠিকানা বা ব্যবহারকারীর অনন্য id । অনুরোধ এবং প্রতিক্রিয়া বৈশিষ্ট্যের জন্য, API রেফারেন্স দেখুন। 

DELETE https://admin.googleapis.com/admin/directory/v1/groups/groupKey/members/memberKey
 উদাহরণস্বরূপ, এই DELETE অনুরোধটি সেই সদস্যকে মুছে দেয় যার groupKey হল nnn এবং যার memberKey হল ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, liz@example.com:
DELETE https://admin.googleapis.com/admin/directory/v1/groups/nnnn/members/liz@example.com

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে।

যখন একজন সদস্য মুছে ফেলা হয়:

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