Google Chat 사용자 식별 및 지정하기

이 페이지에서는 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와 동일한 사람을 나타냅니다.

  • 외부 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 속성 값을 가져옵니다.