Groups

منبع Groups کلاس داده ریشه برای Groups Settings API است. هر منبع Groups با مجموعه‌ای از تنظیمات مرتبط است.

برای اطلاعات بیشتر، به فهرست روش‌های این منبع مراجعه کنید.

نمایش منابع

منبع گروه‌ها شامل فراداده‌هایی با خلاصه‌ای از تنظیمات یک گروه مشخص شده است. این تنظیمات، دسترسی گروه، اعلان‌ها، بایگانی بحث‌ها، مدیریت پیام‌ها و سفارشی‌سازی گروه‌های کاربری حساب شما را مدیریت می‌کنند.

به طور پیش‌فرض، داده‌های منبع Groups در قالب داده JSON بازگردانده می‌شوند.

اتم 

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006" xmlns:gd="http://schemas.google.com/g/2005">
  <id>
    string
  </id>
  <title>
    Groups Resource Entry
  </title>
  <content type="text">
    string
  </content>
  <author>
    <name>
      Google
    </name>
  </author>
  <apps:email>
    string
  </apps:email>
  <apps:name>
    string
  </apps:name>
  <apps:description>
    string
  </apps:description>
  <apps:whoCanJoin>
    string
  </apps:whoCanJoin>
  <apps:whoCanViewMembership>
    string
  </apps:whoCanViewMembership>
  <apps:whoCanViewGroup>
    string
  </apps:whoCanViewGroup>
  <apps:whoCanInvite>
    string
  </apps:whoCanInvite>
  <apps:whoCanAdd>
    string
  </apps:whoCanAdd>
  <apps:allowExternalMembers>
    string
  </apps:allowExternalMembers>
  <apps:whoCanPostMessage>
    string
  </apps:whoCanPostMessage>
  <apps:allowWebPosting>
    string
  </apps:allowWebPosting>
  <apps:primaryLanguage>
    string
  </apps:primaryLanguage>
  <apps:maxMessageBytes>
    integer
  </apps:maxMessageBytes>
  <apps:isArchived>
    string
  </apps:isArchived>
  <apps:archiveOnly>
    string
  </apps:archiveOnly>
  <apps:messageModerationLevel>
    string
  </apps:messageModerationLevel>
  <apps:spamModerationLevel>
    string
  </apps:spamModerationLevel>
  <apps:replyTo>
    string
  </apps:replyTo>
  <apps:customReplyTo>
    string
  </apps:customReplyTo>
  <apps:includeCustomFooter>
    string
  </apps:includeCustomFooter>
  <apps:customFooterText>
    string
  </apps:customFooterText>
  <apps:sendMessageDenyNotification>
    string
  </apps:sendMessageDenyNotification>
  <apps:defaultMessageDenyNotificationText>
    string
  </apps:defaultMessageDenyNotificationText>
  <apps:showInGroupDirectory>
    string
  </apps:showInGroupDirectory>
  <apps:allowGoogleCommunication>
    string
  </apps:allowGoogleCommunication>
  <apps:membersCanPostAsTheGroup>
    string
  </apps:membersCanPostAsTheGroup>
  <apps:messageDisplayFont>
    string
  </apps:messageDisplayFont>
  <apps:includeInGlobalAddressList>
    string
  </apps:includeInGlobalAddressList>
  <apps:whoCanLeaveGroup>
    string
  </apps:whoCanLeaveGroup>
  <apps:whoCanContactOwner>
    string
  </apps:whoCanContactOwner>
  <apps:whoCanAddReferences>
    string
  </apps:whoCanAddReferences>
  <apps:whoCanAssignTopics>
    string
  </apps:whoCanAssignTopics>
  <apps:whoCanUnassignTopic>
    string
  </apps:whoCanUnassignTopic>
  <apps:whoCanTakeTopics>
    string
  </apps:whoCanTakeTopics>
  <apps:whoCanMarkDuplicate>
    string
  </apps:whoCanMarkDuplicate>
  <apps:whoCanMarkNoResponseNeeded>
    string
  </apps:whoCanMarkNoResponseNeeded>
  <apps:whoCanMarkFavoriteReplyOnAnyTopic>
    string
  </apps:whoCanMarkFavoriteReplyOnAnyTopic>
  <apps:whoCanMarkFavoriteReplyOnOwnTopic>
    string
  </apps:whoCanMarkFavoriteReplyOnOwnTopic>
  <apps:whoCanUnmarkFavoriteReplyOnAnyTopic>
    string
  </apps:whoCanUnmarkFavoriteReplyOnAnyTopic>
  <apps:whoCanEnterFreeFormTags>
    string
  </apps:whoCanEnterFreeFormTags>
  <apps:whoCanModifyTagsAndCategories>
    string
  </apps:whoCanModifyTagsAndCategories>
  <apps:favoriteRepliesOnTop>
    string
  </apps:favoriteRepliesOnTop>
  <apps:whoCanApproveMembers>
    string
  </apps:whoCanApproveMembers>
  <apps:whoCanBanUsers>
    string
  </apps:whoCanBanUsers>
  <apps:whoCanModifyMembers>
    string
  </apps:whoCanModifyMembers>
  <apps:whoCanApproveMessages>
    string
  </apps:whoCanApproveMessages>
  <apps:whoCanDeleteAnyPost>
    string
  </apps:whoCanDeleteAnyPost>
  <apps:whoCanDeleteTopics>
    string
  </apps:whoCanDeleteTopics>
  <apps:whoCanLockTopics>
    string
  </apps:whoCanLockTopics>
  <apps:whoCanMoveTopicsIn>
    string
  </apps:whoCanMoveTopicsIn>
  <apps:whoCanMoveTopicsOut>
    string
  </apps:whoCanMoveTopicsOut>
  <apps:whoCanPostAnnouncements>
    string
  </apps:whoCanPostAnnouncements>
  <apps:whoCanHideAbuse>
    string
  </apps:whoCanHideAbuse>
  <apps:whoCanMakeTopicsSticky>
    string
  </apps:whoCanMakeTopicsSticky>
  <apps:whoCanModerateMembers>
    string
  </apps:whoCanModerateMembers>
  <apps:whoCanModerateContent>
    string
  </apps:whoCanModerateContent>
  <apps:whoCanAssistContent>
    string
  </apps:whoCanAssistContent>
  <apps:customRolesEnabledForSettingsToBeMerged>
    string
  </apps:customRolesEnabledForSettingsToBeMerged>
  <apps:enableCollaborativeInbox>
    string
  </apps:enableCollaborativeInbox>
  <apps:whoCanDiscoverGroup>
    string
  </apps:whoCanDiscoverGroup>
  <apps:defaultSender>
    string
  </apps:defaultSender>
</entry>

جدول زیر منابع گروه‌ها را نشان می‌دهد:

نام ملک ارزش توضیحات
entry object منبع گروهی
entry/ xmlns string طرحواره برای قالب Atom
entry/ xmlns:apps string طرحواره برای قالب ورودی/خروجی Google Workspace
entry/ xmlns:gd string طرحواره برای پروتکل داده گوگل
entry/ id object شناسه منحصر به فرد برای یک منبع گروهی
entry/ title object عنوان ورودی Atom در API، که Groups Resource Entry است.
entry/ content object نوع محتوای ورودی Atom
entry/content/ type string نوع محتوای فید Atom، که text است
entry/ author object برچسب نویسنده برای ورودی Atom
entry/author/ name object نام نویسنده، که Google است
entry/ apps:email object

آدرس ایمیل گروه. این ویژگی را می‌توان با استفاده از API دایرکتوری به‌روزرسانی کرد.

entry/ apps:name object نام گروه. نام یک گروه حداکثر ۷۵ کاراکتر دارد.
entry/ apps:description object توضیحات گروه. اگر هیچ توضیحی برای گروه وارد نشده باشد، مقدار این ویژگی می‌تواند یک رشته خالی باشد. در صورت وارد کردن، حداکثر توضیحات گروه نباید بیش از ۴۰۹۶ کاراکتر باشد.
entry/ apps:whoCanJoin object اجازه عضویت در گروه. مقادیر ممکن عبارتند از:
  • ANYONE_CAN_JOIN : هر کاربر اینترنتی، چه در داخل و چه در خارج از دامنه شما، می‌تواند به گروه بپیوندد.
  • ALL_IN_DOMAIN_CAN_JOIN : هر کسی که در دامنه حساب کاربری باشد می‌تواند عضو شود. این شامل حساب‌هایی با چندین دامنه نیز می‌شود.
  • INVITED_CAN_JOIN : از داوطلبان عضویت می‌توان برای عضویت دعوت کرد.
  • CAN_REQUEST_TO_JOIN : افراد غیر عضو می‌توانند برای عضویت درخواست دعوت‌نامه بدهند.
entry/ apps:whoCanViewMembership object مجوزهای مشاهده عضویت. مقادیر ممکن عبارتند از:
  • ALL_IN_DOMAIN_CAN_VIEW : هر کسی که در حساب کاربری باشد می‌تواند فهرست اعضای گروه را مشاهده کند.

    اگر گروهی از قبل اعضای خارجی داشته باشد، آن اعضا همچنان می‌توانند به این گروه ایمیل ارسال کنند.

  • ALL_MEMBERS_CAN_VIEW : اعضای گروه می‌توانند فهرست اعضای گروه را مشاهده کنند.
  • ALL_MANAGERS_CAN_VIEW : مدیران گروه می‌توانند فهرست اعضای گروه را مشاهده کنند.
entry/ apps:whoCanViewGroup object مجوزهای مشاهده پیام‌های گروهی. مقادیر ممکن عبارتند از:
  • ANYONE_CAN_VIEW : هر کاربر اینترنتی می‌تواند پیام‌های گروه را مشاهده کند.
  • ALL_IN_DOMAIN_CAN_VIEW : هر کسی که در حساب شما باشد می‌تواند پیام‌های این گروه را مشاهده کند.
  • ALL_MEMBERS_CAN_VIEW : همه اعضای گروه می‌توانند پیام‌های گروه را مشاهده کنند.
  • ALL_MANAGERS_CAN_VIEW : هر مدیر گروهی می‌تواند پیام‌های این گروه را مشاهده کند.
  • ALL_OWNERS_CAN_VIEW : هر مالک گروه می‌تواند پیام‌های این گروه را مشاهده کند.
entry/ apps:whoCanInvite object منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مجوزهای دعوت از اعضای جدید. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS_CAN_INVITE : مدیران و اعضا می‌توانند یک نامزد عضویت جدید را دعوت کنند.
  • ALL_MANAGERS_CAN_INVITE : فقط مدیران می‌توانند عضو جدید دعوت کنند. این شامل مالک گروه نیز می‌شود.
  • ALL_OWNERS_CAN_INVITE : فقط مالکان می‌توانند عضو جدید دعوت کنند.
  • NONE_CAN_INVITE : هیچ‌کس نمی‌تواند کاندیدای عضویت جدید را دعوت کند.
entry/ apps:whoCanAdd object منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مجوزهایی برای افزودن مستقیم اعضای جدید. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS_CAN_ADD : مدیران و اعضا می‌توانند مستقیماً اعضای جدید اضافه کنند.
  • ALL_MANAGERS_CAN_ADD : فقط مدیران می‌توانند مستقیماً اعضای جدید اضافه کنند. این شامل مالک گروه نیز می‌شود.
  • ALL_OWNERS_CAN_ADD : فقط مالکان می‌توانند مستقیماً اعضای جدید اضافه کنند.
  • NONE_CAN_ADD : هیچ‌کس نمی‌تواند مستقیماً اعضای جدید اضافه کند.
entry/ apps:allowExternalMembers object مشخص می‌کند که آیا اعضای خارج از سازمان شما می‌توانند به گروه بپیوندند یا خیر. مقادیر ممکن عبارتند از:
  • true : کاربران Google Workspace خارج از سازمان شما می‌توانند عضو این گروه شوند.
  • false : کاربرانی که به سازمان تعلق ندارند، مجاز به عضویت در این گروه نیستند.
entry/ apps:whoCanPostMessage object مجوزهای ارسال پیام. مقادیر ممکن عبارتند از:
  • NONE_CAN_POST : این گروه غیرفعال و بایگانی شده است. هیچ کس نمی‌تواند در این گروه پیامی ارسال کند.
    • وقتی archiveOnly برابر با false باشد، به‌روزرسانی whoCanPostMessage به NONE_CAN_POST منجر به خطا می‌شود.
    • اگر archiveOnly از true به false برگردانده شود، whoCanPostMessages روی ALL_MANAGERS_CAN_POST تنظیم می‌شود.
  • ALL_MANAGERS_CAN_POST : مدیران، از جمله صاحبان گروه، می‌توانند پیام ارسال کنند.
  • ALL_MEMBERS_CAN_POST : هر عضو گروه می‌تواند پیام ارسال کند.
  • ALL_OWNERS_CAN_POST : فقط مالکان گروه می‌توانند پیام ارسال کنند.
  • ALL_IN_DOMAIN_CAN_POST : هر کسی که در حساب کاربری باشد می‌تواند پیام ارسال کند.
  • ANYONE_CAN_POST : هر کاربر اینترنتی که خارج از حساب شما باشد می‌تواند به سرویس Google Groups شما دسترسی پیدا کند و پیامی ارسال کند.
entry/ apps:allowWebPosting object اجازه ارسال پست از وب را می‌دهد. مقادیر ممکن عبارتند از:
  • true : به هر عضوی اجازه می‌دهد تا در انجمن گروه پست ارسال کند.
  • false : اعضا فقط از Gmail برای ارتباط با گروه استفاده می‌کنند.
entry/ apps:primaryLanguage object زبان اصلی گروه. از برچسب‌های زبان در جدول زبان‌های پشتیبانی‌شده استفاده کنید.
entry/ apps:maxMessageBytes object منسوخ شده . حداکثر اندازه یک پیام ۲۵ مگابایت است.
entry/ apps:isArchived object امکان بایگانی محتویات گروه را فراهم می‌کند. مقادیر ممکن عبارتند از:
  • true : پیام‌های ارسال شده به گروه را بایگانی می‌کند.
  • false : آرشیوی از پیام‌های ارسالی به این گروه نگهداری نشود. اگر false ، پیام‌های آرشیو شده قبلی در آرشیو باقی می‌مانند.
entry/ apps:archiveOnly object فقط به گروه اجازه بایگانی شدن می‌دهد. مقادیر ممکن عبارتند از:
  • true : گروه بایگانی شده و غیرفعال است. پیام‌های جدید به این گروه رد می‌شوند. پیام‌های بایگانی شده قدیمی‌تر قابل مرور و جستجو هستند.
    • اگر true ، ویژگی whoCanPostMessage روی NONE_CAN_POST تنظیم می‌شود.
    • اگر از true به false برگردانده شود، whoCanPostMessages روی ALL_MANAGERS_CAN_POST تنظیم می‌شود.
  • false : گروه فعال است و می‌تواند پیام دریافت کند.
    • وقتی false ، به‌روزرسانی whoCanPostMessage به NONE_CAN_POST منجر به خطا می‌شود.
entry/ apps:messageModerationLevel object سطح مدیریت پیام‌های دریافتی. مقادیر ممکن عبارتند از:
  • MODERATE_ALL_MESSAGES : همه پیام‌ها برای تأیید به آدرس ایمیل صاحب گروه ارسال می‌شوند. در صورت تأیید، پیام به گروه ارسال می‌شود.
  • MODERATE_NON_MEMBERS : تمام پیام‌های ارسالی از اعضای غیر گروه برای تأیید به آدرس ایمیل صاحب گروه ارسال می‌شوند. در صورت تأیید، پیام به گروه ارسال می‌شود.
  • MODERATE_NEW_MEMBERS : تمام پیام‌های اعضای جدید برای تأیید به آدرس ایمیل صاحب گروه ارسال می‌شود. در صورت تأیید، پیام به گروه ارسال می‌شود.
  • MODERATE_NONE : نیازی به تأیید مدیر نیست. پیام‌ها مستقیماً به گروه ارسال می‌شوند.
entry/ apps:spamModerationLevel object سطوح مدیریت پیام‌های شناسایی‌شده به عنوان هرزنامه را مشخص می‌کند. مقادیر ممکن عبارتند از:
  • ALLOW : پیام را در گروه ارسال کنید.
  • MODERATE : پیام را به صف بررسی ارسال می‌کند. این حالت پیش‌فرض است.
  • SILENTLY_MODERATE : پیام را به صف بررسی ارسال می‌کند، اما برای مدیران اعلان ارسال نمی‌کند.
  • REJECT : پیام را فوراً رد کنید.
entry/ apps:replyTo object مشخص می‌کند که پاسخ پیش‌فرض باید به چه کسی ارسال شود. مقادیر ممکن عبارتند از:
  • REPLY_TO_CUSTOM : برای پاسخ به پیام‌ها، از آدرس ایمیل سفارشی گروه استفاده کنید.

    وقتی ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo آدرس ایمیل سفارشی مورد استفاده هنگام پاسخ دادن به یک پیام را در خود نگه می‌دارد. اگر ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo باید دارای مقدار باشد. در غیر این صورت خطا برگردانده می‌شود.

  • REPLY_TO_SENDER : پاسخی که به نویسنده پیام ارسال شده است.
  • REPLY_TO_LIST : این پیام پاسخ به گروه ارسال می‌شود.
  • REPLY_TO_OWNER : پاسخ به مالکان گروه ارسال می‌شود. این شامل مدیران گروه نمی‌شود.
  • REPLY_TO_IGNORE : کاربران گروه به صورت جداگانه تصمیم می‌گیرند که پاسخ پیام به کجا ارسال شود.
  • REPLY_TO_MANAGERS : این پیام پاسخ به مدیران گروه ارسال می‌شود که شامل همه مدیران و مالک گروه می‌شود.
entry/ apps:customReplyTo object آدرس ایمیلی که هنگام پاسخ دادن به یک پیام استفاده می‌شود، اگر ویژگی replyTo روی REPLY_TO_CUSTOM تنظیم شده باشد. این آدرس توسط مدیر حساب تعریف می‌شود.
  • وقتی ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo یک آدرس ایمیل سفارشی را در خود نگه می‌دارد که هنگام پاسخ دادن به یک پیام استفاده می‌شود.
  • اگر ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo باید یک مقدار متنی داشته باشد در غیر این صورت خطا برگردانده می‌شود.
entry/ apps:includeCustomFooter object آیا پاورقی سفارشی اضافه شود؟ مقادیر ممکن عبارتند از:
  • true
  • false
entry/ apps:customFooterText object محتوای متن سفارشی پاورقی را تنظیم کنید. حداکثر تعداد کاراکترها ۱۰۰۰ است.
entry/ apps:sendMessageDenyNotification object به عضو اجازه می‌دهد در صورت رد پیامش به گروه توسط صاحب گروه، مطلع شود. مقادیر ممکن عبارتند از:
  • true : وقتی پیامی رد می‌شود، اعلان پیام رد را به نویسنده پیام ارسال کن.

    ویژگی defaultMessageDenyNotificationText به true بودن ویژگی sendMessageDenyNotification وابسته است.

  • false : وقتی پیامی رد می‌شود، هیچ اعلانی ارسال نمی‌شود.
entry/ apps:defaultMessageDenyNotificationText object وقتی پیامی رد می‌شود، این متن اعلان رد به نویسنده پیام ارسال می‌شود. به طور پیش‌فرض، این ویژگی خالی است و هیچ مقداری در بدنه پاسخ API ندارد. حداکثر اندازه متن اعلان ۱۰۰۰۰ کاراکتر است.
entry/ apps:showInGroupDirectory object منسوخ شده . این با تنظیمات whoCanDiscoverGroup ادغام شده است. به گروه اجازه می‌دهد تا در فهرست گروه‌ها قابل مشاهده باشد. مقادیر ممکن عبارتند از:
  • true : همه گروه‌های موجود در حساب در فهرست Groups فهرست شده‌اند.
  • false : همه گروه‌های موجود در حساب در دایرکتوری فهرست نشده‌اند.
entry/ apps:allowGoogleCommunication object منسوخ شده . به گوگل اجازه می‌دهد تا با مدیر گروه تماس بگیرد.
  • true : به گوگل اجازه دهید با مدیران این گروه تماس بگیرد. گاهی اوقات ممکن است گوگل به‌روزرسانی‌هایی در مورد آخرین ویژگی‌ها ارسال کند، در مورد ویژگی‌های جدید نظرخواهی کند یا برای برجسته کردن گروه شما اجازه بخواهد.
  • false : گوگل نمی‌تواند با مدیران این گروه تماس بگیرد.
entry/ apps:membersCanPostAsTheGroup object اعضا را قادر می‌سازد تا به عنوان گروه پیام ارسال کنند. مقادیر ممکن عبارتند از:
  • true : اعضای گروه می‌توانند به جای آدرس ایمیل خود، با استفاده از آدرس ایمیل گروه پیام ارسال کنند. به نظر می‌رسد که پیام از خود گروه ارسال می‌شود.
  • false : اعضا نمی‌توانند از طرف آدرس ایمیل گروه پست ارسال کنند.
entry/ apps:messageDisplayFont object منسوخ شده . فونت پیش‌فرض نمایش پیام همیشه مقداری برابر با DEFAULT_FONT دارد.
entry/ apps:includeInGlobalAddressList object این امکان را فراهم می‌کند که گروه در فهرست آدرس‌های سراسری قرار گیرد. برای اطلاعات بیشتر، به مرکز راهنما مراجعه کنید. مقادیر ممکن عبارتند از:
  • true : گروه در فهرست آدرس‌های سراسری قرار دارد.
  • false : گروه در فهرست آدرس‌های سراسری قرار ندارد.
entry/ apps:whoCanLeaveGroup object مشخص می‌کند چه کسی می‌تواند گروه را ترک کند. مقادیر ممکن عبارتند از:
  • ALL_MANAGERS_CAN_LEAVE
  • ALL_MEMBERS_CAN_LEAVE
  • NONE_CAN_LEAVE
entry/ apps:whoCanContactOwner object مشخص می‌کند چه کسی می‌تواند با مالک گروه تماس بگیرد. مقادیر ممکن عبارتند از:
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
entry/ apps:whoCanAddReferences object منسوخ شده . این قابلیت دیگر در رابط کاربری گروه‌های گوگل پشتیبانی نمی‌شود. مقدار آن همیشه NONE است.
entry/ apps:whoCanAssignTopics object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات یک انجمن را به کاربر دیگری اختصاص دهد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanUnassignTopic object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند هر موضوعی را در یک انجمن لغو کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanTakeTopics object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند در یک انجمن موضوعات را بپذیرد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMarkDuplicate object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند یک موضوع را به عنوان تکراری از موضوع دیگر علامت‌گذاری کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMarkNoResponseNeeded object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند یک موضوع را به عنوان موضوعی که نیازی به پاسخ ندارد علامت‌گذاری کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMarkFavoriteReplyOnAnyTopic object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پست هر کاربر دیگری را به عنوان پاسخ مورد علاقه علامت‌گذاری کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMarkFavoriteReplyOnOwnTopic object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پستی را برای موضوعی که خودش شروع کرده، به عنوان پاسخ مورد علاقه علامت‌گذاری کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanUnmarkFavoriteReplyOnAnyTopic object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند علامت هر پستی را از پاسخ مورد علاقه‌اش بردارد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanEnterFreeFormTags object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند برچسب‌های فرم آزاد را برای موضوعات در یک انجمن وارد کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanModifyTagsAndCategories object منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند برچسب‌ها و دسته‌بندی‌ها را تغییر دهد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:favoriteRepliesOnTop object مشخص می‌کند که آیا پاسخ‌های مورد علاقه باید بالاتر از سایر پاسخ‌ها نمایش داده شوند یا خیر.
  • true : پاسخ‌های مورد علاقه بالاتر از سایر پاسخ‌ها نمایش داده می‌شوند.
  • false : پاسخ‌های مورد علاقه بالاتر از سایر پاسخ‌ها نمایش داده نمی‌شوند.
entry/ apps:whoCanApproveMembers object منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مشخص می‌کند چه کسی می‌تواند اعضایی را که درخواست عضویت در گروه‌ها را دارند، تأیید کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS_CAN_APPROVE
  • ALL_MANAGERS_CAN_APPROVE
  • ALL_OWNERS_CAN_APPROVE
  • NONE_CAN_APPROVE
entry/ apps:whoCanBanUsers object منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مشخص می‌کند چه کسی می‌تواند عضویت کاربران را رد کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanModifyMembers object منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مشخص می‌کند چه کسی می‌تواند نقش اعضای گروه را تغییر دهد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanApproveMessages object منسوخ شده . این با تنظیم whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پیام‌های در حال انتظار در صف مدیریت را تأیید کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanDeleteAnyPost object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پاسخ‌ها به موضوعات را حذف کند. (نویسندگان همیشه می‌توانند پست‌های خود را حذف کنند). مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanDeleteTopics object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را حذف کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanLockTopics object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند از ارسال پاسخ به موضوعات توسط کاربران جلوگیری کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMoveTopicsIn object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را به گروه یا انجمن منتقل کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMoveTopicsOut object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را از گروه یا انجمن خارج کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanPostAnnouncements object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند اطلاعیه ارسال کند، یک نوع موضوع خاص. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanHideAbuse object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پست‌ها را با گزارش آنها به عنوان سوءاستفاده پنهان کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanMakeTopicsSticky object منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را در بالای لیست موضوعات نمایش دهد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanModerateMembers object مشخص می‌کند چه کسی می‌تواند اعضا را مدیریت کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanModerateContent object مشخص می‌کند چه کسی می‌تواند محتوا را مدیریت کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/ apps:whoCanAssistContent object مشخص می‌کند چه کسی می‌تواند متادیتا را مدیریت کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/ apps:customRolesEnabledForSettingsToBeMerged object مشخص می‌کند که آیا گروه دارای نقش سفارشی است که در یکی از تنظیمات ادغام‌شده گنجانده شده باشد یا خیر. این فیلد فقط خواندنی است و درخواست‌های UPDATE و PATCH به آن نادیده گرفته می‌شوند. مقادیر ممکن عبارتند از:
  • true
  • false
entry/ apps:enableCollaborativeInbox object مشخص می‌کند که آیا صندوق ورودی مشترک برای گروه فعال باقی بماند یا خیر. مقادیر ممکن عبارتند از:
  • true
  • false
entry/ apps:whoCanDiscoverGroup object مجموعه کاربرانی را که این گروه برای آنها قابل شناسایی است، مشخص می‌کند. مقادیر ممکن عبارتند از:
  • ANYONE_CAN_DISCOVER
  • ALL_IN_DOMAIN_CAN_DISCOVER
  • ALL_MEMBERS_CAN_DISCOVER
entry/ apps:defaultSender object فرستنده پیش‌فرض برای اعضایی که می‌توانند به عنوان گروه پیام ارسال کنند. مقادیر ممکن عبارتند از:
  • DEFAULT_SELF
  • GROUP

جی‌سون 

{
  "kind": "groupsSettings#groups",
  "email": string,
  "name": string,
  "description": string,
  "whoCanJoin": string,
  "whoCanViewMembership": string,
  "whoCanViewGroup": string,
  "whoCanInvite": string,
  "whoCanAdd": string,
  "allowExternalMembers": string,
  "whoCanPostMessage": string,
  "allowWebPosting": string,
  "primaryLanguage": string,
  "maxMessageBytes": integer,
  "isArchived": string,
  "archiveOnly": string,
  "messageModerationLevel": string,
  "spamModerationLevel": string,
  "replyTo": string,
  "customReplyTo": string,
  "includeCustomFooter": string,
  "customFooterText": string,
  "sendMessageDenyNotification": string,
  "defaultMessageDenyNotificationText": string,
  "showInGroupDirectory": string,
  "allowGoogleCommunication": string,
  "membersCanPostAsTheGroup": string,
  "messageDisplayFont": string,
  "includeInGlobalAddressList": string,
  "whoCanLeaveGroup": string,
  "whoCanContactOwner": string,
  "whoCanAddReferences": string,
  "whoCanAssignTopics": string,
  "whoCanUnassignTopic": string,
  "whoCanTakeTopics": string,
  "whoCanMarkDuplicate": string,
  "whoCanMarkNoResponseNeeded": string,
  "whoCanMarkFavoriteReplyOnAnyTopic": string,
  "whoCanMarkFavoriteReplyOnOwnTopic": string,
  "whoCanUnmarkFavoriteReplyOnAnyTopic": string,
  "whoCanEnterFreeFormTags": string,
  "whoCanModifyTagsAndCategories": string,
  "favoriteRepliesOnTop": string,
  "whoCanApproveMembers": string,
  "whoCanBanUsers": string,
  "whoCanModifyMembers": string,
  "whoCanApproveMessages": string,
  "whoCanDeleteAnyPost": string,
  "whoCanDeleteTopics": string,
  "whoCanLockTopics": string,
  "whoCanMoveTopicsIn": string,
  "whoCanMoveTopicsOut": string,
  "whoCanPostAnnouncements": string,
  "whoCanHideAbuse": string,
  "whoCanMakeTopicsSticky": string,
  "whoCanModerateMembers": string,
  "whoCanModerateContent": string,
  "whoCanAssistContent": string,
  "customRolesEnabledForSettingsToBeMerged": string,
  "enableCollaborativeInbox": string,
  "whoCanDiscoverGroup": string,
  "defaultSender": string
}

جدول زیر منابع گروه‌ها را نشان می‌دهد:

نام ملک ارزش توضیحات
kind string نوع منبع. همیشه groupsSettings#groups است.
email string آدرس ایمیل گروه. این ویژگی را می‌توان با استفاده از API دایرکتوری به‌روزرسانی کرد.
name string نام گروه، که حداکثر اندازه آن ۷۵ کاراکتر است.
description string توضیحات گروه. اگر هیچ توضیحی برای گروه وارد نشده باشد، مقدار این ویژگی می‌تواند یک رشته خالی باشد. در صورت وارد کردن، حداکثر توضیحات گروه نباید بیش از ۴۰۹۶ کاراکتر باشد.
whoCanJoin string اجازه عضویت در گروه. مقادیر ممکن عبارتند از:
  • ANYONE_CAN_JOIN : هر کاربر اینترنتی، چه در داخل و چه در خارج از دامنه شما، می‌تواند به گروه بپیوندد.
  • ALL_IN_DOMAIN_CAN_JOIN : هر کسی که در دامنه حساب کاربری باشد می‌تواند عضو شود. این شامل حساب‌هایی با چندین دامنه نیز می‌شود.
  • INVITED_CAN_JOIN : از داوطلبان عضویت می‌توان برای عضویت دعوت کرد.
  • CAN_REQUEST_TO_JOIN : افراد غیر عضو می‌توانند برای عضویت درخواست دعوت‌نامه بدهند.
whoCanViewMembership string مجوزهای مشاهده عضویت. مقادیر ممکن عبارتند از:
  • ALL_IN_DOMAIN_CAN_VIEW : هر کسی که در حساب کاربری باشد می‌تواند فهرست اعضای گروه را مشاهده کند.

    اگر گروهی از قبل اعضای خارجی داشته باشد، آن اعضا همچنان می‌توانند به این گروه ایمیل ارسال کنند.

  • ALL_MEMBERS_CAN_VIEW : اعضای گروه می‌توانند فهرست اعضای گروه را مشاهده کنند.
  • ALL_MANAGERS_CAN_VIEW : مدیران گروه می‌توانند فهرست اعضای گروه را مشاهده کنند.
whoCanViewGroup string مجوزهای مشاهده پیام‌های گروهی. مقادیر ممکن عبارتند از:
  • ANYONE_CAN_VIEW : هر کاربر اینترنتی می‌تواند پیام‌های گروه را مشاهده کند.
  • ALL_IN_DOMAIN_CAN_VIEW : هر کسی که در حساب شما باشد می‌تواند پیام‌های این گروه را مشاهده کند.
  • ALL_MEMBERS_CAN_VIEW : همه اعضای گروه می‌توانند پیام‌های گروه را مشاهده کنند.
  • ALL_MANAGERS_CAN_VIEW : هر مدیر گروهی می‌تواند پیام‌های این گروه را مشاهده کند.
whoCanInvite string منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مجوزهای دعوت از اعضای جدید. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS_CAN_INVITE : مدیران و اعضا می‌توانند یک نامزد عضویت جدید را دعوت کنند.
  • ALL_MANAGERS_CAN_INVITE : فقط مدیران می‌توانند عضو جدید دعوت کنند. این شامل مالک گروه نیز می‌شود.
  • ALL_OWNERS_CAN_INVITE : فقط مالکان می‌توانند عضو جدید دعوت کنند.
  • NONE_CAN_INVITE : هیچ‌کس نمی‌تواند کاندیدای عضویت جدید را دعوت کند.
whoCanAdd string منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مجوزهای افزودن اعضا. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS_CAN_ADD : مدیران و اعضا می‌توانند مستقیماً اعضای جدید اضافه کنند.
  • ALL_MANAGERS_CAN_ADD : فقط مدیران می‌توانند مستقیماً اعضای جدید اضافه کنند. این شامل مالک گروه نیز می‌شود.
  • ALL_OWNERS_CAN_ADD : فقط مالکان می‌توانند مستقیماً اعضای جدید اضافه کنند.
  • NONE_CAN_ADD : هیچ‌کس نمی‌تواند مستقیماً اعضای جدید اضافه کند.
allowExternalMembers string مشخص می‌کند که آیا اعضای خارج از سازمان شما می‌توانند به گروه بپیوندند یا خیر. مقادیر ممکن عبارتند از:
  • true : کاربران Google Workspace خارج از سازمان شما می‌توانند عضو این گروه شوند.
  • false : کاربرانی که به سازمان تعلق ندارند، مجاز به عضویت در این گروه نیستند.
whoCanPostMessage string مجوزهای ارسال پیام. مقادیر ممکن عبارتند از:
  • NONE_CAN_POST : این گروه غیرفعال و بایگانی شده است. هیچ کس نمی‌تواند در این گروه پیامی ارسال کند.
    • وقتی archiveOnly برابر با false باشد، به‌روزرسانی whoCanPostMessage به NONE_CAN_POST منجر به خطا می‌شود.
    • اگر archiveOnly از true به false برگردانده شود، whoCanPostMessages روی ALL_MANAGERS_CAN_POST تنظیم می‌شود.
  • ALL_MANAGERS_CAN_POST : مدیران، از جمله صاحبان گروه، می‌توانند پیام ارسال کنند.
  • ALL_MEMBERS_CAN_POST : هر عضو گروه می‌تواند پیام ارسال کند.
  • ALL_OWNERS_CAN_POST : فقط مالکان گروه می‌توانند پیام ارسال کنند.
  • ALL_IN_DOMAIN_CAN_POST : هر کسی که در حساب کاربری باشد می‌تواند پیام ارسال کند.
  • ANYONE_CAN_POST : هر کاربر اینترنتی که خارج از حساب شما باشد می‌تواند به سرویس Google Groups شما دسترسی پیدا کند و پیامی ارسال کند.
allowWebPosting string اجازه ارسال پست از وب را می‌دهد. مقادیر ممکن عبارتند از:
  • true : به هر عضوی اجازه می‌دهد تا در انجمن گروه پست ارسال کند.
  • false : اعضا فقط از Gmail برای ارتباط با گروه استفاده می‌کنند.
primaryLanguage string زبان اصلی گروه. از برچسب‌های زبان در جدول زبان‌های پشتیبانی‌شده استفاده کنید.
maxMessageBytes integer منسوخ شده . حداکثر اندازه یک پیام ۲۵ مگابایت است.
isArchived string امکان بایگانی محتویات گروه را فراهم می‌کند. مقادیر ممکن عبارتند از:
  • true : پیام‌های ارسال شده به گروه را بایگانی می‌کند.
  • false : آرشیوی از پیام‌های ارسالی به این گروه نگهداری نشود. اگر false ، پیام‌های آرشیو شده قبلی در آرشیو باقی می‌مانند.
archiveOnly string فقط به گروه اجازه بایگانی شدن می‌دهد. مقادیر ممکن عبارتند از:
  • true : گروه بایگانی شده و غیرفعال است. پیام‌های جدید به این گروه رد می‌شوند. پیام‌های بایگانی شده قدیمی‌تر قابل مرور و جستجو هستند.
    • اگر true ، ویژگی whoCanPostMessage روی NONE_CAN_POST تنظیم می‌شود.
    • اگر از true به false برگردانده شود، whoCanPostMessages روی ALL_MANAGERS_CAN_POST تنظیم می‌شود.
  • false : گروه فعال است و می‌تواند پیام دریافت کند.
    • وقتی false ، به‌روزرسانی whoCanPostMessage به NONE_CAN_POST منجر به خطا می‌شود.
messageModerationLevel string سطح مدیریت پیام‌های دریافتی. مقادیر ممکن عبارتند از:
  • MODERATE_ALL_MESSAGES : همه پیام‌ها برای تأیید به آدرس ایمیل صاحب گروه ارسال می‌شوند. در صورت تأیید، پیام به گروه ارسال می‌شود.
  • MODERATE_NON_MEMBERS : تمام پیام‌های ارسالی از اعضای غیر گروه برای تأیید به آدرس ایمیل صاحب گروه ارسال می‌شوند. در صورت تأیید، پیام به گروه ارسال می‌شود.
  • MODERATE_NEW_MEMBERS : تمام پیام‌های اعضای جدید برای تأیید به آدرس ایمیل صاحب گروه ارسال می‌شود. در صورت تأیید، پیام به گروه ارسال می‌شود.
  • MODERATE_NONE : نیازی به تأیید مدیر نیست. پیام‌ها مستقیماً به گروه ارسال می‌شوند.
spamModerationLevel string سطوح مدیریت پیام‌های شناسایی‌شده به عنوان هرزنامه را مشخص می‌کند. مقادیر ممکن عبارتند از:
  • ALLOW : پیام را در گروه ارسال کنید.
  • MODERATE : پیام را به صف بررسی ارسال می‌کند. این حالت پیش‌فرض است.
  • SILENTLY_MODERATE : پیام را به صف بررسی ارسال می‌کند، اما برای مدیران اعلان ارسال نمی‌کند.
  • REJECT : پیام را فوراً رد کنید.
replyTo string مشخص می‌کند چه کسی پاسخ پیش‌فرض را دریافت می‌کند. مقادیر ممکن عبارتند از:
  • REPLY_TO_CUSTOM : برای پاسخ به پیام‌ها، از آدرس ایمیل سفارشی گروه استفاده کنید.

    وقتی ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo آدرس ایمیل سفارشی مورد استفاده هنگام پاسخ دادن به یک پیام را در خود نگه می‌دارد. اگر ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo باید دارای مقدار باشد. در غیر این صورت خطا برگردانده می‌شود.

  • REPLY_TO_SENDER : پاسخی که به نویسنده پیام ارسال شده است.
  • REPLY_TO_LIST : این پیام پاسخ به گروه ارسال می‌شود.
  • REPLY_TO_OWNER : پاسخ به مالک(گان) گروه ارسال می‌شود. این شامل مدیران گروه نمی‌شود.
  • REPLY_TO_IGNORE : کاربران گروه به صورت جداگانه تصمیم می‌گیرند که پاسخ پیام به کجا ارسال شود.
  • REPLY_TO_MANAGERS : این پیام پاسخ به مدیران گروه ارسال می‌شود که شامل همه مدیران و مالک گروه می‌شود.
customReplyTo string آدرس ایمیلی که هنگام پاسخ دادن به یک پیام استفاده می‌شود، اگر ویژگی replyTo روی REPLY_TO_CUSTOM تنظیم شده باشد. این آدرس توسط مدیر حساب تعریف می‌شود.
  • وقتی ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo یک آدرس ایمیل سفارشی را در خود نگه می‌دارد که هنگام پاسخ دادن به یک پیام استفاده می‌شود.
  • اگر ویژگی ReplyTo گروه روی REPLY_TO_CUSTOM تنظیم شده باشد، ویژگی customReplyTo باید یک مقدار متنی داشته باشد در غیر این صورت خطا برگردانده می‌شود.
includeCustomFooter string آیا پاورقی سفارشی اضافه شود؟ مقادیر ممکن عبارتند از:
  • true
  • false
customFooterText string محتوای متن سفارشی پاورقی را تنظیم کنید. حداکثر تعداد کاراکترها ۱۰۰۰ است.
sendMessageDenyNotification string به عضو اجازه می‌دهد در صورت رد پیامش به گروه توسط صاحب گروه، مطلع شود. مقادیر ممکن عبارتند از:
  • true : وقتی پیامی رد می‌شود، اعلان پیام رد را به نویسنده پیام ارسال کن.

    ویژگی defaultMessageDenyNotificationText به true بودن ویژگی sendMessageDenyNotification وابسته است.

  • false : وقتی پیامی رد می‌شود، هیچ اعلانی ارسال نمی‌شود.
defaultMessageDenyNotificationText string وقتی پیامی رد می‌شود، این متن اعلان رد به نویسنده پیام ارسال می‌شود. به طور پیش‌فرض، این ویژگی خالی است و هیچ مقداری در بدنه پاسخ API ندارد. حداکثر اندازه متن اعلان ۱۰۰۰۰ کاراکتر است.
showInGroupDirectory string منسوخ شده . این با تنظیمات whoCanDiscoverGroup ادغام شده است. به گروه اجازه می‌دهد تا در فهرست گروه‌ها قابل مشاهده باشد. مقادیر ممکن عبارتند از:
  • true : همه گروه‌های موجود در حساب در فهرست Groups فهرست شده‌اند.
  • false : همه گروه‌های موجود در حساب در دایرکتوری فهرست نشده‌اند.
allowGoogleCommunication string منسوخ شده . به گوگل اجازه می‌دهد تا با مدیر گروه تماس بگیرد.
  • true : به گوگل اجازه دهید با مدیران این گروه تماس بگیرد. گاهی اوقات ممکن است گوگل به‌روزرسانی‌هایی در مورد آخرین ویژگی‌ها ارسال کند، در مورد ویژگی‌های جدید نظرخواهی کند یا برای برجسته کردن گروه شما اجازه بخواهد.
  • false : گوگل نمی‌تواند با مدیران این گروه تماس بگیرد.
membersCanPostAsTheGroup string اعضا را قادر می‌سازد تا به عنوان گروه پیام ارسال کنند. مقادیر ممکن عبارتند از:
  • true : اعضای گروه می‌توانند به جای آدرس ایمیل خود، با استفاده از آدرس ایمیل گروه پیام ارسال کنند. به نظر می‌رسد که پیام از خود گروه ارسال می‌شود.
  • false : اعضا نمی‌توانند از طرف آدرس ایمیل گروه پست ارسال کنند.
messageDisplayFont string منسوخ شده . فونت پیش‌فرض نمایش پیام همیشه مقداری برابر با DEFAULT_FONT دارد.
includeInGlobalAddressList string این امکان را فراهم می‌کند که گروه در فهرست آدرس‌های سراسری قرار گیرد. برای اطلاعات بیشتر، به مرکز راهنما مراجعه کنید. مقادیر ممکن عبارتند از:
  • true : گروه در فهرست آدرس‌های سراسری قرار دارد.
  • false : گروه در فهرست آدرس‌های سراسری قرار ندارد.
whoCanLeaveGroup string اجازه ترک گروه. مقادیر ممکن عبارتند از:
  • ALL_MANAGERS_CAN_LEAVE
  • ALL_MEMBERS_CAN_LEAVE
  • NONE_CAN_LEAVE
whoCanContactOwner string اجازه تماس با صاحب گروه از طریق رابط کاربری وب. مقادیر ممکن عبارتند از:
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
whoCanAddReferences string منسوخ شده. این قابلیت دیگر در رابط کاربری گروه‌های گوگل پشتیبانی نمی‌شود. مقدار آن همیشه «هیچکدام» است.
whoCanAssignTopics string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه اختصاص موضوعات در یک انجمن به کاربر دیگر. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanUnassignTopic string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مجوز لغو تخصیص هر موضوعی در یک انجمن. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanTakeTopics string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مجوز برای طرح موضوعات در یک انجمن. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkDuplicate string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه علامت‌گذاری یک موضوع به عنوان تکراری از موضوع دیگر. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkNoResponseNeeded string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه علامت‌گذاری یک موضوع به عنوان موضوعی که نیازی به پاسخ ندارد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkFavoriteReplyOnAnyTopic string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه علامت‌گذاری پست هر کاربر دیگر به عنوان پاسخ مورد علاقه. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkFavoriteReplyOnOwnTopic string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه علامت‌گذاری پست برای موضوعی که خودشان شروع کرده‌اند به عنوان پاسخ مورد علاقه. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanUnmarkFavoriteReplyOnAnyTopic string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه لغو علامت‌گذاری هر پست از پاسخ مورد علاقه. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanEnterFreeFormTags string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. مجوز وارد کردن برچسب‌های فرم آزاد برای موضوعات در یک انجمن. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanModifyTagsAndCategories string منسوخ شده . این با تنظیمات whoCanAssistContent ادغام شده است. اجازه تغییر برچسب‌ها و دسته‌بندی‌ها. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
favoriteRepliesOnTop string مشخص می‌کند که آیا پاسخ‌های مورد علاقه باید قبل از سایر پاسخ‌ها نمایش داده شوند یا خیر.
  • true : پاسخ‌های مورد علاقه قبل از سایر پاسخ‌ها نمایش داده می‌شوند.
  • false : پاسخ‌های مورد علاقه قبل از سایر پاسخ‌ها نمایش داده نمی‌شوند.
whoCanApproveMembers string منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مشخص می‌کند چه کسی می‌تواند اعضایی را که درخواست عضویت در گروه‌ها را دارند، تأیید کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS_CAN_APPROVE
  • ALL_MANAGERS_CAN_APPROVE
  • ALL_OWNERS_CAN_APPROVE
  • NONE_CAN_APPROVE
whoCanBanUsers string منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مشخص می‌کند چه کسی می‌تواند عضویت کاربران را رد کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModifyMembers string منسوخ شده . این با تنظیمات whoCanModerateMembers ادغام شده است. مشخص می‌کند چه کسی می‌تواند نقش اعضای گروه را تغییر دهد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanApproveMessages string منسوخ شده . این با تنظیم whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پیام‌های در حال انتظار در صف مدیریت را تأیید کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanDeleteAnyPost string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پاسخ‌ها به موضوعات را حذف کند. (نویسندگان همیشه می‌توانند پست‌های خود را حذف کنند). مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanDeleteTopics string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را حذف کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanLockTopics string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند از ارسال پاسخ به موضوعات توسط کاربران جلوگیری کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMoveTopicsIn string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را به گروه یا انجمن منتقل کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMoveTopicsOut string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را از گروه یا انجمن خارج کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanPostAnnouncements string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند اطلاعیه ارسال کند، یک نوع موضوع خاص. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanHideAbuse string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند پست‌ها را با گزارش آنها به عنوان سوءاستفاده پنهان کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMakeTopicsSticky string منسوخ شده . این با تنظیمات whoCanModerateContent ادغام شده است. مشخص می‌کند چه کسی می‌تواند موضوعات را در بالای لیست موضوعات نمایش دهد. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModerateMembers string مشخص می‌کند چه کسی می‌تواند اعضا را مدیریت کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModerateContent string مشخص می‌کند چه کسی می‌تواند محتوا را مدیریت کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanAssistContent string مشخص می‌کند چه کسی می‌تواند متادیتا را مدیریت کند. مقادیر ممکن عبارتند از:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
customRolesEnabledForSettingsToBeMerged string مشخص می‌کند که آیا گروه دارای نقش سفارشی است که در یکی از تنظیمات ادغام‌شده گنجانده شده باشد یا خیر. این فیلد فقط خواندنی است و درخواست‌های UPDATE و PATCH به آن نادیده گرفته می‌شوند. مقادیر ممکن عبارتند از:
  • true
  • false
enableCollaborativeInbox string مشخص می‌کند که آیا صندوق ورودی مشترک برای گروه فعال باقی بماند یا خیر. مقادیر ممکن عبارتند از:
  • true
  • false
whoCanDiscoverGroup string مجموعه کاربرانی را که این گروه برای آنها قابل شناسایی است، مشخص می‌کند. مقادیر ممکن عبارتند از:
  • ANYONE_CAN_DISCOVER
  • ALL_IN_DOMAIN_CAN_DISCOVER
  • ALL_MEMBERS_CAN_DISCOVER
defaultSender string فرستنده پیش‌فرض برای اعضایی که می‌توانند به عنوان گروه پیام ارسال کنند. مقادیر ممکن عبارتند از:
  • DEFAULT_SELF
  • GROUP

روش‌ها

متدهای groupsSettings.groups.get و groupsSettings.groups.update روی یک منبع Groups مشخص شده عمل می‌کنند.

دریافت
تنظیمات گروه را که توسط آدرس ایمیل گروه مشخص شده است، بازیابی می‌کند.
به‌روزرسانی
تنظیمات گروه موجود را که با آدرس ایمیل گروه مشخص می‌شود، به‌روزرسانی می‌کند.
پچ
یک منبع موجود را به‌روزرسانی می‌کند. این روش از معنای وصله (patch semantics) پشتیبانی می‌کند.

زبان‌های پشتیبانی‌شده

کدهای زبان زیر برای فیلد primaryLanguage یک گروه پشتیبانی می‌شوند.

آ
آب
اف
هستم
آر
به عنوان
آی
آز
با
باش
بی جی
به
بی
بی ان
بو
بر
بی اس
حدود
شرکت
سی اس
سی
دا
د
دی زد
ال
انگلیسی
انگلیسی-بریتانیایی
شبه-انگلیسی-en-US
فارسی
ائو
ها
و
اتحادیه اروپا
فا
فی
اف جی
فو
فر		 fr-CA
فی
گا
جی دی
گل
گ
گو
هکتار
سلام
ساعت
هو
های
ایا
شناسه
یعنی
آی کی
است
آن
آی یو
آی دبلیو
جا
جی دبلیو
کا
ک.ک.
کی ال
کیلومتر
کن
کو
کس
کو
کی
لا
ل.ن.
لو
آن
lv
میلی‌گرم
من		 مک
میلی‌لیتر
من
مو
آقای
ام‌اس
کوه
من
نه
نه
ان ال
ان
خیر
او سی
اوم
یا
پا
پل
ص
پی تی-بی آر
پی تی-پی تی
کو
رم
آر ان
رو
انگشت های دست فاصله
آر دبلیو
سا
اس دی
اس جی
ش
سی
اسک
اس ال
اس ام
اس ان
بنابراین
مربع		 اس آر
اس اس
خیابان
سو
اس وی
جنوب غربی
تا
ته
تی‌جی
هفتم
تی
تی کی
تل
تن
به
تر
تی اس
تی تی
دو
اوگ
انگلستان
تو
یو پی اس
وی
وو
وو
ایکس اچ
xx-بورک
xx-elmer
هکر xx
xx-کلینگون
xx-پیگلاتین
یی
یو
زا
zh-CN
zh-TW
زو