이 문서에는 Google Workspace Events API 관련 승인 및 인증 정보가 포함되어 있습니다. 이 문서를 읽기 전에 인증 및 승인 알아보기에서 Google Workspace의 일반적인 인증 및 승인 정보를 읽어보세요.
승인을 위해 OAuth 2.0 구성
OAuth 동의 화면 구성 및 범위 선택을 통해 사용자 및 앱 검토자에게 표시되는 정보를 정의하고 나중에 게시할 수 있도록 앱을 등록합니다.
Google Workspace Events API 범위
앱에 부여된 액세스 수준을 정의하려면 승인 범위를 식별하고 선언해야 합니다. 승인 범위는 Google Workspace 앱 이름, 액세스하는 데이터 종류, 액세스 수준을 포함하는 OAuth 2.0 URI 문자열입니다. 범위는 사용자의 Google 계정 데이터를 비롯한 Google Workspace 데이터와 상호작용하기 위한 앱의 요청입니다.
앱이 설치되면 사용자에게 앱에서 사용하는 범위를 확인하라는 메시지가 표시됩니다. 일반적으로 가능한 한 가장 좁은 범위를 선택하고 앱에 필요하지 않은 범위는 요청하지 않아야 합니다. 사용자는 제한적이고 명확하게 설명된 범위에 더 쉽게 액세스 권한을 부여합니다.
가능한 경우 비민감한 범위를 사용하는 것이 좋습니다. 파일별 액세스 권한을 부여하고 앱에 필요한 특정 기능에 대한 액세스를 제한하기 때문입니다.
Google Workspace Events API는 구독을 지원하는 Google Workspace 애플리케이션의 범위를 사용합니다. 앱에서 이미 구독에 필요한 범위를 사용하고 있다면 Google Workspace Events API를 사용하기 위해 추가 범위를 추가할 필요가 없습니다.
다음 표에는 Google Workspace Events API에서 지원되는 범위가 표시되어 있습니다.
| 범위 코드 | 설명 | 사용 | ||
|---|---|---|---|---|
| Google Chat | ||||
https://www.googleapis.com/auth/chat.bot |
Google Chat 앱이 채팅을 보고 메시지를 보낼 수 있도록 허용합니다. 채팅 앱에서 사용할 수 있는 모든 기능에 대한 액세스 권한을 부여합니다. | 민감하지 않음 | ||
https://www.googleapis.com/auth/chat.memberships |
Google Chat 대화에서 참여자를 확인, 추가, 삭제합니다. | 민감함 |
||
https://www.googleapis.com/auth/chat.memberships.readonly |
Google Chat 대화에서 참여자를 봅니다. | 민감함 |
||
https://www.googleapis.com/auth/chat.spaces |
Google Chat에서 대화 및 스페이스를 만들고 메타데이터 (기록 설정 포함)를 보거나 업데이트합니다. | 민감한 콘텐츠 | ||
https://www.googleapis.com/auth/chat.spaces.readonly |
Google Chat에서 채팅 및 스페이스를 확인합니다. | 민감함 |
||
https://www.googleapis.com/auth/chat.messages.reaction초 |
Chat에서 메시지에 대한 반응 보기, 추가, 삭제 | 민감함 |
||
https://www.googleapis.com/auth/chat.messages.reactions.readonly |
Chat에서 메시지에 대한 반응을 확인합니다. | 민감함 |
||
https://www.googleapis.com/auth/chat.messages |
메시지를 확인, 작성, 전송, 업데이트, 삭제하고, 메시지에 대한 반응을 추가, 확인, 삭제합니다. | 제한됨 | ||
https://www.googleapis.com/auth/chat.messages.readonly |
Google Chat에서 메시지와 반응을 확인합니다. | 제한됨 |
||
| Google Drive | ||||
https://www.googleapis.com/auth/drive.file |
Google Picker API 또는 앱의 파일 선택기를 사용하는 동안 앱으로 열거나 사용자가 앱과 공유하는 새 Drive 파일을 만들거나 기존 파일을 수정합니다. | 민감하지 않음 | ||
https://www.googleapis.com/auth/drive |
모든 Drive 파일을 보고 관리합니다. | 제한됨 | ||
https://www.googleapis.com/auth/drive.readonly |
모든 Drive 파일을 보고 다운로드합니다. | 제한됨 | ||
https://www.googleapis.com/auth/drive.metadata |
Drive에 있는 파일의 메타데이터를 보고 관리합니다. | 제한됨 | ||
https://www.googleapis.com/auth/drive.metadata.readonly |
Drive에서 파일의 메타데이터를 볼 수 있습니다. | 제한됨 | ||
| Google Meet | ||||
https://www.googleapis.com/auth/meetings.space.created |
앱이 앱에서 만든 회의 공간에 관한 메타데이터를 만들고, 수정하고, 읽도록 허용합니다. | 민감함 |
||
https://www.googleapis.com/auth/meetings.space.readonly |
앱이 사용자가 액세스할 수 있는 모든 회의실에 관한 메타데이터를 읽도록 허용 | 민감함 |
||
위 표의 사용 열은 다음 정의에 따라 각 범위의 민감도를 나타냅니다.
민감하지 않음: 이러한 범위는 가장 작은 승인 액세스 범위를 제공하며 기본 앱 인증만 필요합니다. 이 요구사항에 관한 자세한 내용은 인증 요구사항을 참고하세요.
민감함: 이러한 범위는 사용자가 앱에 대해 승인한 특정 Google 사용자 데이터에 대한 액세스를 제공합니다. 추가 앱 인증을 거쳐야 합니다. 이 요구사항에 대한 자세한 내용은 민감한 범위 및 제한된 범위 요구사항을 참고하세요.
제한됨: 이러한 범위는 Google 사용자 데이터에 대한 광범위한 액세스를 제공하며 제한된 범위 확인 절차를 거쳐야 합니다. 이 요구사항에 관한 자세한 내용은 Google API 서비스: 사용자 데이터 정책 및 특정 API 범위의 추가 요구사항을 참고하세요. 제한된 범위 데이터를 서버에 저장하거나 전송하는 경우 보안 평가를 거쳐야 합니다.
앱에 다른 Google API에 대한 액세스 권한이 필요한 경우 해당 범위도 추가할 수 있습니다. Google API 범위에 대한 자세한 내용은 OAuth 2.0을 사용하여 Google API에 액세스하기를 참고하세요.
특정 OAuth 2.0 범위에 대한 자세한 내용은 Google API의 OAuth 2.0 범위를 참고하세요.
OAuth 확인
특정 OAuth 범위를 사용하려면 앱이 OAuth 앱 인증 고객센터를 거쳐야 할 수 있습니다. OAuth 앱 FAQ를 읽고 앱이 인증을 거쳐야 하는 시점과 필요한 인증 유형을 확인하세요. Google Drive 서비스 약관도 참고하세요.
필수 인증 유형
이 섹션에서는 필요하거나 지원되는 인증 유형을 설명하고 Google Workspace Events API의 각 메서드에 지원되는 범위를 제공합니다.
Google Chat 이벤트 구독의 경우 Google Workspace Events API는 일부 메서드를 호출하기 위해 사용자 인증과 앱 인증을 모두 지원합니다. API 메서드가 두 사용자 인증 정보를 모두 지원하는 경우 호출에 사용된 사용자 인증 정보의 유형이 반환되는 결과에 영향을 미칩니다. 예를 들어 사용자 인증으로 subscriptions.list 메서드를 호출하면 API는 인증된 사용자가 액세스할 수 있는 정기 결제 목록을 반환합니다. 앱 인증을 사용하는 경우 API는 앱이 액세스할 수 있는 정기 결제 목록을 반환합니다. Chat 인증 유형에 대해 자세히 알아보려면 Chat 앱 및 Google Chat API 요청 인증 및 승인하기를 참고하세요.
다음 표에는 각 Google Workspace Events API 메서드에 필요한 또는 지원되는 범위와 인증 유형이 표시되어 있습니다.
| 메서드 | 사용자 인증 필요 또는 지원 | 앱 인증 지원 (Google Chat 앱만 해당) | 지원되는 승인 범위 | |
|---|---|---|---|---|
| 정기 결제 만들기 | — |
각 이벤트 유형에 지원되는 범위가 필요합니다.
|
||
| 구독하기 |
사용자 인증을 사용하는 경우 이 메서드에는 구독에 대해 하나 이상의 이벤트 유형을 지원하는 범위가 필요합니다.
앱 인증 (Google Chat 앱만 해당):
|
|||
| 구독 나열 |
사용자 인증을 사용하는 경우 이 메서드에는 구독에 대해 하나 이상의 이벤트 유형을 지원하는 범위가 필요합니다.
앱 인증 (Google Chat 앱만 해당):
|
|||
| 구독 업데이트하기 | — |
각 이벤트 유형에 지원되는 범위가 필요합니다.
|
||
| 구독 재활성화 | — |
각 이벤트 유형에 지원되는 범위가 필요합니다.
|
||
| 구독 삭제하기 |
사용자 인증을 사용하는 경우 이 메서드에는 구독에 대해 하나 이상의 이벤트 유형을 지원하는 범위가 필요합니다.
앱 인증 (Google Chat 앱만 해당):
|
|||
이벤트 유형별 범위
사용자 인증을 사용하여 Google Workspace Events API를 호출할 때는 구독의 이벤트 유형에 해당하는 하나 이상의 범위를 지정해야 합니다.
다음 표에는 각 이벤트 유형에 지원되는 승인 범위가 표시되어 있습니다.
| 이벤트 | 이벤트 유형 | 지원되는 승인 범위 | ||||||
|---|---|---|---|---|---|---|---|---|
| Google Chat | ||||||||
| 메시지가 게시되거나 업데이트됩니다. |
|
|
||||||
| 리액션이 추가 또는 삭제되거나 여러 리액션이 변경됩니다. |
|
|
||||||
| 멤버십이 생성, 업데이트 또는 삭제되거나 여러 멤버십이 변경됩니다. |
|
|
||||||
| 스페이스가 업데이트되거나 삭제됩니다. |
|
|
||||||
| Google Drive | ||||||||
| 파일이 생성, 변경, 이동, 삭제, 휴지통으로 이동 또는 휴지통에서 삭제됩니다. |
|
|
||||||
| 파일에서 액세스 제안이 생성되거나 해결됩니다. |
|
|
||||||
| Google Meet | ||||||||
| 컨퍼런스가 시작되거나 종료됩니다. |
|
|
||||||
| 참여자가 회의에 참여하거나 회의에서 나갑니다. |
|
|
||||||
| 녹화 파일이 생성되었습니다. |
|
|
||||||
| 스크립트가 생성되었습니다. |
|
|
||||||