이 페이지에서는 Google Chat 앱이 식별하거나 지정할 수 있는 방법을 설명합니다. 사용자와 채팅합니다.
채팅 앱에서 다음 작업을 할 수 있습니다. 사용자를 지정해야 합니다.
- 메시지를 작성하여 @ 은 사용자를 멘션합니다.
- 사용자를 초대하거나 기존 공간, 사용자를 추가하여 새로운 공간입니다.
- 채팅 메시지 찾기 채팅 앱과 지정된 사용자 간 할 수 있습니다.
- 스페이스에서 사용자의 멤버십 세부정보 가져오기
- 사용자에게 비공개 메시지를 보냅니다.
- 사용자 구독: Google Workspace Events API를 사용하여 멤버십 변경사항에 대한 일정을 가져올 수 있습니다.
Chat에서 사용자를 식별하는 방법
Google Chat API는
User
리소스
할 수 있습니다. 다음 두 가지는
User
필드:
name
은users/{user}
형식의 리소스 이름입니다. 여기서{user}
는 안정적인 고유 식별자를 나타냅니다.users/app
에서 할 수 있는 작업 다음과 같이 사용할 수 있습니다. 호출하는 채팅 앱의 별칭입니다.type
은 사용자 유형입니다. 이 유형은 Chat이 채팅 앱 또는 사람입니다. 대상 채팅 앱의 경우 값은BOT
입니다. 사람들이 찾는 가치는HUMAN
Google Chat API 호출 시 사용자 지정
사용자를 지정하려면 {user}
값에 다음 값을 사용합니다.
Google Workspace 조직의 사용자의 경우 다음 중 하나를 사용하세요. 접근 방식:
name
User
리소스 Chat API에서(예:users/123456789
){person_id}
: People API의Person
리소스 여기서resourceName
는people/{person_id}
입니다. 예를 들면 다음과 같습니다. Chat API의users/123456789
가 동일한 사람을 나타냅니다. People API에서people/123456789
로 설정합니다.- Directory API의
User
리소스에 대한id
입니다. 예: Chat API의users/123456789
가 동일한 사람을 나타냅니다. Directory API에서users/123456789
로 설정합니다.
외부 Google Workspace 조직의 사용자 또는 사용자의 경우 이메일 별칭(예:
users/EMAIL_USERNAME@WORKSPACE_DOMAIN.com
또는users/EMAIL_USERNAME@gmail.com
.
상호작용 이벤트에서 사용자 식별
사용자가 채팅 앱과 상호작용할 때마다 Chat은 상호작용 이벤트를 상호작용으로 이루어집니다. 예를 들어 사용자가 메시지에서 채팅 앱을 멘션하면 채팅 앱이 상호작용에 관한 정보를 수신합니다. 여기에는 메시지 내용, 보낸 사람 등이 포함됩니다. 채팅 앱 사용자를 참조할 수 있습니다.
채팅 앱과 상호작용한 사용자를 식별하려면 다음 단계를 따르세요.
name
속성 값을 가져옵니다.
User
리소스,
GCP 콘솔에서
Event.user.name
입니다.
다음 JSON 예는 채팅 앱과의 상호작용:
{
...,
"user": {
"name": "users/12345678901234567890",
"displayName": "Sasha",
"avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
"email": "sasha@example.com"
}
}
메시지는 특정 유형의 상호작용입니다. 사용자 식별을 위해
채팅 앱에 메시지를 보낼 때
name
속성 값을 가져옵니다.
User
리소스:
있습니다.