IT 관련/유틸리티

Google API를 사용하기 위한 OAuth 2.0 클라이언트 ID를 발급하는 방법

islet2 2025. 3. 12. 20:20

1. Google Cloud Platform (GCP) 프로젝트 생성 또는 선택:

  • GCP 콘솔 접속: https://console.cloud.google.com/ 에 접속합니다.
  • 프로젝트 선택 또는 생성:
    • 기존 프로젝트를 사용하려면 상단에서 프로젝트를 선택합니다.
    • 새 프로젝트를 만들려면 "프로젝트 선택" 옆의 드롭다운 메뉴에서 "새 프로젝트"를 클릭합니다. 프로젝트 이름과 조직 (선택 사항)을 입력하고 "만들기"를 클릭합니다.

2. Sheets API 활성화:

  • API 및 서비스 검색: GCP 콘솔에서 검색창에 "Sheets API"를 입력하고 검색합니다.
  • API 활성화: "Google Sheets API"를 클릭하고 "사용" 버튼을 클릭하여 API를 활성화합니다.

3. OAuth 2.0 자격 증명 구성:

  • 자격 증명 페이지로 이동: GCP 콘솔에서 왼쪽 메뉴에서 "API 및 서비스" -> "Oauth 동의화면"을 클릭합니다.
  • 자격 증명 만들기: "+ 자격 증명 만들기" 버튼을 클릭하고 "OAuth 클라이언트 ID"를 선택합니다.
  • 애플리케이션 유형 선택: 애플리케이션 유형을 선택합니다. (예: 웹 애플리케이션, 데스크톱 앱, Android, iOS)
    • 웹 애플리케이션: 서버 측 웹 애플리케이션에 적합합니다.
    • 데스크톱 앱: 로컬에서 실행되는 데스크톱 애플리케이션에 적합합니다.
    • Android/iOS: 모바일 애플리케이션에 적합합니다.
  • 세부 정보 입력: 선택한 애플리케이션 유형에 따라 필요한 정보를 입력합니다.
    • 이름: 클라이언트 ID의 이름을 지정합니다.
    • 승인된 JavaScript 원본 (웹 애플리케이션): 애플리케이션이 실행되는 URL을 입력합니다 (예: http://localhost:3000 또는 실제 배포된 URL). 개발 중에는 http://localhost:<포트번호>를 사용할 수 있습니다.
    • 승인된 리디렉션 URI (웹 애플리케이션): 인증 후 Google이 사용자를 리디렉션할 URL을 입력합니다. 일반적으로 /oauth2callback 또는 유사한 경로를 사용합니다 (예: http://localhost:3000/oauth2callback). 이 URL은 애플리케이션에서 OAuth 응답을 처리하는 엔드포인트여야 합니다.
  • 만들기: 필요한 정보를 입력한 후 "만들기" 버튼을 클릭합니다.

4. 클라이언트 ID 및 클라이언트 Secret 저장:

  • 생성된 OAuth 클라이언트 ID와 클라이언트 Secret이 표시됩니다. 이 정보는 매우 중요하므로 안전하게 저장해야 합니다. 나중에 애플리케이션에서 Google Sheets API에 액세스하는 데 사용됩니다.

5. 애플리케이션에 OAuth 2.0 적용:

  • 이제 클라이언트 ID와 클라이언트 Secret을 사용하여 애플리케이션에서 OAuth 2.0 인증 흐름을 구현할 수 있습니다. 사용자가 Google 계정으로 로그인하고 애플리케이션에 Google Sheets에 대한 액세스 권한을 부여하도록 안내해야 합니다. 일반적인 흐름은 다음과 같습니다.
    1. 애플리케이션이 사용자를 Google의 인증 URL로 리디렉션합니다.
    2. 사용자가 Google 계정으로 로그인하고 권한을 부여합니다.
    3. Google이 사용자를 애플리케이션의 승인된 리디렉션 URI로 리디렉션합니다. 여기에는 인증 코드 (authorization code)가 포함됩니다.
    4. 애플리케이션이 인증 코드를 사용하여 액세스 토큰 (access token)과 갱신 토큰 (refresh token)을 얻기 위해 Google의 토큰 엔드포인트에 요청합니다.
    5. 액세스 토큰을 사용하여 Google Sheets API에 액세스합니다. 액세스 토큰이 만료되면 갱신 토큰을 사용하여 새 액세스 토큰을 얻습니다.
  • 클라이언트 ID 및 클라이언트 Secret 키는 google gmail, google drive등 구글 서비스 전반에 사용이 가능합니다. 그전에 https://console.cloud.google.com/ 에서 각 서비스별 api 사용을 클릭해줘야 합니다.