Google Workspace 구독 만들기

Apps Script

• 이 가이드의 Google Cloud CLI 명령어를 사용하려면 다음 안내를 따르세요. <ph type="x-smartling-placeholder">
  </ph>
  1. Google Cloud CLI 설치
  2. 받는사람: gcloud CLI를 초기화하려면 다음 코드를 실행합니다.

    gcloud init
    

• Google Cloud 프로젝트 결제 사용 설정 Chat을 구독하려면 다음 요구사항을 충족해야 합니다. Cloud 프로젝트에서 Chat API를 사용 설정합니다. 앱 이름, 아바타 URL, 설명을 구성합니다. 있습니다. 자세한 내용은 Google Chat 앱을 빌드합니다.
• 다음에 대해 구성된 OAuth 동의 화면을 사용하여 사용자 인증이 필요합니다. 앱 동의 화면을 구성할 때 구독의 각 이벤트 유형을 지원해야 합니다 동의를 구성하려면 다음 단계를 따르세요. 필요한 범위를 식별하려면 범위를 선택합니다.

• Apps Script 프로젝트:
  • 자동으로 생성된 기본 프로젝트 대신 Google Cloud 프로젝트를 사용합니다. Apps Script
  • OAuth 동의 화면을 구성하기 위해 추가한 모든 범위의 경우 Apps Script 프로젝트의 appsscript.json 파일에 대한 범위를 설정합니다. 예를 들면 다음과 같습니다.

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • 사용 설정 Google Workspace Events 고급 서비스

Python

• Python 3.6 이상
• pip 패키지 관리 도구
• Python용 최신 Google 클라이언트 라이브러리입니다. 설치하거나 업데이트하려면 다음을 실행합니다. 명령어를 실행하면 됩니다

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• 이 가이드의 Google Cloud CLI 명령어를 사용하려면 다음 안내를 따르세요. <ph type="x-smartling-placeholder">
  </ph>
  1. Google Cloud CLI 설치
  2. 받는사람: gcloud CLI를 초기화하려면 다음 코드를 실행합니다.

    gcloud init
    

• Google Cloud 프로젝트 결제 사용 설정 Chat을 구독하려면 다음 요구사항을 충족해야 합니다. Cloud 프로젝트에서 Chat API를 사용 설정합니다. 앱 이름, 아바타 URL, 설명을 구성합니다. 있습니다. 자세한 내용은 Google Chat 앱을 빌드합니다.
• 다음에 대해 구성된 OAuth 동의 화면을 사용한 사용자 인증이 필요합니다. 앱 동의 화면을 구성할 때 구독의 각 이벤트 유형을 지원해야 합니다 동의를 구성하려면 다음 단계를 따르세요. 필요한 범위를 식별하려면 범위를 선택합니다.

Google Cloud 콘솔

Google Cloud 콘솔에서 앱의 Google Cloud 프로젝트를 열고 Google Workspace Events API 및 Pub/Sub API:

API 사용 설정

gcloud

1. 작업 디렉터리에서 Google 계정에 로그인합니다.

   gcloud auth login
   

2. 프로젝트를 앱의 Cloud 프로젝트로 설정합니다.

   gcloud config set project PROJECT_ID
   

   PROJECT_ID를 앱의 Cloud 프로젝트에 대한 프로젝트 ID입니다.

3. Google Workspace Events API 및 Google Cloud Pub/Sub 사용 설정 API:

   gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com
   

Google Cloud 콘솔

1. Google Cloud 콘솔에서 Pub/Sub 페이지로 이동합니다.

   Google Cloud Pub/Sub로 이동

   앱의 Cloud 프로젝트가 선택되어 있는지 확인합니다.

2. add_box 주제 만들기를 클릭합니다. 다음을 수행하세요.

   1. 주제의 이름을 입력합니다(예: workspace-events-topic).
   2. 기본 구독 추가를 선택된 상태로 둡니다. Pub/Sub는 주제 이름과 유사한 기본 구독(예: workspace-events-topic-sub
   3. 선택사항: 추가 속성 업데이트 또는 구성 확인할 수 있습니다

3. 만들기를 클릭합니다. 전체 주제 이름의 형식은 다음과 같습니다. projects/PROJECT_ID/topics/TOPIC_ID 이후 단계에서 이 전체 이름을 사용합니다.

4. 주제에 Pub/Sub 메시지를 게시할 액세스 권한을 부여합니다.

   1. 주제 페이지에서 측면 패널로 이동하여 권한 탭
   2. 주 구성원 추가를 클릭합니다.
   3. 주 구성원 추가 필드에서 Google Workspace 애플리케이션이 구독: <ph type="x-smartling-placeholder">
      </ph>
      1. Chat 이벤트의 경우 chat-api-push@system.gserviceaccount.com
      2. Meet 이벤트의 경우 meet-api-event-push@system.gserviceaccount.com
   4. 역할 할당 메뉴에서 Pub/Sub Publisher를 선택합니다.
   5. 저장을 클릭합니다. 권한을 업데이트하는 데 몇 분 정도 걸릴 수 있습니다. 확인할 수 있습니다

gcloud

1. Cloud 프로젝트에서 다음을 실행하여 주제를 만듭니다. 명령어:

   gcloud pubsub topics create TOPIC_ID
   

   TOPIC_ID를 주제의 고유 ID로 바꿉니다. workspace-events-topic 형식으로 전송합니다.

   출력에는 projects/PROJECT_ID/topics/TOPIC_ID 이름을 기록하고 PROJECT_ID는 Cloud 프로젝트 ID입니다. 할 수 있습니다. 다음 단계에서 주제 이름을 사용하여 Google Workspace 구독은 나중에 다시 변경할 수 있습니다

2. 주제에 메시지를 게시할 액세스 권한을 부여합니다.

   gcloud pubsub topics add-iam-policy-binding TOPIC_NAME --member='serviceAccount:GOOGLE_WORKSPACE_APPLICATION' --role='roles/pubsub.publisher'
   

   다음을 바꿉니다.

   • TOPIC_NAME: 전체 주제 이름으로, 출력됩니다. 형식: projects/PROJECT_ID/topics/TOPIC_ID

   • GOOGLE_WORKSPACE_APPLICATION: 이벤트를 전송해야 하는 Google Workspace 애플리케이션 구독:

     • Chat에서 이벤트를 수신하려면 다음을 사용하세요. chat-api-push@system.gserviceaccount.com
     • Meet에서 일정을 수신하려면 다음을 사용하세요. meet-api-event-push@system.gserviceaccount.com

   주제에 대한 권한을 업데이트하는 데 몇 분 정도 걸릴 수 있습니다.

3. 주제의 Pub/Sub 구독을 만듭니다.

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME
   

   다음을 바꿉니다.

   • SUBSCRIPTION_NAME: 구독의 이름입니다. (예: workspace-events-subscription)
   • TOPIC_NAME: 내가 만든 주제의 이름입니다. 이전 단계에서 설명하겠습니다.

Apps Script

1. Apps Script 프로젝트에서 새 스크립트 파일을 만듭니다. 이름이 createSubscription이고 다음 코드를 추가합니다.

   function createSubscription() {
     // The Google Workspace resource to monitor for events.
     const targetResource = 'TARGET_RESOURCE';
   
     // The types of events to receive.
     const eventTypes = [EVENT_TYPES];
   
     // The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
     const pubsubTopic = 'TOPIC_NAME';
   
     // Whether to include resource data or not.
     const resourceData = RESOURCE_DATA;
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.create({
       targetResource: targetResource,
       eventTypes: eventTypes,
       notificationEndpoint: {
         pubsubTopic: pubsubTopic,
       },
       payloadOptions: {
         includeResource: resourceData
       }
     });
     console.log(response);
   }
   

   다음을 바꿉니다.

   • TARGET_RESOURCE: Google Workspace 리소스 전체 리소스 이름으로 형식이 지정된 전체 리소스 이름입니다. 대상 예를 들어 스페이스 ID로 Google Chat 스페이스를 구독하는 방법은 다음과 같습니다. AAAABBBB, //chat.googleapis.com/spaces/AAAABBBB 사용
   • EVENT_TYPES: 하나 이상의 이벤트 유형 대상 리소스에서 구독하려는 리소스를 생성합니다 형식 'google.workspace.chat.message.v1.created'와 같은 문자열 배열입니다.
   • TOPIC_NAME: 현재 실행 중인 Pub/Sub 주제의 전체 이름입니다. 볼 수 있습니다 형식: projects/PROJECT_ID/topics/TOPIC_ID

   • RESOURCE_DATA: 구독에는 페이로드에 리소스 데이터가 포함됩니다.

     • True: 모든 리소스 데이터를 포함합니다. 어떤 필드를 포함되어 있으면 fieldMask 필드를 만들고 변경된 리소스에 대해 하나 이상의 필드를 지정해야 합니다. 단 다음을 포함한 Chat 리소스 지원 구독 리소스 데이터입니다.
     • False: 리소스 데이터를 제외합니다.

2. Google Workspace 구독을 만들려면 함수를 실행하세요. Apps Script 프로젝트의 createSubscription.

Python

1. 작업 디렉터리에 create_subscription.py라는 파일을 만듭니다. 그리고 다음 코드를 추가합니다.

   """Create subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = [SCOPES]
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # The Google Workspace resource to monitor for events.
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   # The types of events to receive.
   EVENT_TYPES = [EVENT_TYPES]
   
   # The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
   TOPIC = 'TOPIC_NAME'
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'target_resource': TARGET_RESOURCE,
       'event_types': EVENT_TYPES,
       'notification_endpoint': {'pubsub_topic': TOPIC},
       'payload_options': {'include_resource': RESOURCE_DATA},
   }
   response = service.subscriptions().create(body=BODY).execute()
   print(response)
   

   다음을 바꿉니다.

   • SCOPES: 각 이벤트 유형을 지원하는 하나 이상의 OAuth 범위 구독의 역할을 합니다 문자열 배열로 형식이 지정됩니다. 여러 범위를 나열하려면 쉼표로 구분합니다. 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'를 예로 들 수 있습니다.
   • TARGET_RESOURCE: Google Workspace 리소스 전체 리소스 이름으로 형식이 지정된 전체 리소스 이름입니다. 대상 예를 들어 스페이스 ID로 Google Chat 스페이스를 구독하는 방법은 다음과 같습니다. AAAABBBB, //chat.googleapis.com/spaces/AAAABBBB 사용
   • EVENT_TYPES: 하나 이상의 이벤트 유형 대상 리소스에서 구독하려는 리소스를 생성합니다 형식 'google.workspace.chat.message.v1.created'와 같은 문자열 배열입니다.
   • TOPIC_NAME: 현재 실행 중인 Pub/Sub 주제의 전체 이름입니다. 볼 수 있습니다 형식: projects/PROJECT_ID/topics/TOPIC_ID

   • RESOURCE_DATA: 구독에는 페이로드에 리소스 데이터가 포함됩니다.

     • True: 모든 리소스 데이터를 포함합니다. 어떤 필드를 포함되어 있으면 fieldMask 필드를 하나 이상 지정하고 변경된 리소스에 대해 하나 이상의 필드를 지정해야 합니다. 단 다음을 포함한 Chat 리소스 지원 구독 리소스 데이터입니다.
     • False: 리소스 데이터를 제외합니다.

2. Google Workspace 구독을 만들려면 다음 명령어를 실행합니다. 터미널:

   python3 create_subscription.py
   

Google Cloud 콘솔

1. 캠페인의 타겟 리소스에서 하나 이상의 이벤트 유형을 트리거하세요. Google Workspace 구독 예를 들어 메시지를 게시하고 스페이스에 메시지를 게시하세요.

2. Google Cloud 콘솔에서 Pub/Sub 페이지로 이동합니다.

   Pub/Sub로 이동

   앱의 Cloud 프로젝트가 선택되어 있는지 확인합니다.

3. Pub/Sub 메뉴에서 구독을 클릭합니다.

4. 표에서 주제에 대한 Pub/Sub 구독을 찾아 클릭합니다. 구독 이름을 지정합니다

5. 메시지 탭을 클릭합니다.

6. 가져오기를 클릭합니다. 이벤트에서 Pub/Sub 메시지

gcloud

1. 캠페인의 타겟 리소스에서 하나 이상의 이벤트 유형을 트리거하세요. Google Workspace 구독 예를 들어 메시지를 게시하고 스페이스에 메시지를 게시하세요.

2. 다음 명령어를 실행합니다.

   gcloud pubsub subscriptions pull PUBSUB_SUBSCRIPTION_NAME --format=json --limit=MESSAGE_COUNT --auto-ack
   

   다음을 바꿉니다.

   • PUBSUB_SUBSCRIPTION_NAME: 다음 형식으로 된 Pub/Sub 구독 projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID
   • MESSAGE_COUNT: 가져올 최대 Pub/Sub 메시지 수입니다.

   이벤트에서 Pub/Sub를 생성하는 데 최대 몇 분이 걸릴 수 있습니다. 메시지가 표시됩니다.