REST Resource: users.sections

리소스: 섹션

Google Chat의 섹션을 나타냅니다. 섹션을 사용하면 사용자가 스페이스를 정리할 수 있습니다. 섹션에는 두 가지 유형이 있습니다.

  1. 시스템 섹션: Google Chat에서 관리하는 사전 정의된 섹션입니다. 리소스 이름이 고정되어 있으며 생성, 삭제 또는 displayName 수정이 불가능합니다. 예를 들면 다음과 같습니다.

    • users/{user}/sections/default-direct-messages
    • users/{user}/sections/default-spaces
    • users/{user}/sections/default-apps

  2. 맞춤 섹션: 사용자가 만들고 관리하는 섹션입니다. sections.create를 사용하여 맞춤 섹션을 만들려면 displayName가 필요합니다. sections.patch를 사용하여 맞춤 섹션을 업데이트하고 sections.delete를 사용하여 삭제할 수 있습니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "sortOrder": integer,
  "type": enum (SectionType)
}
필드
name

string

식별자. 섹션의 리소스 이름입니다.

시스템 섹션의 경우 섹션 ID는 상수 문자열입니다.

  • DEFAULT_DIRECT_MESSAGES: users/{user}/sections/default-direct-messages
  • DEFAULT_SPACES: users/{user}/sections/default-spaces
  • DEFAULT_APPS: users/{user}/sections/default-apps

형식: users/{user}/sections/{section}
displayName

string

필수 항목입니다. 섹션의 표시 이름입니다. CUSTOM_SECTION 유형의 섹션에만 채워집니다. 최대 80자(영문 기준)까지 지원됩니다. CUSTOM_SECTION를 만들 때 필요합니다.
sortOrder

integer

출력 전용입니다. 다른 섹션과 관련된 섹션의 순서입니다. sortOrder 값이 낮은 섹션이 값이 높은 섹션보다 먼저 표시됩니다.
type

enum (SectionType)

필수 항목입니다. 섹션의 유형입니다.

SectionType

섹션 유형입니다.

열거형
SECTION_TYPE_UNSPECIFIED 지정되지 않은 섹션 유형입니다.
CUSTOM_SECTION 맞춤 섹션입니다.
DEFAULT_DIRECT_MESSAGES 두 명의 실제 사용자 간의 DIRECT_MESSAGE 또는 맞춤 섹션에 속하지 않는 GROUP_CHAT 스페이스가 포함된 기본 섹션
DEFAULT_SPACES 맞춤 섹션에 속하지 않는 기본 스페이스입니다.
DEFAULT_APPS 사용자가 설치한 앱이 포함된 기본 섹션입니다.

메서드

create

 Google Chat에서 섹션을 만듭니다.

delete

 CUSTOM_SECTION 유형의 섹션을 삭제합니다.

list

 Chat 사용자에게 제공되는 섹션을 나열합니다.

patch

 섹션을 업데이트합니다.

position

 섹션의 정렬 순서를 변경합니다.