구글 Workspace API 사용법

Google 클라우드 플로젝트 생성

구글 클라우드 프로젝트 생성 후 Google Workspace API 사용 설정한다.

 

원하는 API를 사용 설정을 클릭한다.

그 후 사용자 인증 정보를 설정한다.

API 인증 및 승인 단계

1. Google Cloud 프로젝트 및 앱 구성
2. 액세스 할 수 있도록 앱 인증
3. 리소스 요청
4. 사용자 동의 요청
5. 승인된 리소스 요청 전송
6. Google에서 액세스 토큰 반환
7. 요청된 리소스 액세스
8. refresh token 가져오기(선택사항)
9. 추가 리소스 요청

중요 용어

인증

• 사용자 인증: 사용자가 앱에 로그인 하는 작업으로 Google 계정으로 로그인하여 앱에 통합할 수 있다.
• 앱 인증: 앱을 실행하는 사용자를 대신하여 앱이 google 서비스에 직접 인증하며 사전 생성된 사용자 인증 정보를 사용한다.

승인

Google에서 데이터에 액세스하거나 작업을 실행하는데 사용되는 액세스 토큰을 가져온다.

사용자 인증 정보

소프트웨어 보안에 사용되는 식별 수단이다.

• API 키: 공개 데이터에 대한 액세스를 요청하는데 사용되는 사용자 인증정보이다.
• OAuth2 클라이언트 ID: 사용자 소유 데이터에 대한 액세스를 요청하는데 사용되는 사용자 인증정보이다.
• 클라이언트 보안 비밀번호: 애플리케이션과 승인 서버에서만 알고 있어야 하는 문자열이다.
• 서비스 계정 키: Google 서비스에서 승인을 받는 서비스 계정에서 사용된다.
• 서비스 계정: 일부 데이터에 액세스하거나 일부 작업을 처리하는 프로세스로 실행되는 얼굴 없는 앱과 같이 서버간 상호작용에 사용되는 사용자 인증정보이다.

범위

앱에 부여된 리소스 또는 작업의 액세스 수준을 정의하는 OAuth 2.0 URI 문자열이다. 사용자는 요청된 범위를 검토하고 부여할 액세스 권한을 선택가능하고, Google의 인증서버가 액세스 토큰으로 허용된 범위를 앱에 반환한다.

인증서버

액세스 토큰을 사용하여 앱의 요청된 데이터 및 작업에 대한 액세스 권한을 부여하는 Google 서버이다.

승인 코드

액세스 토큰을 얻기 위해 사용된 승인 서버에서 전송된 코드이다. 애플리케이션 유형이 웹 서버 앱 또는 설치된 앱인 경우에만 코드가 필요하다.

액세스 토큰

Google Workspace API에 대한 액세스 권한을 부여하는 토큰이다.

리소스 서버

앱에서 호출하려는 API를 호스팅하는 서버이다.

주구성원

리소스에 대한 액세스 권한을 부여할 수 있는 항목('ID')이다.

데이터 유형

앱이 액세스하려는 데이터가 있는 항목이다.

• 공개 도메인 데이터: 누구나 액세스 할 수 있는 데이터로, 일반적으로 API키를 사용하여 액세스된다.
• 최종 사용자 데이터: OAuth2 클라이언트 ID 또는 서비스 계정을 사용하여 액세스한다.
• 클라우드 데이터: Google Cloud 프로젝트에서 소유한 데이터이다. 일반적으로 서비스 계정에서 액세스한다.

사용자 동의

앱 사용자가 사용자 대신 데이터에 액세스하고 작업을 수행하도록 승인하는 승인 단계

애플리케이션 유형

만들려는 앱 유형

OAuth 동의 화면 구성

OAuth 동의 화면으로 이동 후 만들기

 

액세스 사용자 인증 정보 만들기

API키 사용자 인증 정보

공개적으로 사용 가능한 데이터에 익명으로 액세스 하는데 사용된다.

사용자 인증 정보로 이동후 사용자 인증 정보 만들기 -> API키를 클릭한다.

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

최종 사용자로 인증하고 앱의 사용자 데이터에 액세스한다. 클라이언트 ID는 Google OAuth 서버에서 단일 앱을 식별하는데 사용된다.

사용자 인증 정보로 이동후 사용자 인증 정보 만들기 -> OAuth 클라이언트 ID를 클릭한다.
애플리케이션 유형 -> 웹 애플리케이션 클릭 한다.
앱과 관련된 URI를 추가한다.

이 후 Google Workspace를 사용 가능하다.

 

 

출처:Google Workspace에서 개발