User

Google Chat의 사용자입니다.

요청의 출력으로 반환될 때 Chat 앱이 사용자로 인증되면 스페이스의 구성원이거나 호출 사용자와 이전 친밀도가 있는 경우가 아니면 User 리소스 (예: Messages 및 Memberships API)의 출력은 내부 및 외부 사용자의 name 및 type 필드만 채웁니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "avatarUrl": string,
  "email": string,
  "domainId": string,
  "type": enum (Type),
  "isAnonymous": boolean
}
필드
name

string

Google Chat user의 리소스 이름입니다.

형식은 users/{user}입니다. users/app는 호출 앱 bot 사용자의 별칭으로 사용할 수 있습니다.

human users의 경우 {user}은 다음과 같은 사용자 식별자와 동일합니다.

  • People API의 Person에 대한 id 예를 들어 Chat API의 users/123456789는 People API의 123456789 사람 프로필 ID와 동일한 사람을 나타냅니다.

  • Admin SDK Directory API의 user에 대한 id

  • 사용자의 이메일 주소를 API 요청에서 {user}의 별칭으로 사용할 수 있습니다. 예를 들어 user@example.com의 People API Person 프로필 ID가 123456789인 경우 users/user@example.com을 별칭으로 사용하여 users/123456789을 참조할 수 있습니다. 표준 리소스 이름 (예: users/123456789)만 API에서 반환됩니다.

displayName

string

출력 전용입니다. 사용자의 표시 이름입니다.

앱 인증과 사용자 인증 모두에 대해 채워집니다. 이 필드는 앱 인증으로 이루어진 요청에 항상 채워집니다. 사용자 인증으로 Messages 및 Memberships API를 호출할 때 사용자가 스페이스의 구성원이거나 호출하는 사용자와 이전에 친밀한 관계가 있는 경우 메시지의 sender, annotations 내의 사용자 (예: 사용자 멘션), Membership 리소스에 대해 내부 및 외부 사용자 모두에 이 필드가 채워집니다.

avatarUrl

string

출력 전용입니다. 사용자의 아바타 이미지 URL입니다.

사용자 인증으로 Messages 및 Memberships API를 호출할 때 사용자가 스페이스의 구성원이거나 호출하는 사용자와 이전에 친밀한 관계가 있는 경우 메시지의 sender, annotations 내의 사용자 (예: 사용자 멘션), Membership 리소스에 대해 내부 및 외부 사용자 모두에 이 필드가 채워집니다.

email

string

출력 전용입니다. 사용자의 이메일 주소

사용자 인증으로 Messages 및 Memberships API를 호출할 때 사용자가 스페이스의 구성원이거나 호출하는 사용자와 이전에 친밀한 관계가 있는 경우 메시지의 sender, annotations 내의 사용자 (예: 사용자 멘션), Membership 리소스에 대해 내부 및 외부 사용자 모두에 이 필드가 채워집니다.

domainId

string

사용자의 Google Workspace 도메인의 고유 식별자입니다.

type

enum (Type)

사용자 유형입니다.

isAnonymous

boolean

출력 전용입니다. true인 경우 사용자가 삭제되거나 프로필이 표시되지 않습니다(예: 사용자가 회원도 아니고 호출 사용자에게 사전 선호도도 없는 스페이스에서 언급된 경우).

유형

열거형
TYPE_UNSPECIFIED 열거형의 기본값입니다. 사용하지 않습니다.
HUMAN 인간 사용자입니다.
BOT Chat 앱 사용자입니다.