[Dalmuri] Java로 Google Cloud Nature Language API 호출해서 감정 다이어리 만들기

🥵API 연결 후기 : 코드 짜는것보다 초기 세팅이 훨씬 더 어렵다..

 

여럽다기보단 방법도 많고 읽어야 하는 공식 문서도 많아서, 정작 내가 원하거나 필요한 정보를 찾는데 더 시간이 오래 걸린 것 같다. 

난 그저 사용자 정보를 인증하고 싶을 뿐인데... 갑자기 냅다 파이썬을 설치하라.... 어쩌구..... 근데 뭘 또 더 설치하기엔 컴퓨터 용량이 너무 제한적이니까 설치하는것도 껄그러운 심정이다.

결국 공식 문서 찾는건 Gemini에게 물어봐서 찾았다. 출처까지 표기해주니까 너무 편하더라. ai 사용 안하고도 혼자서 공식문서 찾을 줄 알아야 할텐데... 구글 공식문서는 찾아서 읽고 실행하는 과정보다 필요한걸 찾는 과정이 정글같아서 더 힘들다.

 

❓왜 Google Cloud Nature Language API를 선택했는가?

사실 구글보다 훨씬 더 쉬워보이는 API웹사이트를 발견했다. 바로 맡김 API의 감성분석 API였다.

근데 포스트맨과 사이트에서 제공하는 데모 기능을 이용했는데...

??? 나한테 왜그러세요ㅠㅜㅜ

내가 포스트맨을 잘못 사용해서 에러가 발생했나? 싶기도 했고, 웹사이트에서 제공해주는 데모를 사용해도 에러가 나는건 매한가지라 문의를 드렸더니

저한테 왜그러세요

온세상이 내 개발공부를 막는 느낌이어서 다소 짜증이 났다

그래서 다른 감정분석 API를 찾다가 Google에서 제공하는걸 발견했던 것..

구글에서 제공하는 API 공식문서 읽고 구현하는것도 개발 공부에 도움 될 것 같아서 사용했다.

 

❓왜 Java에서 구현하였는가?

내 프로젝트의 프론트단이 Vite + React였던 것이다

Node.js를 깔았기 때문에 프론트에서도 서버를 호출할 수 있나? 기대를 했었는데, 시도해보니 안됬다.

결국 백엔드 서버에서 API 호출을 작성하는게 더 바람직하다고 생각해서 백단인 Java + Spring 패키지에서 작성했다.

나야 뭐 Java에서 구현하는게 더 편하니까 좋지만... 기왕이면 시도한 적 없었던 Node.js에서 구현해보고 싶었는데 살짝 아쉬웠다

 

❓어떻게 구현했는가?

참고 사이트는 여기

우선 구글에서 제공하는 의존성을 깔고 예시문을 그대로 작성하였다.

[의존성 추가]

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.68.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-language</artifactId>
  </dependency>
</dependencies>

[메소드 작성]

public ResponseEntity<DiaryResponseDTO> getDiaryScore(@RequestBody DiaryRequestDTO request) {
  DiaryResponseDTO response = new DiaryResponseDTO();
  try (LanguageServiceClient language = LanguageServiceClient.create()) {
    String text = request.getText(); 
    Document doc = Document.newBuilder() // Google Cloud Natural Language API에 넘겨줄 Document 객체 생성
		.setContent(text)  // 분석할 실제 텍스트 설정
		.setType(Type.PLAIN_TEXT)  // 분석 대상이 일반 텍스트임을 지정
		.build();  // 최종 Document 객체 생성
	Sentiment sentiment = language
        .analyzeSentiment(doc)  // Google Cloud에 감정 분석 요청, 텍스트의 감정을 분석해서 점수 반환
		.getDocumentSentiment();  // 문서 전체에 대한 평균 감정 점수(Sentiment)를 가져옴

	response.setScore(sentiment.getScore());
	response.setMagnitude(sentiment.getMagnitude());

	return ResponseEntity.ok(response);

  } catch (Exception e) {
    e.printStackTrace();
	System.err.println("Google Cloud API 호출 중 예외 발생: " + e.getMessage());

	return ResponseEntity.badRequest().build();
  }
}

이대로 작성하고 다시 실행해봤더니...

java.io.IOException: Your default credentials were not found. 
To set up Application Default Credentials for your environment, 
see https://cloud.google.com/docs/authentication/external/set-up-adc.
at cohttp://m.google.auth.oauth2.DefaultCredentialsProvider.getDefaultCredentials(DefaultCredentialsProvider.java:127)
... 생략
Google Cloud API 호출 중 예외 발생: 
Your default credentials were not found. 
To set up Application Default Credentials for your environment, 
see https://cloud.google.com/docs/authentication/external/set-up-adc.

뭐 이런 에러가 뜬다....

찾아보니 역시나 예상대로 ADC(Application Default Credentials)를 설정하지 않아서 그렇다.

그래서 ADC 설정 방법 찾아보다가 gcloud CLI 설치를 해야하고.. 그거 설치하려면 파이썬 깔아서 환경변수 설정해야하고... 포기할까 싶던 찰나 Gemini친구에게 물어봐서 방법을 겨우 찾았다.

 

개인적으로 느끼기엔 여태껏 본 ADC 설정 방법 중 가장 간편해서 이 방법을 사용했다. 

설정 문서는 여기 참고할 것 

대신 구글 계정으로 해야하는 초기 세팅이 좀 복잡하다.

 

[이건 Gemini 설명]

네, Google Cloud API를 사용하기 위해 서비스 계정 키 파일을 환경 변수에 설정하는 방법에 대해 아주 자세하고 세밀하게 안내해 드리겠습니다. 이 방법은 Google Cloud에서 **ADC(Application Default Credentials)**를 설정하는 가장 확실한 방법입니다.

---

🔑 서비스 계정 키 파일 환경 변수 설정 상세 가이드

이 과정은 크게 ① GCP에서 키 파일 생성, ② 키 파일을 로컬에 다운로드, ③ 환경 변수 설정의 세 단계로 나뉩니다.

 

단계 1: GCP에서 서비스 계정 및 키 파일 생성

Google Cloud Platform 콘솔에서 API 호출 권한을 가진 전용 계정(서비스 계정)을 만들고, 그 인증서(키 파일)를 다운로드합니다.

1. Google Cloud Console 접속: [Google Cloud Console]에 접속하여 해당 프로젝트를 선택합니다.
2. 서비스 계정 페이지로 이동: 왼쪽 메뉴에서 IAM 및 관리자(IAM & Admin) > **서비스 계정(Service Accounts)**으로 이동합니다.
3. 새 서비스 계정 생성:
   • 서비스 계정 만들기를 클릭합니다.
   • 이름(예: nl-api-caller)을 지정하고 만듭니다.
4. 역할 부여 (가장 중요):
   • 이 서비스 계정에 프로젝트 액세스 권한 부여 단계에서 역할을 부여합니다.
   • 검색창에 "Cloud Natural Language API 사용자" 또는 **"Cloud Natural Language API User"**를 검색하여 선택하고 부여합니다. (이 역할이 API 호출 권한을 제공합니다.)
5. 키 생성 및 다운로드:
   • 서비스 계정이 생성된 후, 해당 계정을 클릭하여 상세 페이지로 이동합니다.
   • 키(Keys) 탭으로 이동합니다.
   • 키 추가 > 새 키 만들기를 클릭합니다.
   • 키 유형으로 JSON을 선택하고 만들기를 클릭합니다.
   • JSON 파일이 자동으로 로컬 컴퓨터에 다운로드됩니다. (예: my-project-xxxxxxxxxx.json)

---

단계 2: JSON 키 파일 안전하게 보관

다운로드한 JSON 파일은 곧 비밀번호와 같습니다. 이 파일을 외부에 노출하거나 Git 저장소에 올리면 절대 안 됩니다.

1. 파일 경로 확인: 다운로드한 JSON 파일을 Spring Boot 애플리케이션에 접근 가능한 안전한 위치로 옮깁니다.
   • 예시 경로: C:\Users\YourName\gcp-keys\my-project-xxxxxxxxxx.json
   • 예시 경로: /home/user/gcp-keys/my-project-xxxxxxxxxx.json
2. 파일 이름 복사: 파일의 전체 경로를 정확하게 복사해 둡니다.

---

단계 3: 환경 변수 GOOGLE_APPLICATION_CREDENTIALS 설정

이제 Spring Boot 애플리케이션을 실행할 때, Google Cloud 클라이언트 라이브러리가 이 키 파일의 경로를 알 수 있도록 환경 변수를 설정합니다.

이 환경 변수는 Spring 애플리케이션을 실행하는 바로 그 터미널 세션에서 설정해야 합니다.

 

🖥️ Windows (PowerShell/CMD)

1. PowerShell 또는 CMD를 엽니다.
2. 다음과 같이 환경 변수를 설정하고, 파일 경로를 본인의 실제 경로로 수정합니다.
3. PowerShell

    

   # PowerShell을 사용하는 경우 (권장)
   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\YourName\gcp-keys\my-project-xxxxxxxxxx.json"
   
   # CMD를 사용하는 경우
   set GOOGLE_APPLICATION_CREDENTIALS=C:\Users\YourName\gcp-keys\my-project-xxxxxxxxxx.json
   

4. 같은 터미널 세션에서 Spring Boot 애플리케이션을 실행합니다 (예: mvn spring-boot:run 또는 IDE에서 실행).

🐧 Linux / macOS (Bash/Zsh)

1. 터미널을 엽니다.
2. 다음과 같이 환경 변수를 설정하고, 파일 경로를 본인의 실제 경로로 수정합니다.
3. Bash

    

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/gcp-keys/my-project-xxxxxxxxxx.json"
   

4. 같은 터미널 세션에서 Spring Boot 애플리케이션을 실행합니다.

[이건 내설명]

 

1. 서비스 페이지 > IAM 및 관리자 > 서비스 계정 화면으로 이동

위와 같은 화면이 보여야 한다.

 

2. 서비스 계정을 만들고 역할 부여

참고로 역할 부여가 제일 중요한데, 난 안전하게 모든 권한이 있는 '소유자'로 지정하였다.

어차피 구글에서 설정한 프로젝트 사용자는 나 하나밖에 없기 때문이다

이건 상황에 따라 권한을 주면 좋을 듯 한데, 어쨌든 확실한건 API호출이 가능한 권한을 줘야 한다.

여기서 Cloud Natural Language API User권한을 찾아서 설정하라는데, 도저히 못찾겠어서 그냥 '소유자'로 지정했다. 어차피 나만 쓰는 프로젝트니까 어떤 구성원이든 권한은 상관 없으니까....이건 알게되면 나중에 정리하겠다.

어쨌든 서비스 계정을 만들면 key를 발급받을 준비가 된거다. 

 

3. 키 발급

서비스 계정 옆에 키 탭이 있는데 그거 클릭한다.

그럼 위와 같은 화면이 나온다.

여기서 

새 키 만들기 선택 후

저런 화면이 뜨는데, 저기서 'json'을 선택한다. 

그럼 자동으로 다운로드가 되어지고, 파일을 열면

저런식으로 json형태의 파일을 볼 수 있다.

참고로 이 파일은 잃어버리면 절대절대절대절대절대안된다!!!!!!!!!!!

 

3. 파일을 프로젝트 외부에 위치

참고로 난 개발과 관련된 파일은 C드라이브에 'Dev'라는 폴더를 만들어서 보관중인데, 보관 방식은 사람마다 다르니 자유에 맡기도록 한다. 

그러나 확실한건 절대 프로젝트 파일 안에 두면 안된다. 참고로 난 config파일에 넣어두었다가 git push할 때 에러를 만났는데...

remote:     Resolve the following violations before pushing again        
remote:     - Push cannot contain secrets        
remote:      (?) Learn how to resolve a blocked push        
remote:      https://docs.github.com/code-security/secret-scanning/working-with-secret-scanning-and-push-protection/working-with-push-protection-from-the-command-line#resolving-a-blocked-push            
remote:       —— Google Cloud Service Account Credentials ——————————        
remote:            path: api/src/main/resources/config/'발급받은json파일'
! refs/heads/main:refs/heads/main [remote rejected] (push declined due to repository rule violations)
Done

이런식의 무시무시한 에러를 만나게 됬다.

위와 같이 google에서 발급받은 json키를 프로젝트에 포함시키면 에러가 발생하는 모양이다.

검색해보니 프로젝트 외부에 파일을 위치하고 환경변수를 깔아도 된다고 한다. 

일단 그래서 프로젝트 바깥 쪽에 저렇게 key가 있는 json파일을 두었다.

 

4. 환경 변수 설정

인텔리제이 기준으로 Run > Edit Configuration 선택

Modify options 선택

Environment variables(환경 변수) 선택

저런식으로 key=value를 직접 입력해도 되고, 옆에 아이콘을 클릭해서 Name과 value를 입력해도 된다.

참고로 name(key)은 GOOGLE_APPLICATION_CREDENTIALS로 설정한다.

저상태로 IntelliJ 다시 실행하면 끝!

 

실행하면 정상적으로 score과 magnitude가 넘어오는걸 확인했다! 

예를 들어서 "오늘 날씨가 정말 화창한데 나가서 치킨먹고 올까?"라고 입력하면

score: 0.8, magnitude:0.8로 넘어온다.

기분이 매우 좋은걸로 잘 판단하는듯 하다...

 

후기

?

고생해서 다만들어놨더니 오류가 고쳐짐ㅋㅋㅋ

근데 답변 작성 시간이 오후 6시 54분...

담당자님 퇴근 안하시는지요....?

 

[참고 자료]

https://velog.io/@ygy0102/Spring-Boot-IntelliJ-Application-%ED%99%98%EA%B2%BD%EB%B3%80%EC%88%98-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0

[Spring Boot / IntelliJ] Application 환경변수 설정하기

https://cloud.google.com/natural-language/docs/analyzing-sentiment?hl=ko

감정 분석  |  Cloud Natural Language API  |  Google Cloud

https://cloud.google.com/natural-language/docs/reference/libraries?hl=ko#client-libraries-usage-java

Natural Language 클라이언트 라이브러리  |  Cloud Natural Language API  |  Google Cloud

https://cloud.google.com/docs/authentication/application-default-credentials?hl=ko

애플리케이션 기본 사용자 인증 정보 작동 방식  |  Authentication  |  Google Cloud

https://cloud.google.com/docs/authentication/set-up-adc-on-premises?hl=ko

온프레미스 또는 다른 클라우드 제공업체에 ADC 설정  |  Authentication  |  Google Cloud