Google Workspace Events API 범위 선택

이 문서에는 Google Workspace Events API 관련 승인 및 인증 정보 이 문서를 읽기 전에 다음 내용을 읽어 보시기 바랍니다. Google Workspace의 일반적인 인증 및 승인 정보는 인증 및 승인에 대해 알아보기

승인을 위해 OAuth 2.0 구성

OAuth 동의 화면 구성 및 범위 선택 사용자와 앱 검토자에게 표시되는 정보를 정의하고 나중에 게시할 수 있습니다.

Google Workspace Events API 범위

앱에 부여되는 액세스 수준을 정의하려면 승인 범위 선언 승인 범위는 OAuth 2.0 URI 문자열입니다. 여기에는 Google Workspace 앱 이름, 액세스하는 데이터 종류, 액세스할 수 있습니다 범위는 다음과 같은 Google Workspace 데이터를 사용하기 위한 앱의 요청입니다. 사용자 Google 계정 데이터

앱이 설치되면 사용자에게 사용된 범위의 유효성을 검사하라는 메시지가 표시됩니다. 있습니다. 일반적으로 가장 좁게 포커스가 맞춰진 범위를 선택해야 합니다. 앱에 필요하지 않은 범위를 요청하지 마세요. 사용자 증가 명확하게 설명된 제한적이고 명확한 범위에 대한 액세스 권한을 쉽게 부여할 수 있습니다.

가능하면 파일별로 부여되므로 민감하지 않은 범위를 사용하는 것이 좋습니다. 앱에 필요한 특정 기능에 대한 액세스 범위를 좁히고 액세스 범위를 좁힙니다.

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 앱에서 채팅을 보고 메시지를 보낼 수 있도록 허용합니다. 제공 Chat 앱에서 사용할 수 있는 모든 기능에 액세스할 수 있습니다. <ph type="x-smartling-placeholder"> 민감하지 않음
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 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 확인

특정 OAuth 범위를 사용하려면 앱이 Google의 OAuth 인증 절차에 따라 다릅니다. OAuth API 확인 읽기 FAQ 앱이 인증을 거쳐야 하는 시점과 인증의 유형을 확인이 필요합니다. Google Drive 추가 약관 서비스를 제공합니다.

필수 인증 유형

이 섹션에서는 필수 또는 지원되는 인증 유형을 설명합니다. 사이트의 각 메서드에 지원되는 범위를 제공합니다. Google Workspace Events API.

Google Chat 이벤트 구독의 경우 Google Workspace Events API 사용자 인증 및 앱 인증을 모두 지원하여 해당 메서드를 호출할 수 있습니다. 만약 API가 메서드는 호출에 사용된 사용자 인증 정보 유형인 두 사용자 인증 정보를 모두 지원합니다. 반환되는 결과에 영향을 줍니다. 예를 들어 subscriptions.list() 드림 메서드를 사용하면 API는 사용자가 제출한 구독 정보를 인증된 사용자가 액세스할 수 있습니다. 앱 인증을 사용하는 경우 API는 이 액세스할 수 있는 정기 결제 목록을 반환합니다. 자세히 알아보려면 Chat 인증 유형에 대해 자세히 알아보려면 인증 및 승인하기를 참고하세요. 채팅 앱 및 Google Chat API 요청을 참조하세요.

다음 표에는 각 Google Workspace Events API에 인증이 필요하거나 지원됩니다. 메서드를 사용하여 축소하도록 요청합니다.

메서드 사용자 인증 필요 또는 지원됨 앱 인증 지원 (Google Chat 앱만 해당) 승인 범위 지원됨
정기 결제 만들기

각 이벤트 유형에 지원되는 범위가 필요합니다.

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
구독하기 사용자 인증을 사용하면 이 메서드에 구독에 대해 하나 이상의 이벤트 유형을 지원하는 범위가 필요합니다.

앱 인증 사용 (Google Chat 앱만 해당):

  • chat.bot
구독 나열 사용자 인증을 사용하면 이 메서드에 구독에 대해 하나 이상의 이벤트 유형을 지원하는 범위가 필요합니다.

앱 인증 사용 (Google Chat 앱만 해당):

  • chat.bot
정기 결제 업데이트

각 이벤트 유형에 지원되는 범위가 필요합니다.

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
정기 결제 재활성화하기

각 이벤트 유형에 지원되는 범위가 필요합니다.

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • meetings.space.created
  • meetings.space.readonly
구독 삭제하기 사용자 인증을 사용하면 이 메서드에 구독에 대해 하나 이상의 이벤트 유형을 지원하는 범위가 필요합니다.

앱 인증 사용 (Google Chat 앱만 해당):

  • chat.bot

이벤트 유형별 범위

사용자 인증을 사용하여 Google Workspace Events API를 호출할 때 는 구독하세요.

다음 표에는 각각에 지원되는 승인 범위가 나와 있습니다. 이벤트 유형:

이벤트 이벤트 유형 승인 범위 지원됨
Google Chat  
메시지가 게시되거나 업데이트됩니다.
  • google.workspace.chat.message.v1.created
  • google.workspace.chat.message.v1.updated
  • chat.messages
  • chat.messages.readonly
반응이 추가 또는 삭제되거나 여러 반응이 변경됩니다.
  • google.workspace.chat.reaction.v1.created
  • google.workspace.chat.reaction.v1.deleted
  • google.workspace.chat.reaction.v1.batchChanged
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.messages
  • chat.messages.readonly
멤버십 멤버십이 생성, 업데이트 또는 삭제되거나 여러 개의 멤버십이 생성된 경우 확인할 수 있습니다
  • google.workspace.chat.membership.v1.created
  • google.workspace.chat.membership.v1.updated
  • google.workspace.chat.membership.v1.deleted
  • google.workspace.chat.membership.v1.batchChanged
  • chat.memberships
  • chat.memberships.readonly
스페이스는 업데이트되거나 삭제됩니다.
  • google.workspace.chat.space.v1.updated
  • google.workspace.chat.space.v1.deleted
  • chat.spaces
  • chat.spaces.readonly
Google Meet  
회의가 시작되거나 종료됩니다.
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended
  • meetings.space.created
  • meetings.space.readonly
참여자가 회의에 참여하거나 회의에서 나갑니다.
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left
  • meetings.space.created
  • meetings.space.readonly
녹음이 생성되었습니다.
  • google.workspace.meet.recording.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly
스크립트가 생성되었습니다.
  • google.workspace.meet.transcript.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly