Groups

그룹스 리소스는 Groups Settings API의 루트 데이터 클래스입니다. 각 그룹스 리소스는 설정 모음과 연결됩니다.

자세한 내용은 이 리소스의 메서드 목록을 참조하세요.

리소스 표현

그룹스 리소스에는 지정된 그룹 설정의 요약이 있는 메타데이터가 포함됩니다. 이 설정은 그룹의 액세스, 알림, 토론 보관처리, 메시지 검토를 관리하고 계정의 사용자 그룹을 맞춤설정합니다.

기본적으로 그룹스 리소스 데이터는 atom+XML 데이터 형식으로 반환됩니다.

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>

다음 표에서는 그룹 리소스를 보여줍니다.

속성 이름 값 설명
entry object 그룹 리소스
entry/xmlns string Atom 형식의 스키마
entry/xmlns:apps string Google Workspace I/O 형식 스키마
entry/xmlns:gd string Google 데이터 프로토콜 스키마
entry/id object 그룹 리소스의 고유 식별자입니다.
entry/title object API의 Atom 항목 제목(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

그룹의 이메일 주소입니다. 이 속성은 Directory API를 사용하여 업데이트할 수 있습니다.
entry/apps:name object 그룹 이름입니다. 그룹 이름은 최대 75자(영문 기준)까지 입력할 수 있습니다.
entry/apps:description object 그룹에 대한 설명입니다. 그룹 설명을 입력하지 않은 경우 이 속성 값은 빈 문자열이 될 수 있습니다. 입력하는 경우 그룹 설명의 최대 길이는 300자(영문 기준)입니다.
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: 그룹이 사용 중지되었으며 보관처리되었습니다. 아무도 이 그룹에 메시지를 게시할 수 없습니다.
    • 보관처리만 false할 때 whoCanPostMessage를 NONE_CAN_POST로 업데이트하면 오류가 발생합니다.
    • 보관처리만 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 그룹스 서비스에 액세스하고 메시지를 게시할 수 있습니다.
entry/apps:allowWebPosting object 웹에서 게시할 수 있습니다. 가능한 값은 다음과 같습니다.
  • true: 모든 회원이 그룹 포럼에 게시할 수 있습니다.
  • false: 회원은 그룹과 커뮤니케이션할 때 Gmail만 사용합니다.
entry/apps:primaryLanguage object 그룹의 기본 언어입니다. 지원되는 언어 표의 언어 태그를 사용합니다.
entry/apps:maxMessageBytes object 지원 중단됨. 메시지의 최대 크기는 25MB입니다.
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 맞춤 바닥글 텍스트의 콘텐츠를 설정합니다. 최대 1,000자(영문 기준)까지 입력할 수 있습니다.
entry/apps:sendMessageDenyNotification object 그룹 소유자가 그룹에 대한 회원 메시지를 거부한 경우 회원이 알림을 받도록 허용합니다. 가능한 값은 다음과 같습니다.
  • true: 메시지가 거부되면 메시지 작성자에게 거부 메시지 알림을 보냅니다.

    defaultMessageDenyNotificationText 속성은 true인 sendMessageDenyNotification 속성에 종속됩니다.

  • false: 메시지가 거부되면 알림이 전송되지 않습니다.
entry/apps:defaultMessageDenyNotificationText object 메일이 거부되면 메일 작성자에게 전송된 거부 알림의 텍스트입니다. 기본적으로 이 속성은 비어 있으며 API의 응답 본문에 값이 없습니다. 최대 알림 텍스트 크기는 10,000자(영문 기준)입니다.
entry/apps:showInGroupDirectory object 지원 중단됨. 이는 whoCanDiscoverGroup 설정으로 병합됩니다. 그룹 디렉터리에 그룹이 표시되도록 허용합니다. 가능한 값은 다음과 같습니다.
  • true: 계정의 모든 그룹이 그룹스 디렉터리에 나열됩니다.
  • false: 계정의 모든 그룹이 디렉터리에 나열되지 않습니다.
entry/apps:allowGoogleCommunication object 지원 중단됨. Google에서 그룹 관리자에게 문의할 수 있도록 허용합니다.
  • true: Google에서 이 그룹의 관리자에게 연락하도록 허용합니다. Google에서는 가끔 최신 기능에 관한 소식을 보내거나, 새로운 기능에 관한 의견을 요청하거나, 사용자 그룹을 강조하기 위한 권한을 요청할 수 있습니다.
  • false: Google에서 이 그룹의 관리자에게 연락할 수 없습니다.
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 지원 중단됨. 이 기능은 Google 그룹스 UI에서 더 이상 지원되지 않습니다. 값은 항상 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 설정으로 병합됩니다. 지원 중단되었습니다. 이는 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

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
}

다음 표에서는 그룹 리소스를 보여줍니다.

속성 이름 값 설명
kind string 리소스 유형입니다. 항상 groupsSettings#groups입니다.
email string 그룹의 이메일 주소입니다. 이 속성은 Directory API를 사용하여 업데이트할 수 있습니다.
name string 그룹 이름(영문 기준 최대 75자)
description string 그룹에 대한 설명입니다. 그룹 설명을 입력하지 않은 경우 이 속성 값은 빈 문자열이 될 수 있습니다. 입력하는 경우 그룹 설명의 최대 길이는 300자(영문 기준)입니다.
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 그룹스 서비스에 액세스하고 메시지를 게시할 수 있습니다.
allowWebPosting string 웹에서 게시할 수 있습니다. 가능한 값은 다음과 같습니다.
  • true: 모든 회원이 그룹 포럼에 게시할 수 있습니다.
  • false: 회원은 그룹과 커뮤니케이션할 때 Gmail만 사용합니다.
primaryLanguage string 그룹의 기본 언어입니다. 지원되는 언어 표의 언어 태그를 사용합니다.
maxMessageBytes integer 지원 중단됨. 메시지의 최대 크기는 25MB입니다.
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 맞춤 바닥글 텍스트의 콘텐츠를 설정합니다. 최대 1,000자(영문 기준)까지 입력할 수 있습니다.
sendMessageDenyNotification string 그룹 소유자가 그룹에 대한 회원 메시지를 거부한 경우 회원이 알림을 받도록 허용합니다. 가능한 값은 다음과 같습니다.
  • true: 메시지가 거부되면 메시지 작성자에게 거부 메시지 알림을 보냅니다.

    defaultMessageDenyNotificationText 속성은 true인 sendMessageDenyNotification 속성에 종속됩니다.

  • false: 메시지가 거부되면 알림이 전송되지 않습니다.
defaultMessageDenyNotificationText string 메일이 거부되면 메일 작성자에게 전송된 거부 알림의 텍스트입니다. 기본적으로 이 속성은 비어 있으며 API의 응답 본문에 값이 없습니다. 최대 알림 텍스트 크기는 10,000자(영문 기준)입니다.
showInGroupDirectory string 지원 중단됨. 이는 whoCanDiscoverGroup 설정으로 병합됩니다. 그룹 디렉터리에 그룹이 표시되도록 허용합니다. 가능한 값은 다음과 같습니다.
  • true: 계정의 모든 그룹이 그룹스 디렉터리에 나열됩니다.
  • false: 계정의 모든 그룹이 디렉터리에 나열되지 않습니다.
allowGoogleCommunication string 지원 중단됨. Google에서 그룹 관리자에게 문의할 수 있도록 허용합니다.
  • true: Google에서 이 그룹의 관리자에게 연락하도록 허용합니다. Google에서는 가끔 최신 기능에 관한 소식을 보내거나, 새로운 기능에 관한 의견을 요청하거나, 사용자 그룹을 강조하기 위한 권한을 요청할 수 있습니다.
  • false: Google에서 이 그룹의 관리자에게 연락할 수 없습니다.
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 웹 UI를 통해 그룹 소유자에게 연락할 수 있는 권한입니다. 가능한 값은 다음과 같습니다.
  • ALL_IN_DOMAIN_CAN_CONTACT
  • ALL_MANAGERS_CAN_CONTACT
  • ALL_MEMBERS_CAN_CONTACT
  • ANYONE_CAN_CONTACT
whoCanAddReferences string 지원 중단되었습니다. 이 기능은 Google 그룹스 UI에서 더 이상 지원되지 않습니다. 값은 항상 'NONE'입니다.
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 메서드는 지정된 그룹스 리소스에서 작동합니다.

get
그룹 이메일 주소로 식별된 그룹의 설정을 검색합니다.
업데이트
그룹 이메일 주소로 식별되는 기존 그룹의 설정을 업데이트합니다.
patch
기존 리소스를 업데이트합니다. 이 메서드는 패치 시맨틱스를 지원합니다.

지원되는 언어

그룹의 primaryLanguage 필드에는 다음 언어 코드가 지원됩니다.

aa
ab
af
am
ar
as
ay
az
ba
bg
bh
bi
bn
bo
br
bs
ca
co
cs
cy
da
de
el dz














 fr-CA
fy
ga
gd
gl
gn
gu
ha
hi
hr
hu
hy
ia
id
ie
ik
is
it
iu
iw
jaks jw
k kk















 mk
ml
mn
mo
mr
ms
mt
my
na
ne
nl
nn
no
oc
om
또는
pa
pl
ps
pt-BR
pt-PT
ps
pt-BR
pt-PT
qu s
rm











 sr
ss
st
su
sv
zhon zuk xx
-