Google Workspace 구독 만들기

이 페이지에서는 Google Workspace Events API를 사용하여 Google Workspace 리소스 구독을 만드는 방법을 설명합니다. Google Workspace 구독을 사용하면 앱에서 Google Workspace 리소스의 변경사항을 나타내는 Google Workspace 이벤트에 관한 정보를 수신할 수 있습니다. Google Workspace Events API에서 지원하는 리소스 및 이벤트 유형에 관한 자세한 내용은 Google Workspace Events API 개요를 참고하세요.

이 페이지에는 Google Workspace 구독을 만드는 다음 단계가 포함되어 있습니다.

1. 환경을 설정합니다.
2. Google Cloud Pub/Sub 주제를 만들고 구독합니다. 이 주제를 엔드포인트로 사용하여 Google Workspace 이벤트를 수신합니다.
3. Subscription 리소스에서 Google Workspace Events API의 create() 메서드를 호출합니다.
4. Google Workspace 구독을 테스트하여 Pub/Sub 주제가 구독한 이벤트를 수신하는지 확인합니다.
5. 원하는 경우 앱에서 이벤트를 처리하고 필요한 경우 조치를 취할 수 있도록 앱의 엔드포인트에 이벤트를 푸시하는 방법을 구성합니다.

기본 요건

Apps Script

• 이 가이드에서 Google Cloud CLI 명령어를 사용하려면 다음 안내를 따르세요.
  1. Google Cloud CLI 설치
  2. gcloud CLI를 초기화하려면 다음 코드를 실행합니다.

    gcloud init
    

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

• Apps Script 프로젝트:
  • Apps Script에서 자동으로 생성된 기본 프로젝트 대신 Google Cloud 프로젝트를 사용합니다.
  • 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 명령어를 사용하려면 다음 안내를 따르세요.
  1. Google Cloud CLI 설치
  2. gcloud CLI를 초기화하려면 다음 코드를 실행합니다.

    gcloud init
    

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

환경 설정

다음 섹션에서는 Google Workspace 구독을 만들기 전에 환경을 설정하는 방법을 설명합니다.

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

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

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

OAuth 클라이언트 ID 사용자 인증 정보 만들기

참고: Apps Script를 사용하는 경우 이 단계를 건너뛸 수 있습니다.

OAuth 클라이언트 ID를 만드는 방법에 관한 구체적인 안내는 애플리케이션 유형을 선택하세요.

참고: 이 가이드의 코드 샘플을 실행하려면 데스크톱 앱을 선택하고 안내를 따르세요.

웹 애플리케이션

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > 웹 애플리케이션을 클릭합니다.
4. 이름 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. 앱과 관련된 승인된 URI를 추가합니다.
   • 클라이언트 측 앱 (JavaScript): 승인된 JavaScript 출처에서 URI 추가를 클릭합니다. 그런 다음 브라우저 요청에 사용할 URI를 입력합니다. 이를 통해 애플리케이션이 OAuth 2.0 서버에 API 요청을 보낼 수 있는 도메인을 식별할 수 있습니다.
   • 서버 측 앱 (Java, Python 등): 승인된 리디렉션 URI에서 URI 추가를 클릭합니다. 그런 다음 OAuth 2.0 서버가 응답을 보낼 수 있는 엔드포인트 URI를 입력합니다.
6. 만들기를 클릭합니다. 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.

   클라이언트 ID를 기록합니다. 클라이언트 보안 비밀은 웹 애플리케이션에 사용되지 않습니다.

7. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 OAuth 2.0 클라이언트 ID 아래에 표시됩니다.

Android

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > Android를 클릭합니다.
4. '이름' 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. '패키지 이름' 입력란에 AndroidManifest.xml 파일의 패키지 이름을 입력합니다.
6. 'SHA-1 인증서 지문' 입력란에 생성된 SHA-1 인증서 지문을 입력합니다.
7. 만들기를 클릭합니다. 새 클라이언트 ID가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.
8. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.

iOS

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > iOS를 클릭합니다.
4. '이름' 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. 'Bundle ID' 입력란에 앱의 Info.plist 파일에 나열된 번들 식별자를 입력합니다.
6. 선택사항: 앱이 Apple App Store에 표시되는 경우 App Store ID를 입력합니다.
7. 선택사항: '팀 ID' 입력란에 Apple에서 생성하여 팀에 할당한 고유한 10자리 문자열을 입력합니다.
8. 만들기를 클릭합니다. 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.
9. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.

Chrome 앱

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > Chrome 앱을 클릭합니다.
4. '이름' 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. '애플리케이션 ID' 입력란에 앱의 고유한 32자 ID 문자열을 입력합니다. 이 ID 값은 앱의 Chrome 웹 스토어 URL과 Chrome 웹 스토어 개발자 대시보드에서 확인할 수 있습니다.
6. 만들기를 클릭합니다. 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.
7. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.

데스크톱 앱

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > 데스크톱 앱을 클릭합니다.
4. 이름 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. 만들기를 클릭합니다. 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.
6. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 OAuth 2.0 클라이언트 ID 아래에 표시됩니다.

TV 및 입력 제한 기기

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > TV 및 제한된 입력 기기를 클릭합니다.
4. '이름' 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. 만들기를 클릭합니다. 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.
6. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.

Universal Windows Platform(UWP)

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
3. 애플리케이션 유형 > 유니버설 Windows 플랫폼 (UWP)을 클릭합니다.
4. '이름' 입력란에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
5. '스토어 ID' 필드에 앱의 고유한 12자리 Microsoft Store ID 값을 입력합니다. 이 ID는 앱의 Microsoft Store URL 및 파트너 센터에서 확인할 수 있습니다.
6. 만들기를 클릭합니다. 새 클라이언트 ID와 클라이언트 보안 비밀번호가 표시된 OAuth 클라이언트 생성 화면이 표시됩니다.
7. 확인을 클릭합니다. 새로 만든 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.

클라이언트 보안 비밀 JSON 파일 다운로드

참고: Apps Script를 사용하는 경우 이 단계를 건너뛸 수 있습니다.

클라이언트 비밀 파일은 앱이 사용자 인증 정보를 제공할 때 참조할 수 있는 OAuth 클라이언트 ID 사용자 인증 정보의 JSON 표현입니다.

1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.

   사용자 인증 정보로 이동

2. OAuth 2.0 클라이언트 ID에서 만든 클라이언트 ID를 클릭합니다.

3. JSON 다운로드를 클릭합니다.

4. 파일을 client_secrets.json로 저장합니다.

Pub/Sub 주제 만들기 및 구독하기

이 섹션에서는 Pub/Sub 주제와 주제에 대한 구독을 만듭니다. Pub/Sub 주제는 Google Workspace 구독에서 이벤트를 수신하는 알림 엔드포인트 역할을 합니다.

Pub/Sub 주제 만들기 및 관리에 대해 자세히 알아보려면 Pub/Sub 문서를 참고하세요.

Pub/Sub 주제를 만들고 구독하려면 다음 단계를 따르세요.

Google Cloud 콘솔

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

   Google Cloud Pub/Sub으로 이동

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

2. 주제 만들기를 클릭하고 다음을 실행합니다.

   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 애플리케이션의 서비스 계정을 추가합니다.
      1. Chat 이벤트의 경우 [e-mail]입니다.
      2. Meet 이벤트의 경우 [e-mail]를 탭합니다.
   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에서 이벤트를 수신하려면 [e-mail]을 사용하세요.
     • Meet에서 이벤트를 수신하려면 [e-mail]을 사용하세요.

   주제의 권한이 업데이트되는 데 몇 분 정도 걸릴 수 있습니다.

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

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

   다음을 바꿉니다.

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

Google Workspace 리소스 구독하기

이 섹션에서는 이벤트를 모니터링하려는 Google Workspace 리소스를 구독합니다.

대상 리소스 선택 및 식별

Google Workspace 구독에서 타겟 리소스는 이벤트를 모니터링하는 Google Workspace 리소스입니다. 타겟 리소스는 전체 리소스 이름을 사용하여 형식이 지정된 구독의 targetResource 필드에 표시됩니다. 예를 들어 Google Chat 스페이스 (spaces/AAAABBBBBBB)를 모니터링하는 구독의 경우 targetResource의 값은 //chat.googleapis.com/spaces/AAAABBBBBBB입니다.

구독을 만들기 전에 다음 섹션을 사용하여 대상 리소스를 식별하고 형식을 지정하는 방법을 알아보세요.

Chat의 대상 리소스 식별

타겟 리소스	방식	제한사항
공백	//chat.googleapis.com/spaces/SPACE 여기서 SPACE는 Chat API space 리소스의 리소스 이름에 있는 ID입니다. 스페이스의 URL에서 ID를 가져오거나 spaces.list() 메서드를 사용하여 ID를 가져올 수 있습니다.	구독을 승인하는 Chat 사용자는 Google Workspace 또는 Google 계정을 통해 스페이스의 구성원임
사용자의 모든 스페이스	//chat.googleapis.com/spaces/-	구독은 사용자가 Google Workspace 또는 Google 계정을 통해 회원으로 있는 스페이스의 일정만 수신합니다.
사용자	//cloudidentity.googleapis.com/users/USER 여기서 USER는 Chat API user 리소스의 리소스 이름에 있는 ID입니다. 자세한 내용은 Google Chat 사용자 식별 및 지정하기를 참고하세요.	구독은 구독을 승인한 사용자에 관한 이벤트만 수신합니다. 사용자는 다른 사용자를 대신하여 정기 결제를 승인할 수 없습니다.

Meet의 대상 리소스 식별

타겟 리소스	방식	제한사항 (해당하는 경우)
회의 공간	//meet.googleapis.com/spaces/SPACE 여기서 SPACE는 Meet REST API space 리소스의 리소스 이름에 있는 ID입니다. 자세한 내용은 Meet에서 회의 공간을 식별하는 방법을 참고하세요.
사용자	//cloudidentity.googleapis.com/users/USER 여기서 USER는 Meet REST API participant 리소스의 signedinUser.user 필드에 있는 ID입니다. 자세한 내용은 참여자 작업을 참고하세요.	구독은 사용자가 다음 중 하나인 회의 공간에 관한 이벤트를 수신합니다. 회의실 소유자입니다. 회의 공간과 연결된 Google Calendar 일정의 주최자입니다.

Google Workspace 구독 만들기

구독을 만들려면 Google Workspace Events API의 subscriptions.create() 메서드를 사용하여 Subscription 리소스를 만듭니다. 다음 필드를 지정합니다.

• targetResource: 이전 섹션에서 식별한 Google Workspace로, 전체 리소스 이름을 사용하여 형식이 지정됩니다.
• eventTypes: 리소스에 관해 수신하려는 이벤트 유형 하나 이상의 배열입니다. 예를 들어 앱에서 Chat 스페이스에 게시된 새 메시지만 알아야 하는 경우 앱은 생성된 메시지에 관한 이벤트를 구독하기만 하면 됩니다.
• notificationEndpoint: Google Workspace 구독에서 이벤트를 전송하는 알림 엔드포인트입니다. 이전 섹션에서 만든 Pub/Sub 주제를 사용합니다.
• payloadOptions: 이벤트 페이로드에 포함할 리소스 데이터의 양을 지정하는 옵션입니다. 이 구성은 정기 결제의 만료 시간에 영향을 미칩니다. 자세한 내용은 이벤트 데이터를 참고하세요.

Google Workspace 구독을 만들려면 다음 단계를 따르세요.

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가 AAAABBBB인 Google Chat 스페이스를 구독하려면 //chat.googleapis.com/spaces/AAAABBBB를 사용합니다.
   • EVENT_TYPES: 대상 리소스에서 구독하려는 이벤트 유형 하나 이상입니다. 'google.workspace.chat.message.v1.created'와 같은 문자열 배열 형식으로 지정합니다.
   • TOPIC_NAME: Cloud 프로젝트에서 만든 Pub/Sub 주제의 전체 이름입니다. 형식은 projects/PROJECT_ID/topics/TOPIC_ID입니다.

   • RESOURCE_DATA: 정기 결제에 페이로드에 리소스 데이터가 포함되는지 여부를 지정하는 불리언입니다.

     • True: 모든 리소스 데이터를 포함합니다. 포함되는 필드를 제한하려면 fieldMask 필드를 추가하고 변경된 리소스에 하나 이상의 필드를 지정합니다. 리소스 데이터를 포함하는 채팅 리소스 구독만 지원됩니다.
     • 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 범위 1개 이상 문자열 배열 형식입니다. 여러 범위를 나열하려면 쉼표로 구분하세요. 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'를 예로 들 수 있습니다.
   • TARGET_RESOURCE: 구독 중인 Google Workspace 리소스로, 전체 리소스 이름 형식입니다. 예를 들어 스페이스 ID가 AAAABBBB인 Google Chat 스페이스를 구독하려면 //chat.googleapis.com/spaces/AAAABBBB를 사용합니다.
   • EVENT_TYPES: 대상 리소스에서 구독하려는 이벤트 유형 하나 이상입니다. 'google.workspace.chat.message.v1.created'와 같은 문자열 배열 형식으로 지정합니다.
   • TOPIC_NAME: Cloud 프로젝트에서 만든 Pub/Sub 주제의 전체 이름입니다. 형식은 projects/PROJECT_ID/topics/TOPIC_ID입니다.

   • RESOURCE_DATA: 정기 결제에 페이로드에 리소스 데이터가 포함되는지 여부를 지정하는 불리언입니다.

     • True: 모든 리소스 데이터를 포함합니다. 포함할 필드를 제한하려면 fieldMask 필드를 추가하고 변경된 리소스에 하나 이상의 필드를 지정합니다. 리소스 데이터를 포함하는 채팅 리소스 구독만 지원됩니다.
     • False: 리소스 데이터를 제외합니다.

2. Google Workspace 구독을 만들려면 터미널에서 다음을 실행합니다.

   python3 create_subscription.py

Google Workspace Events API는 내가 만든 Subscription 리소스의 인스턴스가 포함된 완료된 장기 실행 작업을 반환합니다.

Google Workspace 구독 테스트

Google Workspace 이벤트가 수신되는지 테스트하려면 이벤트를 트리거하고 Pub/Sub 구독으로 메시지를 가져오면 됩니다.

Google Workspace 구독을 테스트하려면 다음 단계를 따르세요.

Google Cloud 콘솔

1. Google Workspace 구독의 대상 리소스에서 하나 이상의 이벤트 유형을 트리거합니다. 예를 들어 Chat 스페이스에서 새 메시지를 구독한 경우 스페이스에 메시지를 게시합니다.

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

   Pub/Sub로 이동

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

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

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

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

6. 가져오기를 클릭합니다. 이벤트가 Pub/Sub 메시지를 생성하는 데 최대 몇 분 정도 걸릴 수 있습니다.

gcloud

1. Google Workspace 구독의 대상 리소스에서 하나 이상의 이벤트 유형을 트리거합니다. 예를 들어 Chat 스페이스에서 새 메시지를 구독한 경우 스페이스에 메시지를 게시합니다.

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

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

   다음을 바꿉니다.

   • PUBSUB_SUBSCRIPTION_NAME: projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID 형식의 Pub/Sub 구독의 전체 이름입니다.
   • MESSAGE_COUNT: 가져올 최대 Pub/Sub 메시지 수입니다.

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

트리거한 각 Google Workspace 이벤트에 대해 이벤트가 포함된 Pub/Sub 구독에 메시지가 전송됩니다. 자세한 내용은 Google Cloud Pub/Sub 메시지로 이벤트 수신을 참고하세요.

앱에서 이벤트를 수신하는 방식 구성

만든 Pub/Sub 구독은 가져오기 기반입니다. Pub/Sub 구독을 테스트한 후 전송 유형을 업데이트하여 앱에서 이벤트를 수신하는 방식을 변경할 수 있습니다. 예를 들어 앱이 앱 엔드포인트로 직접 이벤트를 수신할 수 있도록 Pub/Sub 구독을 푸시 전송 유형으로 구성할 수 있습니다.

Pub/Sub 구독 구성에 관한 자세한 내용은 Pub/Sub 문서를 참고하세요.

참고: Pub/Sub에서 Apps Script 프로젝트를 푸시 전송 엔드포인트로 설정할 수 없습니다. Pub/Sub 메시지를 Apps Script 프로젝트에 푸시하려면 스크립트를 웹 앱으로 게시해야 합니다.

관련 주제

• 튜토리얼: Python 및 Google Meet REST API로 회의 이벤트 관찰
• 구독하기
• 구독 나열
• 구독 업데이트 또는 갱신하기
• 오류 해결 및 정기 결제 재활성화하기
• 구독 삭제하기