스페이스에 사용자, Google 그룹 또는 Google Chat 앱을 초대하거나 추가하기

이 가이드에서는 membership 리소스에서 create 메서드를 사용하는 방법을 설명합니다. Google Chat API를 사용하여 사용자, Google 그룹 또는 Chat 앱에서 스페이스 만들기라고도 하는 스페이스에 멤버십입니다. 멤버십을 만들 때 지정된 회원에게 자동 수락 정책이 사용 중지된 경우 초대되고 스페이스를 수락해야 합니다. 초대를 수락해야 합니다. 그렇지 않은 경우 멤버십을 만들면 회원이 추가됩니다. 전달할 수 있습니다

Membership 리소스 사람 또는 Google Chat 앱이 초대되었는지 여부를 나타냅니다. 공백의 일부이거나 비어 있는 경우일 수 있습니다.

기본 요건

Python

Node.js

스페이스에 사용자 초대 또는 추가하기

스페이스에 사용자를 초대하거나 추가하려면 다음을 요청:

  • chat.memberships 승인 범위를 지정합니다.
  • 먼저 create 메서드membership 리소스.
  • parent을 멤버십을 만들 스페이스의 리소스 이름으로 설정합니다.
  • memberusers/{user}로 설정합니다. 여기서 {user}는 원하는 사람입니다. 다음 중 하나에 대한 멤버십을 만듭니다. <ph type="x-smartling-placeholder">
      </ph>
    • 사람 할 수 있습니다. 예를 들어 People API가 사람 resourceNamepeople/123456789이며 membership.member.name로 설정됨 users/123456789에게 전송합니다.
    • 사용자 사용할 수 있습니다.
    • 사용자의 이메일 주소 예를 들면 users/222larabrown@gmail.com 또는 users/larabrown@cymbalgroup.com입니다. 사용자가 Google 계정을 사용하거나 다른 Google Workspace 조직에 속해 있는 경우 이메일 주소를 입력하세요.

다음 예에서는 스페이스에 사용자를 추가합니다.

Python

  1. 작업 디렉터리에서 chat_membership_user_create.py
  2. chat_membership_user_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.memberships"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then adds a user to a Chat space by creating a membership.
        '''
    
        # 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().members().create(
    
            # The space in which to create a membership.
            parent = 'spaces/SPACE',
    
            # Specify which user the membership is for.
            body = {
              'member': {
                'name':'users/USER',
                'type': 'HUMAN'
              }
            }
    
        ).execute()
    
        # Prints details about the created membership.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. 코드에서 다음을 바꿉니다.

    • SPACE: 스페이스 이름입니다. GCP 콘솔에서 spaces.list 메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.

    • USER: 사용자 ID입니다.

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

    python3 chat_membership_user_create.py

Node.js

  1. 작업 디렉터리에 add-user-to-space.js라는 파일을 만듭니다.
  2. add-user-to-space.js에 다음 코드를 포함합니다.

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * Adds the user to the Chat space.
    * @return {!Promise<!Object>}
    */
    async function addUserToSpace() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.memberships',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.members.create({
        parent: 'spaces/SPACE',
        requestBody: {member: {name: 'users/USER', type: 'HUMAN'}}
      });
    }
    
    addUserToSpace().then(console.log);
    
  3. 코드에서 다음을 바꿉니다.

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

    • USER: 사용자 ID입니다.

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

    node add-user-to-space.js

Chat API는 membership 드림 생성된 사용자 멤버십을 자세히 설명합니다.

스페이스에 Google 그룹 초대 또는 추가

스페이스에 Google 그룹을 초대하거나 추가하려면 요청:

  • chat.memberships 승인 범위를 지정합니다.
  • 먼저 create 메서드membership 리소스.
  • parent을 멤버십을 만들 스페이스의 리소스 이름으로 설정합니다.
  • groupMembergroups/{group}로 설정합니다. 여기서 {group}는 연결할 그룹 ID입니다. 선택할 수 있습니다. 그룹의 ID는 Cloud ID API 예를 들어 Cloud ID API가 이름이 groups/123456789인 그룹을 반환한 후 membership.groupMember.name에서 groups/123456789(으)로

Google 그룹스는 그룹 채팅이나 채팅 메시지에 추가할 수 없으며 명명된 공간에 적용됩니다. 다음 예에서는 이름이 지정된 스페이스에 그룹을 추가합니다.

Python

  1. 작업 디렉터리에서 chat_membership_group_create.py
  2. chat_membership_group_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.memberships"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then adds a group to a Chat space by creating a membership.
        '''
    
        # 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().members().create(
    
            # The named space in which to create a membership.
            parent = 'spaces/SPACE',
    
            # Specify which group the membership is for.
            body = {
              'groupMember': {
                'name':'groups/GROUP',
              }
            }
    
        ).execute()
    
        # Prints details about the created membership.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. 코드에서 다음을 바꿉니다.

    • SPACE: 스페이스 이름입니다. GCP 콘솔에서 spaces.list 메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.

    • GROUP: 그룹 ID입니다.

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

    python3 chat_membership_group_create.py

Node.js

  1. 작업 디렉터리에 add-group-to-space.js라는 파일을 만듭니다.
  2. add-group-to-space.js에 다음 코드를 포함합니다.

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * Adds the group to the Chat space.
    * @return {!Promise<!Object>}
    */
    async function addUserToSpace() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.memberships',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.members.create({
        parent: 'spaces/SPACE',
        requestBody: {groupMember: {name: 'groups/GROUP'}}
      });
    }
    
    addUserToSpace().then(console.log);
    
  3. 코드에서 다음을 바꿉니다.

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

    • GROUP: 그룹 ID입니다.

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

    node add-group-to-space.js

Chat API는 membership 드림 생성된 그룹 멤버십을 자세히 설명합니다.

스페이스에 채팅 앱 추가하기

채팅 앱은 다른 앱을 구성원으로 추가할 수 없습니다. 있습니다. 스페이스에 채팅 앱 추가하기 두 사용자 간의 채팅 메시지인 경우 요청에 다음을 전달합니다.

  • chat.memberships.app 승인 범위를 지정합니다.
  • 먼저 create 메서드 (membership 리소스에 있음)
  • parent을 멤버십을 만들 스페이스의 리소스 이름으로 설정합니다.
  • memberusers/app로 설정합니다. 를 호출하는 앱을 나타내는 별칭입니다. Chat API

다음 예에서는 스페이스에 채팅 앱을 추가합니다.

Python

  1. 작업 디렉터리에서 chat_membership_app_create.py
  2. chat_membership_app_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.memberships.app"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then adds the Chat app to a Chat space.
        '''
    
        # 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().members().create(
    
            # The space in which to create a membership.
            parent = 'spaces/SPACE',
    
            # Set the Chat app as the entity that gets added to the space.
            # 'app' is an alias for the Chat app calling the API.
            body = {
                'member': {
                  'name':'users/app',
                  'type': 'BOT'
                }
            }
    
        ).execute()
    
        # Prints details about the created membership.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. 코드에서 SPACE을 스페이스 이름으로 바꿉니다. GCP 콘솔에서 spaces.list 메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.

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

    python3 chat_membership_app_create.py

Node.js

  1. 작업 디렉터리에 add-app-to-space.js라는 파일을 만듭니다.
  2. add-app-to-space.js에 다음 코드를 포함합니다.

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * Adds the app to the Chat space.
    * @return {!Promise<!Object>}
    */
    async function addAppToSpace() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.memberships.app',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.members.create({
        parent: 'spaces/SPACE',
        requestBody: {member: {name: 'users/app', type: 'BOT'}}
      });
    }
    
    addAppToSpace().then(console.log);
    
  3. 코드에서 SPACE을 스페이스 이름으로 바꿉니다. GCP 콘솔에서 spaces.list 메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.

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

    node add-app-to-space.js

Chat API는 membership 드림 생성된 앱 멤버십을 자세히 설명합니다.