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