이 페이지에서는 Google Workspace Events API를 사용하여 Google Workspace 리소스에 대한 구독 서비스를 제공합니다 Google Workspace 구독 앱을 사용하면 앱에서 Google Workspace 이벤트에 관한 정보를 수신할 수 있습니다. Google Workspace 리소스의 변경사항을 나타냅니다. 자세히 알아보기 위해 Google Workspace Events API에서 지원하는 리소스와 이벤트 유형은 Google Workspace Events API 개요
이 페이지에서는 Google Workspace를 만들기 위한 다음 단계를 안내합니다. 구독:
- 환경을 설정합니다.
- Google Cloud Pub/Sub 주제를 만들고 구독합니다. 이 주제를 다음 용도로 사용합니다. Google Workspace 이벤트를 수신할 수 있는 엔드포인트
- Google Workspace Events API의
create()
호출 메서드를Subscription
리소스도 제공합니다 - Google Workspace 구독을 테스트하여 Pub/Sub가 주제는 사용자가 구독한 이벤트를 수신합니다.
- 원하는 경우 앱의 엔드포인트로 이벤트를 푸시하는 방법을 구성하여 앱이 이벤트를 처리하고 필요한 경우 조치를 취할 수 있어야 합니다.
기본 요건
Apps Script
- 이 가이드의 Google Cloud CLI 명령어를 사용하려면 다음 안내를 따르세요.
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud CLI 설치
- 받는사람:
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
파일에 대한 범위를 설정합니다. 예를 들면 다음과 같습니다. - 사용 설정
Google Workspace Events
고급 서비스
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
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>
- Google Cloud CLI 설치
- 받는사람:
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:
gcloud
작업 디렉터리에서 Google 계정에 로그인합니다.
gcloud auth login
프로젝트를 앱의 Cloud 프로젝트로 설정합니다.
gcloud config set project PROJECT_ID
PROJECT_ID
를 앱의 Cloud 프로젝트에 대한 프로젝트 ID입니다.Google Workspace Events API 및 Google Cloud Pub/Sub 사용 설정 API:
gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com
OAuth 클라이언트 ID 사용자 인증 정보 만들기
OAuth 클라이언트 ID를 만드는 방법에 대한 구체적인 안내를 보려면 애플리케이션 유형을 선택합니다.
웹 애플리케이션
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > 웹 애플리케이션을 클릭합니다.
- 이름 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- 앱과 관련된 승인된 URI를 추가합니다.
<ph type="x-smartling-placeholder">
- </ph>
- 클라이언트 측 앱 (JavaScript): 승인된 자바스크립트 원본에서 URI 추가를 클릭합니다. 그런 다음 브라우저 요청에 사용할 URI를 입력합니다. 애플리케이션에서 OAuth 2.0 서버로 API 요청을 보낼 수 있는 도메인을 식별합니다.
- 서버 측 앱 (자바, Python 등): 승인된 리디렉션 URI에서 URI 추가를 클릭합니다. 그런 다음 OAuth 2.0 서버가 응답을 보낼 수 있는 엔드포인트 URI를 입력합니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
클라이언트 ID를 기록해 둡니다. 클라이언트 비밀번호는 웹 애플리케이션에 사용되지 않습니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 OAuth 2.0 클라이언트 ID 아래에 표시됩니다.
Android
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > Android를 클릭합니다.
- '이름' 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- '패키지 이름' 필드에
AndroidManifest.xml
파일의 패키지 이름을 입력합니다. - 'SHA-1 인증서 지문'에서 필드에 생성된 SHA-1 인증서 지문을 입력합니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 나타나고 새 클라이언트 ID가 표시됩니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.
iOS
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > iOS를 클릭합니다.
- '이름' 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- 'Bundle ID'(번들 ID)에서 필드에 앱의
Info.plist
파일에 나열된 대로 번들 식별자를 입력합니다. - 선택사항: 앱이 Apple App Store에 표시되면 App Store ID를 입력합니다.
- 선택사항: '팀 ID' 입력란에 Apple에서 생성하여 팀에 할당한 고유한 10자 문자열을 입력합니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.
Chrome 앱
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > Chrome 앱을 클릭합니다.
- '이름' 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- '애플리케이션 ID' 필드에 앱의 고유한 32자 ID 문자열을 입력합니다. 이 ID 값은 앱의 Chrome 웹 스토어 URL 및 Chrome 웹 스토어 개발자 대시보드에서 확인할 수 있습니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.
데스크톱 앱
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > 데스크톱 앱을 클릭합니다.
- 이름 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 OAuth 2.0 클라이언트 ID 아래에 표시됩니다.
TV 및 제한된 입력 기기
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > TV 및 제한된 입력 장치.
- '이름' 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.
Universal Windows Platform(UWP)
- Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보로 이동합니다.
- 사용자 인증 정보 만들기 > OAuth 클라이언트 ID를 클릭합니다.
- 애플리케이션 유형 > 범용 Windows 플랫폼 (UWP)을 클릭합니다.
- '이름' 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에만 표시됩니다.
- 'Store ID'에서 입력란에 앱의 고유한 12자리 Microsoft Store ID 값을 입력합니다. 이 ID는 앱의 Microsoft Store URL 및 파트너 센터에서 확인할 수 있습니다.
- 만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새 클라이언트 ID와 클라이언트 비밀번호가 표시됩니다.
- 확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 'OAuth 2.0 클라이언트 ID' 아래에 표시됩니다.
클라이언트 보안 비밀번호 JSON 파일 다운로드
클라이언트 보안 비밀번호 파일은 OAuth 클라이언트 ID의 JSON 표현입니다. 사용자 인증 정보를 제공할 때 앱에서 참조할 수 있는 사용자 인증 정보를 제공합니다.
Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보를 선택합니다.
로 이동합니다.OAuth 2.0 클라이언트 ID 아래에서 만든 클라이언트 ID를 클릭합니다.
JSON 다운로드를 클릭합니다.
파일을
client_secrets.json
로 저장합니다.
Pub/Sub 주제 만들기 및 구독
이 섹션에서는 Pub/Sub 주제 및 구독을 만듭니다. 주제를 자세히 살펴보겠습니다. Pub/Sub 주제는 Google Workspace 구독이 수신되는 알림 엔드포인트 이벤트를 수신합니다.
Pub/Sub 주제 생성 및 관리에 대한 자세한 내용은 다음을 참조하세요. Pub/Sub는 문서 에서 자세한 내용을 확인하실 수 있습니다.
Pub/Sub 주제를 만들고 구독하려면 다음 안내를 따르세요.
Google Cloud 콘솔
Google Cloud 콘솔에서 Pub/Sub 페이지로 이동합니다.
앱의 Cloud 프로젝트가 선택되어 있는지 확인합니다.
주제 만들기를 클릭합니다. 다음을 수행하세요.
- 주제의 이름을 입력합니다(예:
workspace-events-topic
). - 기본 구독 추가를 선택된 상태로 둡니다. Pub/Sub는
주제 이름과 유사한 기본 구독(예:
workspace-events-topic-sub
- 선택사항: 추가 속성 업데이트 또는 구성 확인할 수 있습니다
- 주제의 이름을 입력합니다(예:
만들기를 클릭합니다. 전체 주제 이름의 형식은 다음과 같습니다.
projects/PROJECT_ID/topics/TOPIC_ID
이후 단계에서 이 전체 이름을 사용합니다.주제에 Pub/Sub 메시지를 게시할 액세스 권한을 부여합니다.
- 주제 페이지에서 측면 패널로 이동하여 권한 탭
- 주 구성원 추가를 클릭합니다.
- 주 구성원 추가 필드에서
Google Workspace 애플리케이션이
구독:
<ph type="x-smartling-placeholder">
- </ph>
- Chat 이벤트의 경우
chat-api-push@system.gserviceaccount.com
- Meet 이벤트의 경우
meet-api-event-push@system.gserviceaccount.com
- Chat 이벤트의 경우
- 역할 할당 메뉴에서
Pub/Sub Publisher
를 선택합니다. - 저장을 클릭합니다. 권한을 업데이트하는 데 몇 분 정도 걸릴 수 있습니다. 확인할 수 있습니다
gcloud
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 구독은 나중에 다시 변경할 수 있습니다주제에 메시지를 게시할 액세스 권한을 부여합니다.
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
- Chat에서 이벤트를 수신하려면 다음을 사용하세요.
주제에 대한 권한을 업데이트하는 데 몇 분 정도 걸릴 수 있습니다.
주제의 Pub/Sub 구독을 만듭니다.
gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME
다음을 바꿉니다.
SUBSCRIPTION_NAME
: 구독의 이름입니다. (예:workspace-events-subscription
)TOPIC_NAME
: 내가 만든 주제의 이름입니다. 이전 단계에서 설명하겠습니다.
Google Workspace 리소스 구독
이 섹션에서는 정의할 수 있습니다
대상 리소스 선택 및 식별
Google Workspace 구독에서 대상 리소스란
사용자가 이벤트를 모니터링하는 Google Workspace 리소스입니다. 대상
리소스는 구독의 targetResource
필드에 표시되며, 형식은
전체 리소스 이름을 지정합니다 예를 들어 구독 서비스를 모니터링하는 구독의 경우
Google Chat 스페이스 (spaces/AAAABBBBBBB
)의 targetResource
값은 다음과 같습니다.
//chat.googleapis.com/spaces/AAAABBBBBBB
입니다.
구독을 만들기 전에 다음 섹션을 사용하여 다음 방법을 알아보세요. 대상 리소스를 식별하고 형식을 지정합니다
Chat을 위한 대상 리소스 파악하기
대상 리소스 | 방식 | 제한사항 |
---|---|---|
공백 |
여기서 SPACE는
<ph type="x-smartling-placeholder"></ph>
Chat API |
구독을 승인하는 Chat 사용자는 Google Workspace 또는 Google 계정. |
사용자의 모든 스페이스 |
|
구독은 사용자가 있는 스페이스의 이벤트만 수신합니다. Google Workspace 또는 Google 계정을 통한 회원의 액세스 권한 |
사용자 |
여기서 USER는
<ph type="x-smartling-placeholder"></ph>
Chat API |
구독은 사용자가 보내는 이벤트만 수신합니다. 정기 결제를 승인했습니다. 사용자가 구독을 승인할 수 없습니다. 할 수 있습니다. |
Meet의 대상 리소스 파악하기
대상 리소스 | 방식 | 제한사항 (해당하는 경우) |
---|---|---|
회의 공간 | //meet.googleapis.com/spaces/SPACE
여기서 SPACE는
<ph type="x-smartling-placeholder"></ph>
Meet REST API |
|
사용자 | //cloudidentity.googleapis.com/users/USER
여기서 USER는
<ph type="x-smartling-placeholder"></ph>
Meet REST API |
구독은 사용자는 다음 중 하나입니다.
|
Google Workspace 구독 만들기
구독을 만들려면 Google Workspace Events API의
subscriptions.create()
메서드를 사용하여
Subscription
리소스도 제공합니다 다음 필드를 지정합니다.
targetResource
: 전체 리소스 이름을 사용하여 형식이 지정된 이전 섹션eventTypes
: 수신하려는 하나 이상의 이벤트 유형의 배열 리소스입니다 예를 들어 앱이 새 메시지에 대해서만 알면 되는 경우 Chat 스페이스에 게시한 경우 앱에서 이벤트를 구독하기만 하면 생성된 메시지 정보notificationEndpoint
: 알림 엔드포인트 Google Workspace 구독은 이벤트를 제공합니다. 사용자는 이전 섹션에서 만든 Pub/Sub 주제입니다.payloadOptions
: 포함할 리소스 데이터 양을 지정하는 옵션 이벤트 페이로드를 호출합니다. 이 구성은 구독하세요. 자세한 내용은 이벤트 데이터)를 참조하세요.
Google Workspace 구독을 만들려면 다음 안내를 따르세요.
Apps Script
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
: 리소스 데이터를 제외합니다.
Google Workspace 구독을 만들려면 함수를 실행하세요. Apps Script 프로젝트의
createSubscription
.
Python
작업 디렉터리에
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
: 리소스 데이터를 제외합니다.
Google Workspace 구독을 만들려면 다음 명령어를 실행합니다. 터미널:
python3 create_subscription.py
Google Workspace Events API는 완료된 장기 실행 시간
연산에 포함되어야 합니다.
생성한 Subscription
리소스의 인스턴스입니다.
Google Workspace 구독 테스트하기
Google Workspace 이벤트가 수신되는지 테스트하려면 이벤트를 가져오고 메시지를 Pub/Sub 구독으로 가져옵니다.
Google Workspace 구독을 테스트하려면 다음 안내를 따르세요.
Google Cloud 콘솔
캠페인의 타겟 리소스에서 하나 이상의 이벤트 유형을 트리거하세요. Google Workspace 구독 예를 들어 메시지를 게시하고 스페이스에 메시지를 게시하세요.
Google Cloud 콘솔에서 Pub/Sub 페이지로 이동합니다.
앱의 Cloud 프로젝트가 선택되어 있는지 확인합니다.
Pub/Sub 메뉴에서 구독을 클릭합니다.
표에서 주제에 대한 Pub/Sub 구독을 찾아 클릭합니다. 구독 이름을 지정합니다
메시지 탭을 클릭합니다.
가져오기를 클릭합니다. 이벤트에서 Pub/Sub 메시지
gcloud
캠페인의 타겟 리소스에서 하나 이상의 이벤트 유형을 트리거하세요. Google Workspace 구독 예를 들어 메시지를 게시하고 스페이스에 메시지를 게시하세요.
다음 명령어를 실행합니다.
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를 생성하는 데 최대 몇 분이 걸릴 수 있습니다. 메시지가 표시됩니다.
트리거한 각 Google Workspace 이벤트에 대해 메시지가 표시됩니다. 이벤트가 포함된 Pub/Sub 구독에 전달됩니다. 자세한 내용은 이벤트를 Google Cloud Pub/Sub 메시지로 수신
앱의 이벤트 수신 방법 구성
생성한 Pub/Sub 구독은 가져오기 기반입니다. 테스트 완료 후 전송 유형을 업데이트하는 경우 앱에서 이벤트를 수신합니다. 예를 들어 Pub/Sub를 구성하여 푸시 전달 유형으로 설정하여 앱에서 이벤트를 수신할 수 있도록 함 앱 엔드포인트에 직접 연결할 수 있습니다
Pub/Sub 구독을 구성하는 방법에 대한 자세한 내용은 Pub/Sub 구독을 참조하세요. 문서를 참조하세요.