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

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

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

기본 요건

Python

Node.js

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

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

  • chat.memberships 승인 범위를 지정합니다.
  • 먼저 create 메서드 에 membership 리소스.
  • parent을 멤버십을 만들 스페이스의 리소스 이름으로 설정합니다.
  • member를 users/{user}로 설정합니다. 여기서 {user}는 원하는 사람입니다. 다음 중 하나에 대한 멤버십을 만듭니다. <ph type="x-smartling-placeholder">
      </ph>
    • 이 사람 할 수 있습니다. 예를 들어 People API가 사람 resourceName가 people/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을 멤버십을 만들 스페이스의 리소스 이름으로 설정합니다.
  • groupMember를 groups/{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을 멤버십을 만들 스페이스의 리소스 이름으로 설정합니다.
  • member를 users/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 드림 생성된 앱 멤버십을 자세히 설명합니다.