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

이 페이지에서는 Google Chat 앱이 식별하거나 지정할 수 있는 방법을 설명합니다. 사용자와 채팅합니다.

채팅 앱에서 다음 작업을 할 수 있습니다. 사용자를 지정해야 합니다.

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 리소스: 있습니다.