이 안내서는 Natural Language 사용을 시작하기 위해 필요한 모든 설정 단계를 제공합니다.
콘솔 정보 Google Cloud
Google Cloud 콘솔은 제품을 사용하는 시스템을 프로비저닝, 구성, 관리 모니터링하는 데 사용되는 웹 UI입니다. Google Cloud 콘솔을 사용하여 Natural Language 리소스를 설정하고 관리합니다. Google Cloud
프로젝트 만들기
에서 제공하는 서비스를 사용하려면 Google Cloud 프로젝트를 만들어야 합니다.
프로젝트는 모든 리소스를 구성합니다. Google Cloud 프로젝트는 다음 구성요소로 구성됩니다.
- 공동작업자 그룹
- 사용 설정된 API 및 기타 도구
- 모니터링 도구
- 결제 정보
- 인증 및 액세스 제어
프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 리소스를 Google Cloud 리소스 계층 구조 로 구성할 수도 있습니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.
콘솔의 프로젝트 선택기 페이지에서 프로젝트를 선택하거나 만듭니다. Google Cloud Google Cloud
프로젝트를 선택하거나 만드는 데 필요한 역할
- 프로젝트 선택: 프로젝트를 선택하는 데 특정 IAM 역할이 필요하지 않습니다. 역할이 부여된 프로젝트를 선택할 수 있습니다.
-
프로젝트 만들기: 프로젝트를 만들려면
resourcemanager.projects.create권한이 포함된 프로젝트 생성자 역할 (roles/resourcemanager.projectCreator)이 필요합니다. 역할 부여 방법 알아보기.
결제 사용 설정
결제 계정은 지정된 리소스 모음의 결제자를 정의하는 데 사용되며 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량이 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.
프로젝트에 결제가 사용 설정되어 있는지 확인합니다 Google Cloud .
API 사용 설정
프로젝트에 Cloud Natural Language API를 사용 설정해야 합니다. API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.
Cloud Natural Language API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기
gcloud CLI 설치 및 초기화
Natural Language API를 사용하려면 gcloud CLI를 설치하고 초기화해야 합니다. gcloud CLI는 에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합입니다. Google Cloud 여기에는 gcloud CLI가 포함됩니다. 다음 링크에서 안내를 제공합니다.
Google Cloud CLI를 설치합니다. 설치 후 Google Cloud CLI를 초기화하려면 다음 명령어를 실행합니다.
gcloud init외부 ID 공급업체 (IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
인증 설정
API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 인증 설정 방법은 로컬 개발 환경에서 작업하는지 아니면 프로덕션 환경을 설정하는지에 따라 다릅니다. 자세한 내용은 애플리케이션 기본 사용자 인증 정보 설정을 참조하세요.
API에 액세스하려는 방법에 해당하는 탭을 선택하세요.
gcloud
Google Cloud CLI를 설치합니다. 설치 후 Google Cloud CLI를 초기화하려면 다음 명령어를 실행합니다.
gcloud init외부 ID 공급업체 (IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
클라이언트 라이브러리
로컬 개발 환경에서 클라이언트 라이브러리를 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
-
Google Cloud CLI를 설치합니다.
-
외부 ID 공급업체 (IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
-
로컬 셸을 사용하는 경우 사용자 계정에 대한 로컬 인증 사용자 인증 정보를 만듭니다.
gcloud auth application-default login
Cloud Shell을 사용하는 경우 이 작업을 수행할 필요는 없습니다.
인증 오류가 반환되고 외부 ID 공급업체(IdP)를 사용하는 경우 제휴 ID로 gcloud CLI에 로그인했는지 확인합니다.
자세한 내용은 인증 문서의 로컬 개발 환경의 ADC 설정을 참고하세요. Google Cloud
REST
로컬 개발 환경에서 REST API를 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치합니다.
외부 ID 공급업체 (IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
자세한 내용은 인증 문서 의 REST 사용을 위한 인증을 참고하세요. Google Cloud
프로덕션 환경의 인증 설정에 대한 자세한 내용은 인증 문서의에서 실행되는 코드의 애플리케이션 기본 사용자 인증 정보 설정을 참고하세요. Google Cloud Google Cloud
Natural Language API 클라이언트 라이브러리 설치
Natural Language API 호출에는 다음 세 가지 옵션이 있습니다.
클라이언트 라이브러리는 널리 사용되는 여러 언어로 제공됩니다. 클라이언트 라이브러리 설치에 대한 자세한 내용은 Cloud Natural Language 클라이언트 라이브러리를 참조하세요.
IAM 역할
Cloud Natural Language API에 액세스하는 데 필요한 권한을 얻으려면 관리자에게 할당량 프로젝트에 대한 서비스 사용량 소비자 (roles/serviceusage.serviceUsageConsumer) IAM 역할을 부여해 달라고 요청합니다.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.