이 안내서는 Natural Language 사용을 시작하기 위해 필요한 모든 설정 단계를 제공합니다.
Google Cloud Console 정보
Google Cloud Console은 Google Cloud 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. Google Cloud Console을 사용하여 Natural Language 리소스를 설정 및 관리합니다.
프로젝트 만들기
Google Cloud에서 제공하는 서비스를 사용하려면 프로젝트를 만들어야 합니다.
프로젝트는 모든 Google Cloud 리소스를 구성합니다. 프로젝트는 다음 구성요소로 구성됩니다.
- 공동작업자 그룹
- 사용 설정된 API 및 기타 도구
- 모니터링 도구
- 결제 정보
- 인증 및 액세스 제어
프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 Google Cloud 리소스를 리소스 계층 구조로 구성할 수도 있습니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.
Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
결제 사용 설정
결제 계정은 지정된 리소스 모음의 결제자를 정의하는 데 사용되며 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량이 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.
Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.
API 사용 설정
프로젝트에 Cloud Natural Language API를 사용 설정해야 합니다. API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.
Cloud Natural Language API 사용 설정
인증 설정
API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 이 섹션에서는 중요한 인증 개념을 설명하고 설정 단계를 안내합니다. 자세한 내용은 Google Cloud 인증 개요를 참조하세요.
서비스 계정 정보
인증에는 여러 옵션이 있지만 인증 및 액세스 제어에는 서비스 계정을 사용하는 것이 좋습니다. 서비스 계정은 최종 사용자가 아닌 애플리케이션의 사용자 인증 정보를 제공합니다. 서비스 계정은 프로젝트에서 소유하며 하나의 프로젝트에 여러 개의 서비스 계정을 만들 수 있습니다. 자세한 내용은 서비스 계정을 참조하세요.
역할 정보
Cloud Natural Language API에 액세스해야 할 역할이 없습니다. 인증된 사용자 또는 애플리케이션은 권한에 관계없이 API를 호출할 수 있습니다.
서비스 계정 키 정보
서비스 계정은 하나 이상의 공개 키/비공개 키 쌍을 사용합니다. 새 키 쌍을 만들 때 비공개 키를 다운로드합니다. 비공개 키는 API를 호출할 때 사용자 인증 정보를 생성하는 데 사용됩니다. 비공개 키의 보안 및 키 순환과 같은 다른 관리 작업의 책임은 사용자에게 있습니다.
서비스 계정 생성 및 비공개 키 파일 다운로드
서비스 계정을 만듭니다.
-
Google Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.
서비스 계정 만들기로 이동 - 프로젝트를 선택합니다.
-
서비스 계정 이름 필드에 이름을 입력합니다. Google Cloud 콘솔은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.
서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면
Service account for quickstart입니다. - 만들고 계속하기를 클릭합니다.
-
완료를 클릭하여 서비스 계정 만들기를 마칩니다.
브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.
서비스 계정 키 만들기
- Google Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
- 키를 클릭합니다.
- 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
- 만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
- 닫기를 클릭합니다.
환경에서 서비스 계정 키 파일 사용
GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정하여 애플리케이션 코드에 사용자 인증 정보를 제공합니다. 이 변수는 현재 셸 세션에만 적용됩니다. 이후 셸 세션에 이 변수를 적용하려면 셸 시작 파일(예: ~/.bashrc 또는 ~/.profile 파일)에서 변수를 설정합니다.
Linux 또는 macOS
export GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
KEY_PATH를 서비스 계정 키가 포함된 JSON 파일의 경로로 바꿉니다.
예를 들면 다음과 같습니다.
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"
Windows
PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="KEY_PATH"
KEY_PATH를 서비스 계정 키가 포함된 JSON 파일의 경로로 바꿉니다.
예를 들면 다음과 같습니다.
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\service-account-file.json"
명령 프롬프트:
set GOOGLE_APPLICATION_CREDENTIALS=KEY_PATH
KEY_PATH를 서비스 계정 키가 포함된 JSON 파일의 경로로 바꿉니다.
gcloud CLI 설치 및 초기화
Natural Language API를 사용하려면 gcloud CLI를 설치하고 초기화해야 합니다. gcloud CLI는 Google Cloud에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합입니다. 여기에는 gcloud CLI가 포함됩니다. 다음 링크에서 안내를 제공합니다.
Google Cloud CLI를 설치한 후 다음 명령어를 실행하여 초기화합니다.
gcloud init
SDK 및 인증 테스트
이전 단계에서 인증을 설정한 경우 gcloud CLI를 사용하여 인증 환경을 테스트할 수 있습니다. 다음 명령어를 실행하여 오류가 발생하지 않고 사용자 인증 정보가 반환되는지 확인합니다.
gcloud auth application-default print-access-token
이 명령어는 모든 Natural Language 명령줄 REST 샘플에서 API 호출을 인증하는 데 사용됩니다.
Natural Language API 클라이언트 라이브러리 설치
Natural Language API 호출에는 다음 세 가지 옵션이 있습니다.
클라이언트 라이브러리는 널리 사용되는 여러 언어로 제공됩니다. 클라이언트 라이브러리 설치에 대한 자세한 내용은 Cloud Natural Language 클라이언트 라이브러리를 참조하세요.