메시지에 반응 추가

이 가이드에서는 Google Chat API의 Reaction 리소스에서 create 메서드를 사용하여 👍, 😲, REFUND와 같은 메시지에 반응을 추가하는 방법을 설명합니다.

Reaction 리소스는 사람들이 메시지에 반응하는 데 사용할 수 있는 그림 이모티콘(예: 👍, 😲, 윈)을 나타냅니다.

기본 요건

Python

  • Python 3.6 이상
  • pip 패키지 관리 도구

  • 최신 Python용 Google 클라이언트 라이브러리입니다. 이를 설치하거나 업데이트하려면 명령줄 인터페이스에서 다음 명령어를 실행합니다.

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Google Chat API가 사용 설정 및 구성된 Google Cloud 프로젝트 단계는 Google Chat 앱 빌드를 참고하세요.

  • 채팅 앱에 구성된 승인입니다. 반응을 만들려면 chat.messages.reactions.create, chat.messages.reactions 또는 chat.messages 승인 범위를 사용하는 사용자 인증이 필요합니다.

메시지에 반응 추가하기

메시지에 대한 반응을 만들려면 요청에 다음을 전달합니다.

  • chat.messages.reactions.create, chat.messages.reactions 또는 chat.messages 승인 범위를 지정합니다.
  • Reaction 리소스에서 create 메서드를 호출합니다.
  • parent를 반응할 메시지의 리소스 이름으로 설정합니다.
  • body (요청 본문)을 Reaction의 인스턴스로 설정합니다. 여기서 unicode 필드는 유니코드 문자열로 표시되는 표준 그림 이모티콘입니다.

다음은 {8/} 이모티콘이 있는 메시지에 반응하는 예시입니다.

Python

  1. 작업 디렉터리에서 chat_reaction_create.py라는 파일을 만듭니다.

  2. chat_reaction_create.py에 다음 코드를 포함합니다.

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.messages.reactions.create"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then creates a reaction to a message.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                      'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.spaces().messages().reactions().create(

        # The message to create a reaction to.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MESSAGE with a message name.
        # Obtain the message name from the response body returned
        # after creating a message asynchronously with Chat REST API.
        parent = 'spaces/SPACE/messages/MESSAGE',

        # The reaction to the message.
        body = {

            'emoji': {

                # A standard emoji represented by a unicode string.
                'unicode': '😀'
            }

        }

    ).execute()

    # Prints details about the created reaction.
    print(result)

if __name__ == '__main__':
    main()

  3. 코드에서 다음을 바꿉니다.

    • SPACE: 메시지가 게시된 스페이스의 name로, Chat API의 spaces.list 메서드 또는 스페이스의 URL에서 가져올 수 있습니다.

    • MESSAGE: 메시지 이름으로, Chat API를 사용하여 메시지를 비동기식으로 만들거나 생성 시 메시지에 할당된 커스텀 이름을 사용하여 메시지를 만든 후 반환된 응답 본문에서 가져올 수 있습니다.

  4. 작업 디렉터리에서 샘플을 빌드하고 실행합니다.

    python3 chat_reaction_create.py

Chat API는 생성된 반응을 자세히 설명하는 Reaction 인스턴스를 반환합니다.