Class GroupsApp

গ্রুপসঅ্যাপ

এই ক্লাসটি গুগল গ্রুপস-এর তথ্যে প্রবেশাধিকার দেয়। এটি ব্যবহার করে কোনো গ্রুপের ইমেল ঠিকানা, অথবা ব্যবহারকারী যেসব গ্রুপের সরাসরি সদস্য, সেই গ্রুপগুলোর তালিকার মতো তথ্য অনুসন্ধান করা যায়।

এখানে একটি উদাহরণ দেওয়া হলো যা দেখায় বর্তমান ব্যবহারকারী কতগুলি গ্রুপের সদস্য:

const groups = GroupsApp.getGroups();
Logger.log(`You belong to ${groups.length} groups.`);

বৈশিষ্ট্য

সম্পত্তি প্রকার বর্ণনা
Role Role

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
get Group By Email(email) Group নির্দিষ্ট ইমেল ঠিকানা থাকা গ্রুপটি খুঁজে বের করে।
get Groups() Group[] আপনি যে সমস্ত গ্রুপের সরাসরি সদস্য (বা সদস্যপদপ্রত্যাশী) সেই সমস্ত গ্রুপ খুঁজে বের করে।

বিস্তারিত ডকুমেন্টেশন

getGroupByEmail(email)

নির্দিষ্ট ইমেল ঠিকানাযুক্ত গ্রুপটি খুঁজে বের করে। গ্রুপটি বিদ্যমান না থাকলে বা এটি দেখার অনুমতি আপনার না থাকলে একটি ব্যতিক্রমী ত্রুটি (exception) দেখায়।

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

const group = GroupsApp.getGroupByEmail('example@googlegroups.com');
const currentUser = Session.getActiveUser();
if (group.hasUser(currentUser)) {
  Logger.log('You are a member of this group.');
} else {
  Logger.log('You are not a member of this group.');
}

প্যারামিটার

নাম প্রকার বর্ণনা
email String পুনরুদ্ধার করার জন্য গ্রুপের ইমেইল ঠিকানা।

ফেরত

Group — নির্দিষ্ট ইমেইল ঠিকানাযুক্ত গ্রুপটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/groups

getGroups()

আপনি যে সমস্ত গ্রুপের সরাসরি সদস্য (বা সদস্যপদের অপেক্ষায় আছেন), সেই সমস্ত গ্রুপ খুঁজে বের করে। আপনি কোনো গ্রুপে না থাকলে এই তালিকাটি খালি থাকবে। গ্রুপটির অস্তিত্ব না থাকলে বা সেটি দেখার অনুমতি আপনার না থাকলে একটি ব্যতিক্রমী ত্রুটি (exception) দেখানো হবে।

ব্যবহারকারী যেসব গ্রুপের সদস্য, সেগুলোর প্রত্যেকটির ইমেইল ঠিকানা কীভাবে প্রিন্ট করতে হয় তার একটি উদাহরণ এখানে দেওয়া হলো:

function showMyGroups() {
  const groups = GroupsApp.getGroups();
  let str = `You are in ${groups.length} groups: `;
  for (let i = 0; i < groups.length; i++) {
    const group = groups[i];
    str = `${str + group.getEmail()} `;
  }
  Logger.log(str);
}
মনে রাখবেন যে, আপনি যদি B নামক কোনো গ্রুপের সদস্য হন, যেটি আবার A নামক আরেকটি গ্রুপের সদস্য, তাহলে আপনি পরোক্ষভাবে A গ্রুপের গ্রাহক হয়ে যান। যদিও আপনি মূল গ্রুপ A-তে পাঠানো বার্তাগুলোর অনুলিপি পান, কিন্তু আপনি আসলে সেই গ্রুপের গ্রাহক নন।

ফেরত আসা গ্রুপগুলোর মধ্যে আপনি বর্তমান সদস্য নাকি অপেক্ষমাণ সদস্য, তা জানতে Group.getRole(email) ব্যবহার করতে পারেন।

ফেরত

Group[] — সেইসব গ্রুপের তালিকা, যেগুলোর ব্যবহারকারী সরাসরি সদস্য।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/groups