이 가이드에서는 Cloud Vision을 처음 사용하는 데 필요한 모든 설정 단계를 제공합니다. 또한 Cloud Vision을 사용해 보거나 테스트한 후 가능한 삭제 단계에 대한 안내를 제공합니다.
Google Cloud Console 정보
Google Cloud Console(문서 보기, Console 열기)은 Google Cloud 제품을 사용하는 시스템을 프로비저닝, 구성, 관리, 모니터링하는 데 사용되는 웹 UI입니다. Google Cloud 콘솔을 사용하여 Vision 리소스를 설정하고 관리합니다.
프로젝트 만들기
Google Cloud에서 제공하는 서비스를 사용하려면 프로젝트를 만들어야 합니다. 프로젝트는 모든 Google Cloud 리소스를 구성합니다. 프로젝트는 공동작업자, 사용 설정된 API(및 기타 리소스), 모니터링 도구, 결제 정보, 인증, 액세스 제어로 구성됩니다. 프로젝트를 하나 또는 여러 개 만들 수 있으며 이를 사용하여 Google Cloud 리소스를 리소스 계층 구조로 구성할 수도 있습니다. 프로젝트를 만들 때 프로젝트 ID를 기록해 둡니다. API 호출에 이 ID가 필요합니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
결제 사용 설정
결제 계정은 정해진 리소스 집합의 비용을 누가 지불하는지 정의하는 데 사용되며 하나 이상의 프로젝트에 연결할 수 있습니다. 프로젝트 사용량이 연결된 결제 계정으로 청구됩니다. 대부분의 경우 프로젝트를 만들 때 결제를 구성합니다. 자세한 내용은 결제 문서를 참조하세요.
Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
API 사용 설정
프로젝트에 Vision API를 사용 설정해야 합니다. API 사용 설정에 대한 자세한 내용은 서비스 사용 문서를 참조하세요.
Enable the Vision API.
Google Cloud CLI를 설치하고 초기화합니다.
Vision API를 사용하려면 Google Cloud CLI를 설치하고 초기화해야 합니다. gcloud CLI는 Google Cloud에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합입니다.
다음 링크에서 안내를 제공합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
인증 및 액세스 제어 설정
Vision API를 사용하려면 인증을 설정해야 합니다. API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 이 섹션에서는 중요한 인증 개념을 설명하고 설정 단계를 안내합니다. 자세한 내용은 Google Cloud 인증 개요를 참조하세요.
사용자 계정을 사용한 인증
사용자 계정은 Vision API를 학습할 때 그리고 로컬 개발을 위한 최고의 인증 옵션입니다. 사용자 계정을 사용하여 REST 명령줄 실행 또는 클라이언트 라이브러리 호출에 대해 인증을 수행할 수 있습니다.
REST 명령줄 사용자 계정 인증
REST 명령줄 호출에 대해 인증을 수행하려면 gcloud CLI를 사용합니다.
gcloud auth login 명령어는 사용자 계정을 사용하여 gcloud에 사용자 로그인을 수행합니다. 이 작업은 API 호출 전에 수행되어야 합니다.
gcloud auth print-access-token 명령어는 이 문서에서 REST 명령줄 샘플을 통해 REST 호출 인증을 위해 사용됩니다.
로컬 환경에 대해 사용자 인증 정보를 만들려면 다음 안내를 따르세요.
gcloud auth login
클라이언트 라이브러리 사용자 계정 인증
클라이언트 라이브러리 호출에 대해 인증을 수행하려면 gcloud CLI를 사용합니다.
gcloud auth application-default login 명령어는 사용자 계정을 사용하여 애플리케이션 기본 사용자 인증 정보에 대해 gcloud에 사용자 로그인을 수행합니다. 이 작업은 API 호출 전에 수행되어야 합니다.
API 호출 관련 결제 및 할당량에 대해 프로젝트를 설정하려면 gcloud auth application-default set-quota-project 명령어를 사용해야 합니다.
일반적으로 이것은 에이전트에 사용되는 동일한 프로젝트이며, 위 단계에서 만든 프로젝트에 대해 프로젝트 ID를 제공합니다.
애플리케이션 기본 사용자 인증 정보를 클라이언트 라이브러리에 사용하려면 GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정하지 않아야 합니다.
로컬 환경에 대해 애플리케이션 기본 사용자 인증 정보를 만들려면 다음 안내를 따르세요.
gcloud auth application-default login gcloud auth application-default set-quota-project PROJECT_ID
서비스 계정을 사용하여 인증
서비스 계정은 프로덕션 또는 스테이징과 같은 보안 환경에서만 사용해야 하는 또 다른 인증 옵션입니다. 서비스 계정은 최종 사용자가 아닌 애플리케이션의 사용자 인증 정보를 제공합니다. 서비스 계정은 프로젝트에서 소유하며 하나의 프로젝트에 여러 개의 서비스 계정을 만들 수 있습니다. 자세한 내용은 다음을 참고하세요.
역할을 사용하여 액세스 제어
주 구성원(사용자 계정, 서비스 계정 등)이 API를 호출할 때 Google Cloud는 주 구성원에게 적절한 권한을 요구합니다. 주 구성원에 역할을 부여하여 권한을 부여할 수 있습니다. 자세한 내용은 역할 개요를 참조하세요.
사용자 계정을 사용하여 프로젝트를 만든 경우 사용자 계정에 프로젝트에 대한 소유자 기본 역할이 포함됩니다. 이 역할은 프로젝트의 모든 API를 호출할 액세스 권한을 제공합니다. 하지만 다른 계정이 프로젝트를 만든 경우 API를 호출하려면 사용자 계정에 역할을 부여해야 할 수 있습니다.
Vision API 클라이언트 라이브러리 설치
Vision API는 세 가지 방법으로 호출할 수 있습니다.
클라이언트 라이브러리는 널리 사용되는 여러 언어로 제공됩니다. 클라이언트 라이브러리 설치에 대한 자세한 내용은 Vision API 클라이언트 라이브러리를 참조하세요.
삭제
Vision 설정 및 시험 사용 또는 테스트 후 생성한 리소스를 삭제해야 할 수 있습니다.
- 프로젝트를 종료합니다.
-
gcloud auth login을 호출한 경우 컴퓨터의 사용자 디렉터리에 사용자 인증 정보가 저장됩니다. 다음을 호출하여 이러한 사용자 인증 정보를 삭제해야 할 수 있습니다.gcloud auth revoke
-
gcloud auth application-default login을 호출한 경우 컴퓨터의 사용자 디렉터리에 사용자 인증 정보가 저장됩니다. 다음을 호출하여 이러한 사용자 인증 정보를 삭제해야 할 수 있습니다.gcloud auth application-default revoke