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

이 페이지에서는 Google Chat 앱이 Chat 사용자를 식별하거나 지정하는 방법을 설명합니다.

다음 작업을 실행하려면 Chat 앱에서 사용자를 지정해야 합니다.

Chat에서 사용자를 식별하는 방법

Google Chat API는 Chat을 사용하는 각 사용자에 대해 User 리소스를 생성합니다. 다음은 두 가지 중요한 User 필드입니다.

  • name은 users/{user} 형식의 리소스 이름으로, 여기서 {user}은 고유하고 안정적인 식별자를 나타냅니다. users/app는 호출하는 Chat 앱의 별칭으로 사용할 수 있습니다.
  • type은 사용자 유형입니다. 이 유형은 사용자가 Chat 앱인지 사람인지 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은 상호작용 및 사용자에 관한 정보가 포함된 상호작용 이벤트를 전송합니다. 예를 들어 사용자가 메시지에서 Chat 앱을 언급하면 Chat 앱은 메시지 내용, 발신자 등 상호작용에 관한 정보를 수신합니다. Chat 앱은 Chat 리소스에 관한 정보를 검색할 때 사용자를 참조합니다.

Chat 앱과 상호작용한 사용자를 식별하려면 Event.user.name에서 가져올 수 있는 User 리소스의 name 속성 값을 가져옵니다.

다음 JSON 예는 Chat 앱과의 상호작용에서 예상되는 사용자 ID 형식을 보여줍니다.

{
  ...,
  "user": {
    "name": "users/12345678901234567890",
    "displayName": "Sasha",
    "avatarUrl": "https://lh3.googleusercontent.com/.../photo.jpg",
    "email": "sasha@example.com"
  }
}

메시지는 특정 유형의 상호작용입니다. Chat 앱에 메시지를 보낸 사용자를 식별하려면 다음 중 하나를 사용하여 User 리소스의 name 속성 값을 가져옵니다.