Groups

Tài nguyên Groups là lớp dữ liệu gốc cho Groups Settings API. Mỗi tài nguyên Nhóm đều được liên kết với một tập hợp các chế độ cài đặt.

Để biết thêm thông tin, hãy xem danh sách phương thức cho tài nguyên này.

Cách trình bày tài nguyên

Tài nguyên Nhóm bao gồm siêu dữ liệu có thông tin tóm tắt về chế độ cài đặt của một nhóm cụ thể. Các chế độ cài đặt này quản lý quyền truy cập, thông báo, hoạt động lưu trữ cuộc thảo luận, kiểm duyệt tin nhắn của nhóm và tuỳ chỉnh nhóm người dùng của tài khoản.

Theo mặc định, dữ liệu tài nguyên Nhóm được trả về ở định dạng dữ liệu JSON.

Atom

<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>

Bảng sau đây cho biết các tài nguyên của Groups:

Tên tài sản Giá trị Mô tả
entry object Tài nguyên Nhóm
entry/xmlns string Giản đồ cho định dạng Atom
entry/xmlns:apps string Lược đồ cho định dạng I/O của Google Workspace
entry/xmlns:gd string Giản đồ cho giao thức Dữ liệu của Google
entry/id object Giá trị nhận dạng duy nhất của một tài nguyên Nhóm
entry/title object Tiêu đề của mục nhập Atom trong API, là Groups Resource Entry
entry/content object Loại nội dung của mục nhập Atom
entry/content/type string Loại nội dung của nguồn cấp dữ liệu Atom là text
entry/author object Thẻ tác giả cho mục nhập Atom
entry/author/name object Tên của tác giả, đó là Google
entry/apps:email object

Địa chỉ email của nhóm. Bạn có thể cập nhật thuộc tính này bằng Directory API.

entry/apps:name object Tên nhóm. Tên của một nhóm có tối đa 75 ký tự.
entry/apps:description object Nội dung mô tả về nhóm. Giá trị thuộc tính này có thể là một chuỗi trống nếu bạn chưa nhập nội dung mô tả nhóm. Nếu bạn nhập, nội dung mô tả nhóm tối đa không được vượt quá 4.096 ký tự.
entry/apps:whoCanJoin object Quyền tham gia nhóm. Các giá trị có thể là:
  • ANYONE_CAN_JOIN: Bất kỳ người dùng Internet nào, cả trong và ngoài miền của bạn, đều có thể tham gia nhóm.
  • ALL_IN_DOMAIN_CAN_JOIN: Mọi người trong miền tài khoản đều có thể tham gia. Trong đó có cả những tài khoản có nhiều miền.
  • INVITED_CAN_JOIN: Bạn có thể mời những người đủ điều kiện tham gia chương trình hội viên.
  • CAN_REQUEST_TO_JOIN: Người không phải là thành viên có thể yêu cầu lời mời tham gia.
entry/apps:whoCanViewMembership object Quyền xem tư cách thành viên. Các giá trị có thể là:
  • ALL_IN_DOMAIN_CAN_VIEW: Bất kỳ ai trong tài khoản đều có thể xem danh sách thành viên nhóm.

    Nếu một nhóm đã có thành viên bên ngoài, thì những thành viên đó vẫn có thể gửi email cho nhóm này.

  • ALL_MEMBERS_CAN_VIEW: Các thành viên nhóm có thể xem danh sách thành viên nhóm.
  • ALL_MANAGERS_CAN_VIEW: Người quản lý nhóm có thể xem danh sách thành viên nhóm.
entry/apps:whoCanViewGroup object Quyền xem tin nhắn theo nhóm. Các giá trị có thể là:
  • ANYONE_CAN_VIEW: Mọi người dùng Internet đều có thể xem tin nhắn của nhóm.
  • ALL_IN_DOMAIN_CAN_VIEW: Bất kỳ ai trong tài khoản của bạn đều có thể xem tin nhắn của nhóm này.
  • ALL_MEMBERS_CAN_VIEW: Tất cả thành viên nhóm đều có thể xem tin nhắn của nhóm.
  • ALL_MANAGERS_CAN_VIEW: Mọi người quản lý nhóm đều có thể xem tin nhắn của nhóm này.
  • ALL_OWNERS_CAN_VIEW: Mọi chủ sở hữu nhóm đều có thể xem tin nhắn của nhóm này.
entry/apps:whoCanInvite object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Quyền mời thành viên mới. Các giá trị có thể là:
  • ALL_MEMBERS_CAN_INVITE: Người quản lý và thành viên có thể mời một người mới tham gia.
  • ALL_MANAGERS_CAN_INVITE: Chỉ người quản lý mới có thể mời thành viên mới. bao gồm cả chủ sở hữu của nhóm.
  • ALL_OWNERS_CAN_INVITE: Chỉ chủ sở hữu mới có thể mời thành viên mới.
  • NONE_CAN_INVITE: Không ai có thể mời một ứng viên thành viên mới.
entry/apps:whoCanAdd object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Quyền thêm trực tiếp thành viên mới. Các giá trị có thể là:
  • ALL_MEMBERS_CAN_ADD: Người quản lý và thành viên có thể trực tiếp thêm thành viên mới.
  • ALL_MANAGERS_CAN_ADD: Chỉ người quản lý mới có thể trực tiếp thêm thành viên mới. bao gồm cả chủ sở hữu của nhóm.
  • ALL_OWNERS_CAN_ADD: Chỉ chủ sở hữu mới có thể thêm trực tiếp thành viên mới.
  • NONE_CAN_ADD: Không ai có thể trực tiếp thêm thành viên mới.
entry/apps:allowExternalMembers object Xác định xem các thành viên bên ngoài tổ chức của bạn có thể tham gia nhóm hay không. Các giá trị có thể sử dụng là:
  • true: Người dùng Google Workspace bên ngoài tổ chức của bạn có thể trở thành thành viên của nhóm này.
  • false: Người dùng không thuộc tổ chức này không được phép trở thành thành viên của nhóm này.
entry/apps:whoCanPostMessage object Quyền đăng tin nhắn. Các giá trị có thể là:
  • NONE_CAN_POST: Nhóm này đã bị vô hiệu hoá và lưu trữ. Không ai có thể đăng tin nhắn lên nhóm này.
    • Khi archiveOnly là false, việc cập nhật whoCanPostMessage thành NONE_CAN_POST sẽ dẫn đến lỗi.
    • Nếu archiveOnly được chuyển từ true về false, thì whoCanPostMessages sẽ được đặt thành ALL_MANAGERS_CAN_POST.
  • ALL_MANAGERS_CAN_POST: Người quản lý (bao gồm cả chủ sở hữu nhóm) có thể đăng tin nhắn.
  • ALL_MEMBERS_CAN_POST: Mọi thành viên nhóm đều có thể đăng tin nhắn.
  • ALL_OWNERS_CAN_POST: Chỉ chủ sở hữu nhóm mới có thể đăng tin nhắn.
  • ALL_IN_DOMAIN_CAN_POST: Mọi người trong tài khoản đều có thể đăng tin nhắn.
  • ANYONE_CAN_POST: Bất kỳ người dùng Internet nào không thuộc tài khoản của bạn đều có thể truy cập vào dịch vụ Google Groups và đăng tin nhắn.
entry/apps:allowWebPosting object Cho phép đăng từ web. Các giá trị có thể là:
  • true: Cho phép mọi thành viên đăng bài lên diễn đàn của nhóm.
  • false: Thành viên chỉ sử dụng Gmail để liên lạc với nhóm.
entry/apps:primaryLanguage object Ngôn ngữ chính của nhóm. Sử dụng thẻ ngôn ngữ trong bảng Ngôn ngữ được hỗ trợ.
entry/apps:maxMessageBytes object Không dùng nữa. Kích thước tối đa của một thư là 25 MB.
entry/apps:isArchived object Cho phép lưu trữ nội dung của Nhóm. Các giá trị có thể là:
  • true: Lưu trữ thư gửi đến nhóm.
  • false: Không lưu trữ tin nhắn đã gửi đến nhóm này. Nếu bạn false, các tin nhắn đã lưu trữ trước đó vẫn sẽ nằm trong kho lưu trữ.
entry/apps:archiveOnly object Chỉ cho phép lưu trữ nhóm. Các giá trị có thể là:
  • true: Nhóm đã được lưu trữ và không hoạt động. Tin nhắn mới gửi đến nhóm này sẽ bị từ chối. Bạn có thể duyệt xem và tìm kiếm các tin nhắn cũ đã lưu trữ.
    • Nếu true, thuộc tính whoCanPostMessage được đặt thành NONE_CAN_POST.
    • Nếu được chuyển từ true về false, whoCanPostMessages sẽ được đặt thành ALL_MANAGERS_CAN_POST.
  • false: Nhóm đang hoạt động và có thể nhận tin nhắn.
    • Khi false, việc cập nhật whoCanPostMessage thành NONE_CAN_POST sẽ dẫn đến lỗi.
entry/apps:messageModerationLevel object Mức độ kiểm duyệt của tin nhắn đến. Các giá trị có thể là:
  • MODERATE_ALL_MESSAGES: Tất cả thư đều được gửi đến địa chỉ email của chủ sở hữu nhóm để phê duyệt. Nếu được phê duyệt, thư sẽ được gửi đến nhóm.
  • MODERATE_NON_MEMBERS: Tất cả thư của những người không phải là thành viên nhóm sẽ được gửi đến địa chỉ email của chủ sở hữu nhóm để phê duyệt. Nếu được phê duyệt, thư sẽ được gửi đến nhóm.
  • MODERATE_NEW_MEMBERS: Tất cả thư của thành viên mới đều được gửi đến địa chỉ email của chủ sở hữu nhóm để phê duyệt. Nếu được phê duyệt, thư sẽ được gửi đến nhóm.
  • MODERATE_NONE: Không cần người kiểm duyệt phê duyệt. Tin nhắn sẽ được gửi trực tiếp đến nhóm.
entry/apps:spamModerationLevel object Chỉ định các mức kiểm duyệt cho những thư bị phát hiện là thư rác. Các giá trị có thể là:
  • ALLOW: Đăng tin nhắn lên nhóm.
  • MODERATE: Gửi tin nhắn đến hàng đợi kiểm duyệt. Đây là tuỳ chọn mặc định.
  • SILENTLY_MODERATE: Gửi bài đăng đến hàng đợi kiểm duyệt nhưng không gửi thông báo cho người kiểm duyệt.
  • REJECT: Từ chối ngay lập tức thư.
entry/apps:replyTo object Chỉ định người nhận phản hồi mặc định. Các giá trị có thể là:
  • REPLY_TO_CUSTOM: Đối với câu trả lời cho tin nhắn, hãy sử dụng địa chỉ email tuỳ chỉnh của nhóm.

    Khi thuộc tính ReplyTo của nhóm được đặt thành REPLY_TO_CUSTOM, thuộc tính customReplyTo sẽ giữ địa chỉ email tuỳ chỉnh được dùng khi trả lời một thông báo. Nếu bạn đặt thuộc tính ReplyTo của nhóm thành REPLY_TO_CUSTOM, thì thuộc tính customReplyTo phải có một giá trị. Nếu không, lỗi sẽ được trả về.

  • REPLY_TO_SENDER: Câu trả lời được gửi cho tác giả của tin nhắn.
  • REPLY_TO_LIST: Tin nhắn trả lời này sẽ được gửi đến nhóm.
  • REPLY_TO_OWNER: Câu trả lời được gửi đến chủ sở hữu của nhóm. Số lượng này không bao gồm người quản lý của nhóm.
  • REPLY_TO_IGNORE: Từng người dùng trong nhóm quyết định địa chỉ nhận câu trả lời cho tin nhắn.
  • REPLY_TO_MANAGERS: Thông báo trả lời này được gửi đến người quản lý nhóm, bao gồm tất cả người quản lý và chủ sở hữu nhóm.
entry/apps:customReplyTo object Địa chỉ email dùng khi trả lời thư nếu bạn đặt thuộc tính replyTo thành REPLY_TO_CUSTOM. Địa chỉ này do một quản trị viên tài khoản xác định.
  • Khi thuộc tính ReplyTo của nhóm được đặt thành REPLY_TO_CUSTOM, thuộc tính customReplyTo sẽ giữ một địa chỉ email tuỳ chỉnh được dùng khi trả lời thư.
  • Nếu bạn đặt thuộc tính ReplyTo của nhóm thành REPLY_TO_CUSTOM, thì thuộc tính customReplyTo phải có giá trị văn bản, nếu không sẽ trả về lỗi.
entry/apps:includeCustomFooter object Có bao gồm chân trang tuỳ chỉnh hay không. Các giá trị có thể là:
  • true
  • false
entry/apps:customFooterText object Đặt nội dung cho văn bản chân trang tuỳ chỉnh. Số lượng ký tự tối đa là 1.000.
entry/apps:sendMessageDenyNotification object Cho phép thành viên nhận được thông báo nếu chủ sở hữu nhóm từ chối thư của thành viên gửi đến nhóm. Các giá trị có thể là:
  • true: Khi một bài viết bị từ chối, hãy gửi thông báo từ chối bài viết cho tác giả của bài viết đó.

    Thuộc tính defaultMessageDenyNotificationText phụ thuộc vào thuộc tính sendMessageDenyNotificationtrue.

  • false: Khi một tin nhắn bị từ chối, hệ thống sẽ không gửi thông báo.
entry/apps:defaultMessageDenyNotificationText object Khi một thông báo bị từ chối, đây là văn bản của thông báo từ chối được gửi cho tác giả của thông báo đó. Theo mặc định, thuộc tính này sẽ trống và không có giá trị trong phần nội dung phản hồi của API. Kích thước văn bản tối đa của thông báo là 10.000 ký tự.
entry/apps:showInGroupDirectory object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanDiscoverGroup. Cho phép nhóm xuất hiện trong Thư mục Groups. Các giá trị có thể là:
  • true: Tất cả các nhóm trong tài khoản đều được liệt kê trong Thư mục Groups.
  • false: Tất cả các nhóm trong tài khoản đều không có trong danh bạ.
entry/apps:allowGoogleCommunication object Không dùng nữa. Cho phép Google liên hệ với quản trị viên của nhóm.
  • true: Cho phép Google liên hệ với người quản lý của nhóm này. Đôi khi, Google có thể gửi thông tin cập nhật về các tính năng mới nhất, yêu cầu bạn đóng góp ý kiến về các tính năng mới hoặc yêu cầu bạn cho phép Google làm nổi bật nhóm của bạn.
  • false: Google không thể liên hệ với người quản lý của nhóm này.
entry/apps:membersCanPostAsTheGroup object Cho phép thành viên đăng tin nhắn với tư cách là nhóm. Các giá trị có thể là:
  • true: Thành viên nhóm có thể đăng bài viết bằng địa chỉ email của nhóm thay vì địa chỉ email của chính họ. Tin nhắn có vẻ như đến từ chính nhóm đó.
  • false: Thành viên không thể đăng bài thay mặt cho địa chỉ email của nhóm.
entry/apps:messageDisplayFont object Không dùng nữa. Phông chữ hiển thị thông báo mặc định luôn có giá trị là DEFAULT_FONT.
entry/apps:includeInGlobalAddressList object Cho phép nhóm xuất hiện trong Danh sách địa chỉ chung. Để biết thêm thông tin, hãy truy cập trung tâm trợ giúp. Các giá trị có thể là:
  • true: Nhóm có trong Danh sách địa chỉ chung.
  • false: Nhóm không có trong Danh sách địa chỉ chung.
entry/apps:whoCanLeaveGroup object Chỉ định những người có thể rời khỏi nhóm. Các giá trị có thể là:
  • ALL_MANAGERS_CAN_LEAVE
  • ALL_MEMBERS_CAN_LEAVE
  • NONE_CAN_LEAVE
entry/apps:whoCanContactOwner object Chỉ định những người có thể liên hệ với chủ sở hữu nhóm. Các giá trị có thể là:
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
entry/apps:whoCanAddReferences object Không dùng nữa. Chức năng này không còn được hỗ trợ trong giao diện người dùng của Google Groups. Giá trị này luôn là NONE.
entry/apps:whoCanAssignTopics object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định những người có thể giao chủ đề trong diễn đàn cho người dùng khác. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanUnassignTopic object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định người có thể bỏ chỉ định mọi chủ đề trong diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanTakeTopics object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định người có thể nhận chủ đề trong diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkDuplicate object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định những người có thể đánh dấu một chủ đề là trùng lặp với một chủ đề khác. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkNoResponseNeeded object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định những người có thể đánh dấu một chủ đề là không cần trả lời. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkFavoriteReplyOnAnyTopic object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định những người có thể đánh dấu bài đăng của người dùng khác là bài viết trả lời yêu thích. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMarkFavoriteReplyOnOwnTopic object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Xác định những người có thể đánh dấu một bài đăng là bài viết trả lời yêu thích cho chủ đề mà họ đã bắt đầu. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanUnmarkFavoriteReplyOnAnyTopic object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định những người có thể bỏ đánh dấu bài viết trả lời yêu thích. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanEnterFreeFormTags object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định người có thể nhập thẻ dạng tự do cho các chủ đề trong diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModifyTagsAndCategories object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Chỉ định người có thể thay đổi thẻ và danh mục. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:favoriteRepliesOnTop object Cho biết liệu các câu trả lời yêu thích có nên xuất hiện phía trên các câu trả lời khác hay không.
  • true: Các câu trả lời yêu thích sẽ xuất hiện phía trên các câu trả lời khác.
  • false: Các câu trả lời yêu thích sẽ không xuất hiện phía trên các câu trả lời khác.
entry/apps:whoCanApproveMembers object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Chỉ định những người có thể phê duyệt thành viên yêu cầu tham gia nhóm. Các giá trị có thể sử dụng là:
  • ALL_MEMBERS_CAN_APPROVE
  • ALL_MANAGERS_CAN_APPROVE
  • ALL_OWNERS_CAN_APPROVE
  • NONE_CAN_APPROVE
entry/apps:whoCanBanUsers object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Chỉ định người có thể từ chối cấp quyền thành viên cho người dùng. Các giá trị có thể sử dụng là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModifyMembers object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Chỉ định người có thể thay đổi vai trò của các thành viên trong nhóm. Các giá trị có thể sử dụng là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanApproveMessages object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể phê duyệt các tin nhắn đang chờ xử lý trong hàng đợi kiểm duyệt. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanDeleteAnyPost object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể xoá câu trả lời cho chủ đề. (Tác giả luôn có thể xoá bài đăng của chính mình). Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanDeleteTopics object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể xoá chủ đề. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanLockTopics object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể ngăn người dùng đăng câu trả lời cho các chủ đề. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMoveTopicsIn object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể di chuyển chủ đề vào nhóm hoặc diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMoveTopicsOut object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể di chuyển chủ đề ra khỏi nhóm hoặc diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanPostAnnouncements object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể đăng thông báo, một loại chủ đề đặc biệt. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanHideAbuse object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể ẩn bài đăng bằng cách báo cáo bài đăng đó là nội dung vi phạm. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanMakeTopicsSticky object Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể hiển thị các chủ đề ở đầu danh sách chủ đề. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModerateMembers object Chỉ định người có thể quản lý thành viên. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanModerateContent object Chỉ định những người có thể kiểm duyệt nội dung. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
entry/apps:whoCanAssistContent object Chỉ định người có thể kiểm duyệt siêu dữ liệu. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
entry/apps:customRolesEnabledForSettingsToBeMerged object Chỉ định xem nhóm có vai trò tùy chỉnh được đưa vào một trong các chế độ cài đặt đang được hợp nhất hay không. Trường này ở chế độ chỉ đọc và các yêu cầu UPDATEPATCH đối với trường này sẽ bị bỏ qua. Các giá trị có thể là:
  • true
  • false
entry/apps:enableCollaborativeInbox object Chỉ định xem hộp thư đến cộng tác có tiếp tục bật cho nhóm hay không. Các giá trị có thể là:
  • true
  • false
entry/apps:whoCanDiscoverGroup object Chỉ định nhóm người dùng mà nhóm này có thể được phát hiện. Các giá trị có thể là:
  • ANYONE_CAN_DISCOVER
  • ALL_IN_DOMAIN_CAN_DISCOVER
  • ALL_MEMBERS_CAN_DISCOVER
entry/apps:defaultSender object Người gửi mặc định cho những thành viên có thể đăng bài viết dưới tên nhóm. Các giá trị có thể là:
  • DEFAULT_SELF
  • GROUP

JSON

{
  "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
}

Bảng sau đây cho biết các tài nguyên của Groups:

Tên tài sản Giá trị Mô tả
kind string Loại tài nguyên. Giá trị này luôn là groupsSettings#groups.
email string Địa chỉ email của nhóm. Bạn có thể cập nhật thuộc tính này bằng Directory API.
name string Tên của nhóm, có kích thước tối đa là 75 ký tự.
description string Nội dung mô tả nhóm. Giá trị thuộc tính này có thể là một chuỗi trống nếu bạn chưa nhập nội dung mô tả nhóm. Nếu bạn nhập, nội dung mô tả nhóm tối đa không được vượt quá 4.096 ký tự.
whoCanJoin string Quyền tham gia nhóm. Các giá trị có thể là:
  • ANYONE_CAN_JOIN: Bất kỳ người dùng Internet nào, cả trong và ngoài miền của bạn, đều có thể tham gia nhóm.
  • ALL_IN_DOMAIN_CAN_JOIN: Mọi người trong miền tài khoản đều có thể tham gia. Trong đó có cả những tài khoản có nhiều miền.
  • INVITED_CAN_JOIN: Bạn có thể mời những người đủ điều kiện tham gia chương trình hội viên.
  • CAN_REQUEST_TO_JOIN: Người không phải là thành viên có thể yêu cầu lời mời tham gia.
whoCanViewMembership string Quyền xem tư cách thành viên. Các giá trị có thể là:
  • ALL_IN_DOMAIN_CAN_VIEW: Bất kỳ ai trong tài khoản đều có thể xem danh sách thành viên nhóm.

    Nếu một nhóm đã có thành viên bên ngoài, thì những thành viên đó vẫn có thể gửi email cho nhóm này.

  • ALL_MEMBERS_CAN_VIEW: Các thành viên nhóm có thể xem danh sách thành viên nhóm.
  • ALL_MANAGERS_CAN_VIEW: Người quản lý nhóm có thể xem danh sách thành viên nhóm.
whoCanViewGroup string Quyền xem tin nhắn theo nhóm. Các giá trị có thể là:
  • ANYONE_CAN_VIEW: Mọi người dùng Internet đều có thể xem tin nhắn của nhóm.
  • ALL_IN_DOMAIN_CAN_VIEW: Bất kỳ ai trong tài khoản của bạn đều có thể xem tin nhắn của nhóm này.
  • ALL_MEMBERS_CAN_VIEW: Tất cả thành viên nhóm đều có thể xem tin nhắn của nhóm.
  • ALL_MANAGERS_CAN_VIEW: Mọi người quản lý nhóm đều có thể xem tin nhắn của nhóm này.
whoCanInvite string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Quyền mời thành viên mới. Các giá trị có thể là:
  • ALL_MEMBERS_CAN_INVITE: Người quản lý và thành viên có thể mời một người mới tham gia.
  • ALL_MANAGERS_CAN_INVITE: Chỉ người quản lý mới có thể mời thành viên mới. bao gồm cả chủ sở hữu của nhóm.
  • ALL_OWNERS_CAN_INVITE: Chỉ chủ sở hữu mới có thể mời thành viên mới.
  • NONE_CAN_INVITE: Không ai có thể mời một ứng viên thành viên mới.
whoCanAdd string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Quyền thêm thành viên. Các giá trị có thể là:
  • ALL_MEMBERS_CAN_ADD: Người quản lý và thành viên có thể trực tiếp thêm thành viên mới.
  • ALL_MANAGERS_CAN_ADD: Chỉ người quản lý mới có thể thêm trực tiếp thành viên mới, kể cả chủ sở hữu của nhóm.
  • ALL_OWNERS_CAN_ADD: Chỉ chủ sở hữu mới có thể thêm trực tiếp thành viên mới.
  • NONE_CAN_ADD: Không ai có thể trực tiếp thêm thành viên mới.
allowExternalMembers string Xác định xem các thành viên bên ngoài tổ chức của bạn có thể tham gia nhóm hay không. Các giá trị có thể sử dụng là:
  • true: Người dùng Google Workspace bên ngoài tổ chức của bạn có thể trở thành thành viên của nhóm này.
  • false: Người dùng không thuộc tổ chức này không được phép trở thành thành viên của nhóm này.
whoCanPostMessage string Quyền đăng tin nhắn. Các giá trị có thể là:
  • NONE_CAN_POST: Nhóm này đã bị vô hiệu hoá và lưu trữ. Không ai có thể đăng tin nhắn lên nhóm này.
    • Khi archiveOnlyfalse, việc cập nhật whoCanPostMessage thành NONE_CAN_POST sẽ dẫn đến lỗi.
    • Nếu archiveOnly được chuyển từ true về false, thì whoCanPostMessages sẽ được đặt thành ALL_MANAGERS_CAN_POST.
  • ALL_MANAGERS_CAN_POST: Người quản lý (bao gồm cả chủ sở hữu nhóm) có thể đăng tin nhắn.
  • ALL_MEMBERS_CAN_POST: Mọi thành viên nhóm đều có thể đăng tin nhắn.
  • ALL_OWNERS_CAN_POST: Chỉ chủ sở hữu nhóm mới có thể đăng tin nhắn.
  • ALL_IN_DOMAIN_CAN_POST: Mọi người trong tài khoản đều có thể đăng tin nhắn.
  • ANYONE_CAN_POST: Bất kỳ người dùng Internet nào không thuộc tài khoản của bạn đều có thể truy cập vào dịch vụ Google Groups và đăng tin nhắn.
allowWebPosting string Cho phép đăng từ web. Các giá trị có thể là:
  • true: Cho phép mọi thành viên đăng bài lên diễn đàn của nhóm.
  • false: Thành viên chỉ sử dụng Gmail để liên lạc với nhóm.
primaryLanguage string Ngôn ngữ chính của nhóm. Sử dụng thẻ ngôn ngữ trong bảng Ngôn ngữ được hỗ trợ.
maxMessageBytes integer Không dùng nữa. Kích thước tối đa của một thư là 25 MB.
isArchived string Cho phép lưu trữ nội dung của Nhóm. Các giá trị có thể là:
  • true: Lưu trữ thư gửi đến nhóm.
  • false: Không lưu trữ tin nhắn đã gửi đến nhóm này. Nếu bạn false, các tin nhắn đã lưu trữ trước đó vẫn sẽ nằm trong kho lưu trữ.
archiveOnly string Chỉ cho phép lưu trữ nhóm. Các giá trị có thể là:
  • true: Nhóm đã được lưu trữ và không hoạt động. Tin nhắn mới gửi đến nhóm này sẽ bị từ chối. Bạn có thể duyệt xem và tìm kiếm các tin nhắn cũ đã lưu trữ.
    • Nếu true, thuộc tính whoCanPostMessage được đặt thành NONE_CAN_POST.
    • Nếu được chuyển từ true về false, whoCanPostMessages sẽ được đặt thành ALL_MANAGERS_CAN_POST.
  • false: Nhóm đang hoạt động và có thể nhận tin nhắn.
    • Khi false, việc cập nhật whoCanPostMessage thành NONE_CAN_POST sẽ dẫn đến lỗi.
messageModerationLevel string Mức độ kiểm duyệt của tin nhắn đến. Các giá trị có thể là:
  • MODERATE_ALL_MESSAGES: Tất cả thư đều được gửi đến địa chỉ email của chủ sở hữu nhóm để phê duyệt. Nếu được phê duyệt, thư sẽ được gửi đến nhóm.
  • MODERATE_NON_MEMBERS: Tất cả thư của những người không phải là thành viên nhóm sẽ được gửi đến địa chỉ email của chủ sở hữu nhóm để phê duyệt. Nếu được phê duyệt, thư sẽ được gửi đến nhóm.
  • MODERATE_NEW_MEMBERS: Tất cả thư của thành viên mới đều được gửi đến địa chỉ email của chủ sở hữu nhóm để phê duyệt. Nếu được phê duyệt, thư sẽ được gửi đến nhóm.
  • MODERATE_NONE: Không cần người kiểm duyệt phê duyệt. Tin nhắn sẽ được gửi trực tiếp đến nhóm.
spamModerationLevel string Chỉ định các mức kiểm duyệt cho những thư bị phát hiện là thư rác. Các giá trị có thể là:
  • ALLOW: Đăng tin nhắn lên nhóm.
  • MODERATE: Gửi tin nhắn đến hàng đợi kiểm duyệt. Đây là tuỳ chọn mặc định.
  • SILENTLY_MODERATE: Gửi bài đăng đến hàng đợi kiểm duyệt nhưng không gửi thông báo cho người kiểm duyệt.
  • REJECT: Từ chối ngay lập tức thư.
replyTo string Chỉ định người nhận thư trả lời mặc định. Các giá trị có thể là:
  • REPLY_TO_CUSTOM: Đối với câu trả lời cho tin nhắn, hãy sử dụng địa chỉ email tuỳ chỉnh của nhóm.

    Khi thuộc tính ReplyTo của nhóm được đặt thành REPLY_TO_CUSTOM, thuộc tính customReplyTo sẽ giữ địa chỉ email tuỳ chỉnh được dùng khi trả lời một thông báo. Nếu bạn đặt thuộc tính ReplyTo của nhóm thành REPLY_TO_CUSTOM, thì thuộc tính customReplyTo phải có một giá trị. Nếu không, lỗi sẽ được trả về.

  • REPLY_TO_SENDER: Câu trả lời được gửi cho tác giả của tin nhắn.
  • REPLY_TO_LIST: Tin nhắn trả lời này sẽ được gửi đến nhóm.
  • REPLY_TO_OWNER: Câu trả lời sẽ được gửi đến(các) chủ sở hữu của nhóm. Không bao gồm người quản lý của nhóm.
  • REPLY_TO_IGNORE: Từng người dùng trong nhóm quyết định địa chỉ nhận câu trả lời cho tin nhắn.
  • REPLY_TO_MANAGERS: Thông báo trả lời này được gửi đến người quản lý nhóm, bao gồm tất cả người quản lý và chủ sở hữu nhóm.
customReplyTo string Địa chỉ email dùng khi trả lời thư nếu bạn đặt thuộc tính replyTo thành REPLY_TO_CUSTOM. Địa chỉ này do một quản trị viên tài khoản xác định.
  • Khi thuộc tính ReplyTo của nhóm được đặt thành REPLY_TO_CUSTOM, thuộc tính customReplyTo sẽ giữ một địa chỉ email tuỳ chỉnh được dùng khi trả lời thư.
  • Nếu bạn đặt thuộc tính ReplyTo của nhóm thành REPLY_TO_CUSTOM, thì thuộc tính customReplyTo phải có giá trị văn bản, nếu không sẽ trả về lỗi.
includeCustomFooter string Có bao gồm chân trang tuỳ chỉnh hay không. Các giá trị có thể là:
  • true
  • false
customFooterText string Đặt nội dung cho văn bản chân trang tuỳ chỉnh. Số lượng ký tự tối đa là 1.000.
sendMessageDenyNotification string Cho phép thành viên nhận được thông báo nếu chủ sở hữu nhóm từ chối thư của thành viên gửi đến nhóm. Các giá trị có thể là:
  • true: Khi một bài viết bị từ chối, hãy gửi thông báo từ chối bài viết cho tác giả của bài viết đó.

    Thuộc tính defaultMessageDenyNotificationText phụ thuộc vào thuộc tính sendMessageDenyNotificationtrue.

  • false: Khi một tin nhắn bị từ chối, hệ thống sẽ không gửi thông báo.
defaultMessageDenyNotificationText string Khi một thông báo bị từ chối, đây là văn bản của thông báo từ chối được gửi cho tác giả của thông báo đó. Theo mặc định, thuộc tính này sẽ trống và không có giá trị trong phần nội dung phản hồi của API. Kích thước văn bản tối đa của thông báo là 10.000 ký tự.
showInGroupDirectory string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanDiscoverGroup. Cho phép nhóm xuất hiện trong Thư mục Groups. Các giá trị có thể là:
  • true: Tất cả các nhóm trong tài khoản đều được liệt kê trong Thư mục Groups.
  • false: Tất cả các nhóm trong tài khoản đều không có trong danh bạ.
allowGoogleCommunication string Không dùng nữa. Cho phép Google liên hệ với quản trị viên của nhóm.
  • true: Cho phép Google liên hệ với người quản lý của nhóm này. Đôi khi, Google có thể gửi thông tin cập nhật về các tính năng mới nhất, yêu cầu bạn đóng góp ý kiến về các tính năng mới hoặc yêu cầu bạn cho phép Google làm nổi bật nhóm của bạn.
  • false: Google không thể liên hệ với người quản lý của nhóm này.
membersCanPostAsTheGroup string Cho phép thành viên đăng tin nhắn với tư cách là nhóm. Các giá trị có thể là:
  • true: Thành viên nhóm có thể đăng bài viết bằng địa chỉ email của nhóm thay vì địa chỉ email của chính họ. Tin nhắn có vẻ như đến từ chính nhóm đó.
  • false: Thành viên không thể đăng bài thay mặt cho địa chỉ email của nhóm.
messageDisplayFont string Không dùng nữa. Phông chữ hiển thị thông báo mặc định luôn có giá trị là DEFAULT_FONT.
includeInGlobalAddressList string Cho phép nhóm xuất hiện trong Danh sách địa chỉ chung. Để biết thêm thông tin, hãy truy cập trung tâm trợ giúp. Các giá trị có thể là:
  • true: Nhóm có trong Danh sách địa chỉ chung.
  • false: Nhóm không có trong Danh sách địa chỉ chung.
whoCanLeaveGroup string Quyền rời khỏi nhóm. Các giá trị có thể là:
  • ALL_MANAGERS_CAN_LEAVE
  • ALL_MEMBERS_CAN_LEAVE
  • NONE_CAN_LEAVE
whoCanContactOwner string Quyền liên hệ với chủ sở hữu nhóm thông qua giao diện người dùng trên web. Các giá trị có thể là:
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
whoCanAddReferences string Không dùng nữa. Chức năng này không còn được hỗ trợ trong giao diện người dùng của Google Groups. Giá trị luôn là "NONE".
whoCanAssignTopics string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền chỉ định chủ đề trong diễn đàn cho người dùng khác. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanUnassignTopic string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền huỷ chỉ định mọi chủ đề trong diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanTakeTopics string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền chọn chủ đề trong diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkDuplicate string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền đánh dấu một chủ đề là trùng lặp với một chủ đề khác. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkNoResponseNeeded string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền đánh dấu một chủ đề là không cần phản hồi. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkFavoriteReplyOnAnyTopic string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền đánh dấu bài đăng của người dùng khác là câu trả lời yêu thích. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanMarkFavoriteReplyOnOwnTopic string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền đánh dấu một bài đăng là bài viết trả lời yêu thích cho chủ đề mà họ đã bắt đầu. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanUnmarkFavoriteReplyOnAnyTopic string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền bỏ đánh dấu mọi bài đăng khỏi bài viết trả lời yêu thích. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanEnterFreeFormTags string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền nhập thẻ dạng biểu mẫu tuỳ ý cho các chủ đề trong diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
whoCanModifyTagsAndCategories string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanAssistContent. Quyền thay đổi thẻ và danh mục. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
favoriteRepliesOnTop string Cho biết có nên hiển thị các câu trả lời yêu thích trước các câu trả lời khác hay không.
  • true: Các câu trả lời yêu thích sẽ xuất hiện trước các câu trả lời khác.
  • false: Các câu trả lời yêu thích không xuất hiện trước các câu trả lời khác.
whoCanApproveMembers string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Chỉ định những người có thể phê duyệt thành viên yêu cầu tham gia nhóm. Các giá trị có thể sử dụng là:
  • ALL_MEMBERS_CAN_APPROVE
  • ALL_MANAGERS_CAN_APPROVE
  • ALL_OWNERS_CAN_APPROVE
  • NONE_CAN_APPROVE
whoCanBanUsers string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Chỉ định người có thể từ chối cấp quyền thành viên cho người dùng. Các giá trị có thể sử dụng là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModifyMembers string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateMembers. Chỉ định người có thể thay đổi vai trò của các thành viên trong nhóm. Các giá trị có thể sử dụng là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanApproveMessages string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể phê duyệt các tin nhắn đang chờ xử lý trong hàng đợi kiểm duyệt. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanDeleteAnyPost string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể xoá câu trả lời cho chủ đề. (Tác giả luôn có thể xoá bài đăng của chính mình). Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanDeleteTopics string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể xoá chủ đề. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanLockTopics string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể ngăn người dùng đăng câu trả lời cho các chủ đề. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMoveTopicsIn string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể di chuyển chủ đề vào nhóm hoặc diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMoveTopicsOut string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể di chuyển chủ đề ra khỏi nhóm hoặc diễn đàn. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanPostAnnouncements string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định người có thể đăng thông báo, một loại chủ đề đặc biệt. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanHideAbuse string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể ẩn bài đăng bằng cách báo cáo bài đăng đó là nội dung vi phạm. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanMakeTopicsSticky string Không dùng nữa. Chế độ này được hợp nhất vào chế độ cài đặt whoCanModerateContent. Chỉ định những người có thể hiển thị các chủ đề ở đầu danh sách chủ đề. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModerateMembers string Chỉ định người có thể quản lý thành viên. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanModerateContent string Chỉ định những người có thể kiểm duyệt nội dung. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • OWNERS_ONLY
  • NONE
whoCanAssistContent string Chỉ định người có thể kiểm duyệt siêu dữ liệu. Các giá trị có thể là:
  • ALL_MEMBERS
  • OWNERS_AND_MANAGERS
  • MANAGERS_ONLY
  • OWNERS_ONLY
  • NONE
customRolesEnabledForSettingsToBeMerged string Chỉ định xem nhóm có vai trò tùy chỉnh được đưa vào một trong các chế độ cài đặt đang được hợp nhất hay không. Trường này ở chế độ chỉ đọc và các yêu cầu UPDATEPATCH đối với trường này sẽ bị bỏ qua. Các giá trị có thể là:
  • true
  • false
enableCollaborativeInbox string Chỉ định xem hộp thư đến cộng tác có tiếp tục bật cho nhóm hay không. Các giá trị có thể là:
  • true
  • false
whoCanDiscoverGroup string Chỉ định nhóm người dùng mà nhóm này có thể được phát hiện. Các giá trị có thể là:
  • ANYONE_CAN_DISCOVER
  • ALL_IN_DOMAIN_CAN_DISCOVER
  • ALL_MEMBERS_CAN_DISCOVER
defaultSender string Người gửi mặc định cho những thành viên có thể đăng bài viết dưới tên nhóm. Các giá trị có thể là:
  • DEFAULT_SELF
  • GROUP

Phương thức

Các phương thức groupsSettings.groups.getgroupsSettings.groups.update hoạt động trên một Tài nguyên nhóm cụ thể.

get
Truy xuất chế độ cài đặt của một nhóm được xác định bằng địa chỉ email của nhóm.
update
Cập nhật chế độ cài đặt của một nhóm hiện có (được xác định bằng địa chỉ email của nhóm).
patch
Cập nhật một tài nguyên hiện có. Phương thức này hỗ trợ ngữ nghĩa của bản vá.

Ngôn ngữ được hỗ trợ

Các mã ngôn ngữ sau đây được hỗ trợ cho trường primaryLanguage của một nhóm.

aa
ab
af
am
ar
as
ay
az
ba
be
bg
bh
bi
bn
bo
br
bs
ca
co
cs
cy
da
de
dz
el
en
en-GB
en-US-pseudo
en_US
eo
es
et
eu
fa
fi
fj
fo
fr
fr-CA
fy
ga
gd
gl
gn
gu
ha
hi
hr
hu
hy
ia
id
ie
ik
is
it
iu
iw
ja
jw
ka
kk
kl
km
kn
ko
ks
ku
ky
la
ln
lo
lt
lv
mg
mi
mk
ml
mn
mo
mr
ms
mt
my
na
ne
nl
nn
no
oc
om
or
pa
pl
ps
pt-BR
pt-PT
qu
rm
rn
ro
ru
rw
sa
sd
sg
sh
si
sk
sl
sm
sn
so
sq
sr
ss
st
su
sv
sw
ta
te
tg
th
ti
tk
tl
tn
to
tr
ts
tt
tw
ug
uk
ur
uz
vi
vo
wo
xh
xx-bork
xx-elmer
xx-hacker
xx-klingon
xx-piglatin
yi
yo
za
zh-CN
zh-TW
zu