구글 워크스페이스용 Webex 애드온이 요청한 권한들

list-menu피드백이 있습니까?
Webex에서 Google 계정에 액세스할 수 있도록 승인하면 애드온이 사용자 데이터에 액세스할 수 있는 권한을 요청해요.이 주제에는 우리가 요청하는 권한, 왜 필요한지, 당신의 데이터를 처리하는 방법이 나열돼있어요.

사용자 계정 권한

Screenshot of the permissions that Webex requests when you enable the scheduler to connect to your Google account
웹엑스는 이러한 권한을 요청해요
테이블 1이에요.요청된 권한 및 웹엑스에서 해당 권한을 사용하는 방법

허락

스코프

액세스한 데이터

웹엑스는 그걸 어디에 사용해요?

애드온 실행 시 이메일 메시지 메타데이터 보기

지메일이에요

제목, 날짜 및 시간, 초대자 목록

Gmail에서 Webex 미팅을 예약하면 스케줄러가 미팅을 예약하는 데 필수적인 요구 사항인 이러한 정보를 읽어요.

지메일 애드온으로 실행해요

지메일이에요

—

사용자 Gmail에서 Webex 스케줄러를 실행할 수 있게 허용해요.

구글 캘린더에서 여는 이벤트 보기

캘린더예요

제목, 날짜 및 시간, 초대자 목록

구글 캘린더에서 이벤트를 열면 스케줄러가 이런 정보들을 읽어요. 회의 일정을 잡는 데 필수적인 요건이에요.

구글 캘린더에서 연 일정을 편집해요.

캘린더예요

제목 줄

Webex 컨퍼런스 데이터 정보 (카드 UI/속성) 를 현재 열려 있는 캘린더 이벤트에 추가해요.

캘린더 애드온으로 실행하세요

캘린더예요

—

웹엑스 스케줄러를 사용자 구글 캘린더에서 실행할 수 있게 해줘요.

모든 캘린더에서 이벤트 보고 편집하세요.

캘린더예요

제목, 날짜 및 시간, 초대자 목록 읽기

제목 줄 편집해요

단일 사용자 캘린더에서 이벤트를 읽고 쓰는 것과 같은 방식으로 공유 캘린더 시나리오를 지원할 수 있어요.

캘린더 설정 보기

캘린더예요

—

구글 OAuth 2.0에는 이 스코프가 필요해요. https://developers.google.com/calendar/api/guides/auth 봐요.

님 도메인의 사용자 정보 보기

구글 워크스페이스 관리자

구글 사용자 정보의 웹엑스 사이트 URL

구글 사용자 정보에서 Webex SiteURL을 설정한 경우, 우리는 이 URL을 읽고 사용자의 기본값으로 이 사이트에 로그인할 수 있어요.

외부 서비스에 연결

앱 스크립트

웹엑스 서비스에 연결해요

스케줄러가 Webex 서비스를 호출하여 관련 Webex 미팅의 생성/업데이트/삭제를 요청해야 해요.

당신이 없을 때 이 애플리케이션 실행 허용하세요

앱 스크립트

구글 트리거 기반으로 구글 이벤트 객체에 액세스하세요

이렇게 하면 당신이 없을 때, 예를 들어 캘린더에서 회의를 업데이트/삭제하는 구글 트리거에 반응하여 스케줄러가 실행될 수 있어요. https://developers.google.com/apps-script/guides/triggers/events 봐요.

애플리케이션과 관련된 데이터 보기 및 관리

앱 스크립트

애플리케이션 캐시

스케줄러가 일부 Webex 정보를 구글 스토리지에 캐시해요. 예를 들어, 웹엑스 사이트 URL하고 웹엑스 미팅 템플릿.

국가, 언어, 시간대 보기

앱 스크립트

사용자 현재 시간

스케줄러가 사용자의 시간대를 읽어 관련 Webex 미팅을 예약하거나 업데이트해요.

기본 구글 계정 이메일 주소 보기

기타

사용자 지메일 계정 주소

스케줄러가 사용자의 이메일 주소를 읽어 Webex 계정에 바인딩해요.

공개적으로 공개한 모든 개인 정보를 포함하여 당신의 개인 정보를 확인하세요.

기타

사용자 이름과 선호 언어 (기본값)

스케줄러는 전체 이름과 사용자 기본값으로 사용할 선호 언어를 포함한 사용자의 공개 사용자 정보를 읽어요.

웹엑스 스케줄러 아키텍처 개요

Architecture diagram showing the Google cloud, Webex cloud, and the Google Calendar client, with numbered arrows linking them.
  1. 사이트 관리자가 사이트 관리 또는 컨트롤 허브를 사용하여 Google Workspace용 Webex 애드온을 활성화해요.

  2. 각 개인은 Google Workspace용 Webex 애드온에 대한 권한을 승인하고 (관리자가 승인하지 않는 경우) 자신의 구글 계정을 자신의 Webex 계정과 연결해요.

  3. 웹엑스는 구글의 캘린더 변경을 구독해요.

  4. 사용자가 Google 캘린더 이벤트에 Webex 미팅을 추가하거나, 시간 또는 주제를 업데이트하거나, 이벤트를 다른 날짜 및 시간에 복사해요.

  5. 웹엑스 애드온 클라이언트는 구글 캘린더 알림을 받고 웹엑스와 동기화돼요.

웹엑스 스케줄러에서 사용하는 구글 API들

아래 표는 웹엑스 스케줄러에서 사용하는 구글 API에 대한 정보를 제공해요.

대부분의 경우, 웹엑스 스케줄러는 구글 앱 스크립트 API를 사용해요. 몇 가지 경우에는 스케줄러가 구글 REST API를 사용해요. 일반적으로 구글 앱 스크립트 API는 관련된 구글 REST API를 래핑해요. 참조 URL 열은 가능한 경우 구글 앱 스크립트 API를 가리키지만 필요한 경우 구글 REST API 참조 URL을 참조할 수도 있어요.

테이블 2예요.웹엑스 스케줄러에서 사용하는 구글 앱 스크립트 API들

구글 앱 스크립트 API

그게 하는 일

참조 URL

캘린더요. ID 가져오기 

사용자 캘린더 ID 가져오기, 기본 캘린더 ID는 사용자 이메일 주소예요 

https://developers.google.com/apps-script/reference/calendar/calendar#getId ()

캘린더요. 이름 가져오기 

캘린더 이름 가져와 

https://developers.google.com/apps-script/reference/calendar/calendar#getName ()

달력. 시간대 가져와 

달력 시간대 알아봐요. 

https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone ()

캘린더.이벤트.목록 

몇 가지 기준에 맞는 특정 이벤트를 검색해 보세요. 

https://developers.google.com/calendar/api/v3/reference/events/list

캘린더.이벤트.패치 

Webex 미팅 정보를 저장하기 위해 특정 이벤트 메타데이터를 업데이트하세요. 

https://developers.google.com/calendar/api/v3/reference/events/patch

캘린더/이벤트. 참석자들 

캘린더 참석자 액세스를 위한 속성이에요. 

https://developers.google.com/calendar/api/v3/reference/events#resource

캘린더/이벤트. 컨퍼런스 데이터 

이벤트 컨퍼런스 데이터에 접근하기 위한 속성들 

https://developers.google.com/calendar/api/v3/reference/events#resource

캘린더 이벤트. 제목 받기 

캘린더 이벤트 주제 알아봐요. 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle ()

캘린더 이벤트. 크리에이터 불러오기 

캘린더 이벤트 생성자 불러오기 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators ()

캘린더 이벤트. 시작 시간 받기 

이벤트 시작 시간 가져와 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime ()

캘린더 이벤트. 엔드 타임 가져와 

이벤트 종료 시간 불러오기 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime ()

캐시 서비스. 사용자 캐시 받기 

사용자 캐시를 가져와서 사용자 환경설정 불러와요. 

https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache ()

캐시요. 받기 

키로 특정 캐시 설정 가져오기 

https://developers.google.com/apps-script/reference/cache/cache#get(String)

캐시하세요. 넣어 

키로 특정 캐시 설정해 

https://developers.google.com/apps-script/reference/cache/cache#put(String,String)

컨퍼런스 데이터 서비스. 새 컨퍼런스 데이터 빌더 

웹엑스 미팅 정보 저장 및 표시를 위한 구글 전용 데이터 구조를 만들어주세요. 

https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder ()

컨퍼런스 데이터 빌더. 빌드 

웹엑스 미팅 정보 데이터 생성해요 

https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build ()

지메일 앱. ID로 메시지 받기 

특정 Gmail 메시지 검색해 

https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)

지메일 앱. 초안 만들기 

웹엑스 이메일 본문을 포함하는 Gmail 메시지 생성하세요. 

https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)

지메일 메시지예요. GETFROM 

지메일 발신자 이메일 받기 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom ()

지메일메시지. 겟토 

가밀 리시버 가져와 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo ()

지메일메시지. 제목 가져오기 

지메일 메시지 제목 받기 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject ()

지메일 메시지. 날짜 받기 

Gmail 메시지 받기 날짜 및 시간 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate ()

속성 서비스. 사용자 속성 가져오기 

영구 사용자 환경설정 또는 설정에 액세스하세요. 

https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties ()

속성. 재산 가져오기 

키로 특정 속성 가져오기 

https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)

속성. 속성 설정 

키 및 값에 새 속성 설정하세요. 

https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)

세션. 유효 사용자 가져오기 (). 이메일 받기 

현재 사용자 이메일 받기 

https://developers.google.com/apps-script/reference/base/user#getEmail ()

스크립트 앱. 뉴 트리거 

이벤트 업데이트 처리하기 위해 새 트리거 설정해 

https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)

URLFETCHAP. Fetch 

이 API를 사용하여 Webex 애드인 서비스 또는 구글 API를 호출하여 미팅을 생성/업데이트하세요. 다른 타사 서비스는 호출하지 않아요. 

https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

테이블 3이에요.웹엑스 스케줄러에서 사용하는 구글 REST API들

구글 레스트 API

그게 하는 일

참조 URL

포스트 https://accounts.google.com/o/oauth2/token

구글 인증 토큰 받아요

https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code

겟 https://www.googleapis.com/admin/directory/v1/users/{userKey}

구성된 사용자 Webex 사이트 가져오기

https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get

자주 묻는 질문들

Webex는 통합을 어떻게 보호하나요?

애드온은 Google 클라우드 플랫폼 서버에서 실행되며, Webex 백엔드에 저장되고 예약된 미팅 종료 후 삭제되는 Webex 미팅 정보 (제목, 초대자 목록) 를 제외하고 구글 데이터는 저장되지 않아요.

https://help.webex.com/ituhp0 봐요.

이번 통합에서 “가져온” 고객 데이터를 어떻게 보호할 수 있나요?

우리는 필요한 데이터만 수집하고 필요한 기간 동안만 저장해요.

우리는 Webex 미팅 정보를 수집하여 Webex 클라우드에 저장해요. 일정 기간이 지나면 미팅 정보를 삭제하는데, 이는 귀하가 Webex 보존 정책으로 관리할 수 있어요.

Google 서비스에 연결하기 위해 공개 API나 사설 API를 사용해요?

애드온은 Google 클라우드 플랫폼에서 실행되고 구글 내장 라이브러리에 직접 액세스할 수 있어요.

https://developers.google.com/apps-script/overview 봐요.

이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?