빠른 시작: Natural Language 설정

이 안내서는 Natural Language 사용을 시작하기 위해 필요한 모든 설정 단계를 제공합니다.

GCP Console 정보

Google Cloud Platform(GCP) Console은 GCP 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. GCP 콘솔을 사용하여 Natural Language 리소스를 설정하고 관리합니다.

프로젝트 만들기

GCP에서 제공하는 서비스를 사용하려면 프로젝트를 만들어야 합니다.

프로젝트는 모든 GCP 리소스를 구성합니다. 프로젝트는 다음 구성요소로 구성됩니다.

  • 공동작업자 그룹
  • 사용 설정된 API 및 기타 도구
  • 모니터링 도구
  • 결제 정보
  • 인증 및 액세스 제어

프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 GCP 리소스를 리소스 계층구조로 구성할 수도 있습니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.

Cloud Console의 프로젝트 선택기 페이지에서 Cloud 프로젝트를 선택하거나 만듭니다.

프로젝트 선택기 페이지로 이동

결제 사용 설정

결제 계정은 정해진 리소스 집합의 비용을 누가 지불하는지 정의하는 데 사용되며 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량이 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

API 사용 설정

프로젝트에 Cloud Natural Language API를 사용 설정해야 합니다. API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.

Cloud Natural Language API를 사용 설정합니다.

API 사용 설정

인증 설정

API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 이 섹션에서는 중요한 인증 개념을 설명하고 설정 단계를 안내합니다. 자세한 내용은 GCP 인증 개요를 참조하세요.

서비스 계정 정보

인증에는 여러 옵션이 있지만 인증 및 액세스 제어에는 서비스 계정을 사용하는 것이 좋습니다. 서비스 계정은 최종 사용자가 아닌 애플리케이션의 사용자 인증 정보를 제공합니다. 서비스 계정은 프로젝트에서 소유하며 하나의 프로젝트에 여러 개의 서비스 계정을 만들 수 있습니다. 자세한 내용은 서비스 계정을 참조하세요.

역할 정보

ID가 API를 호출할 때 GCP는 이 ID에 적절한 권한이 있을 것을 요구합니다. 서비스 계정에 역할을 부여하여 권한을 부여할 수 있습니다. 자세한 내용은 Cloud Identity and Access Management 문서를 참조하세요.

Natural Language API를 살펴보기 위해 아래 단계에서 프로젝트 > 소유자 역할을 사용할 수 있습니다. 이 경우 서비스 계정에 프로젝트의 리소스에 대한 전체 권한이 부여됩니다. 서비스 계정에 전체 권한이 필요 없는 경우 Cloud Console을 사용하여 더 제한적인 역할을 지정할 수 있습니다. 역할 및 권한 목록은 IAM 권한 참조를 참조하세요. IAM 역할을 사용한 권한 관리에 대한 자세한 내용은 서비스 계정에 역할 부여를 참조하세요.

서비스 계정 키 정보

서비스 계정은 하나 이상의 공개 키/비공개 키 쌍을 사용합니다. 새 키 쌍을 만들 때 비공개 키를 다운로드합니다. 비공개 키는 API를 호출할 때 사용자 인증 정보를 생성하는 데 사용됩니다. 비공개 키의 보안 및 키 순환과 같은 다른 관리 작업의 책임은 사용자에게 있습니다.

서비스 계정을 만들고 비공개 키 파일을 다운로드합니다.

인증 설정:
  1. Cloud Console에서 서비스 계정 키 만들기 페이지로 이동합니다.

    서비스 계정 키 만들기 페이지로 이동
  2. 서비스 계정 목록에서 새 서비스 계정을 선택합니다.
  3. 서비스 계정 이름 필드에 이름을 입력합니다.
  4. 역할 목록에서 프로젝트 > 소유자를 선택합니다.

    참고: 역할 필드가 리소스에 액세스할 수 있도록 서비스 계정을 승인합니다. 나중에 Cloud Console을 사용하여 이 필드를 보고 변경할 수 있습니다. 프로덕션 애플리케이션을 개발하는 경우 프로젝트 > 소유자보다 세부적인 권한을 지정합니다. 자세한 내용은 서비스 계정에 역할 부여를 참조하세요.
  5. 만들기를 클릭합니다. 키가 포함된 JSON 파일이 컴퓨터에 다운로드됩니다.

사용자 환경에서 서비스 계정 키 파일 사용

환경 변수 GOOGLE_APPLICATION_CREDENTIALS를 설정하여 애플리케이션 코드에 사용자 인증 정보를 제공합니다. [PATH]를 서비스 계정 키가 포함된 JSON 파일의 파일 경로로 바꾸고, [FILE_NAME]을 파일 이름으로 바꿉니다. 이 변수는 현재 셸 세션에만 적용되므로 새 세션을 연 경우 변수를 다시 설정합니다.

Linux 또는 macOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

예:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/[FILE_NAME].json"

Windows

PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

예를 들면 다음과 같습니다.

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\[FILE_NAME].json"

명령 프롬프트:

set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

Cloud SDK 설치 및 초기화

Natural Language API를 사용하려면 Cloud SDK를 설치하고 초기화해야 합니다. Cloud SDK는 GCP에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합입니다. 여기에는 gcloud 명령줄 도구가 포함됩니다. 다음 링크에서 안내를 제공합니다.

Cloud SDK를 설치하고 초기화합니다.

SDK 및 인증 테스트

이전 단계에서 인증을 설정한 경우 gcloud 도구를 사용하여 인증 환경을 테스트할 수 있습니다. 다음 명령어를 실행하여 오류가 발생하지 않고 사용자 인증 정보가 반환되는지 확인합니다.

gcloud auth application-default print-access-token

이 명령어는 모든 Natural Language 명령줄 REST 샘플에서 API 호출을 인증하는 데 사용됩니다.

Natural Language 클라이언트 라이브러리 설치

Natural Language API 호출에는 다음 세 가지 옵션이 있습니다.

클라이언트 라이브러리는 널리 사용되는 여러 언어로 제공됩니다. 클라이언트 라이브러리 설치에 대한 정보는 Cloud Natural Language Client 라이브러리를 참조하십시오.