[Google API] 구글 API 발급받기 | Gmail API 발급받기 | Google Cloud Platform(GCP)

안녕하세요! 오랜만입니다

구글 API를 활용할 일이 생겨서 이번에 처음으로 API를 발급하는데 기록하면 좋을거 같아서 블로그 글로 한번 남겨보려고 합니다.

일단 처음으로 아래의 사이트에 접속하여 구글 로그인을 해줍니다.

https://console.cloud.google.com 

Google 클라우드 플랫폼

 

저는 이렇게 뜨는데요, 제가 모르는 사이에 프로젝트를 만들었던 적이 있는거 같습니다.

아니면 원래 이렇게 뜨는건지는 ? 모르겠지만 말입니다.

일단 작업 중인 프로젝트 : My First Project로 되어있는 곳을 클릭해줍니다.

반응형

그럼 이런식으로 뜨는데요, 새 프로젝트를 클릭해주시면 됩니다.

 

프로젝트 이름을 설정해주시구요.

여기서 프로젝트 선택을 누르면 제가 만든 프로젝트로 홈 화면이 바뀌는 걸 알 수 있습니다.

왼쪽 메뉴 → API 및 서비스 → 라이브러리 선택합니다. 이후에 사용하려는 API 검색 (예: Google Maps API, YouTube Data API, Drive API 등)하시면 되는데, 저는 Gmail API가 필요해서 Gmail를 찾아서 활성화 시켜주겠습니다.

예시로 다른 Google API에 대해 간단하게 설명드리겠습니다.

예시 API 목록:

• Google Maps JavaScript API: 지도 표시
• YouTube Data API v3: 유튜브 데이터 조회
• Google Drive API: 드라이브 파일 관리
• Google Calendar API: 캘린더 이벤트 관리

이런식으로 사용 버튼을 누르면 사용 활성화가 됩니다.

이제 API 키 생성 (간단한 인증)을 해야합니다.

왼쪽 메뉴 → API 및 서비스 → 사용자 인증 정보 → 사용자 인증 정보 만들기 → API 키 를 누릅니다.

생성된 API 키를 복사해 안전한 곳에 보관합니다.
⚠️ API 키는 공개되면 악용될 수 있으므로 반드시 제한을 설정해야 합니다.

• API 제한 → 키 제한 선택.
• 사용 가능한 API에서 활성화한 API만 허용

저는 Gmail API에서만 가능하게 허용하였습니다.

 

그 다음에는 OAuth 클라이언트 ID 생성 (사용자 데이터 접근 시) 를 해야합니다.

• 사용자 유형 선택 (외부 또는 내부).
• 앱 이름, 사용자 지원 이메일 등 필수 정보 입력 → 저장 후 계속.

• 왼쪽 메뉴 → API 및 서비스 → 사용자 인증 정보 → 사용자 인증 정보 만들기 → OAuth 클라이언트 ID 이걸 눌러주시는데

일단 웹으로 선택합니다. 그러면 오른쪽 사진처럼 URI를 추가해야하는데, 브라우저 기반 요청을 처리할 때, 요청이 허용된 출처(원본, Origin)에서만 오도록 제한하기 위한 설정입니다.

저는 이걸 따로 배포할 생각이 없기 때문에 http://localhost:3000 / http://localhost:3000/callback를 넣어줍니다.

그럼 이렇게 ID와 보안 비밀번호가 뜨게 되는데 클립보드에 복사해서 따로 저장해줍니다. 아니면 JSON 파일로 다운로드 버튼을 눌러 파일을 저장해 둡니다.

 

이렇게 하면 API 발급이 완료되었습니다!

---

테스트 및 문제 해결

1. API 테스트
   • Google APIs Explorer (https://developers.google.com/apis-explorer)에서 실시간 테스트 가능.
   • Postman 또는 curl 명령어로 간단히 확인.
2. 에러 대응
   • 403 에러: API 키 제한, 할당량 초과, 결제 계정 문제.
   • 401 에러: OAuth 토큰 만료 또는 권한 부족.

---

문제 해결에 대한 방법입니다.

다음번에는 제가 gmail로 어떤 일을 하려고 하는지 개발 일지를 한번 써보겠습니다.

감사합니다!