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

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

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

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

যদি আপনি একটি গ্রুপকে অন্য গ্রুপের সদস্য হিসেবে যোগ করেন, তাহলে চাইল্ড গ্রুপের সদস্যদের প্যারেন্ট গ্রুপের সদস্য হিসেবে উপস্থিত হতে ১০ মিনিট পর্যন্ত বিলম্ব হতে পারে। এছাড়াও, API গ্রুপ সদস্যপদে চক্রের জন্য একটি ত্রুটি প্রদান করে। উদাহরণস্বরূপ, যদি গ্রুপ১ গ্রুপ২ এর সদস্য হয়, তাহলে গ্রুপ২ গ্রুপ১ এর সদস্য হতে পারবে না।

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 – এই ভূমিকাটি শুধুমাত্র তখনই উপলব্ধ যখন গুগল অ্যাডমিন কনসোল ব্যবহার করে গুগল ওয়ার্কস্পেস সক্রিয় থাকে। একজন ম্যানেজার ভূমিকা একজন মালিকের ভূমিকা দ্বারা করা সমস্ত কাজ করতে পারে, কেবল একজন সদস্যকে মালিক করা বা গ্রুপটি মুছে ফেলা ছাড়া। একটি গ্রুপে একাধিক মালিক এবং ম্যানেজার সদস্য থাকতে পারে।
  • 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 অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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 অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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 অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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 অনুরোধটি ব্যবহার করুন এবং Authorize requests এ বর্ণিত অনুমোদন অন্তর্ভুক্ত করুন। 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 স্ট্যাটাস কোড প্রদান করে।

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

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