빠른 시작: Document AI API 설정

이 가이드에서는 Document AI를 사용하기 위한 모든 필수 설정 단계를 제공합니다.

Google Cloud 콘솔 정보

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

프로젝트 만들기

Google Cloud에서 제공하는 서비스를 사용하려면 모든 Google Cloud 리소스를 구성하고 다음 구성요소로 구성된 프로젝트를 만들어야 합니다.

  • 공동작업자 그룹
  • 사용 설정된 API (및 기타 리소스)
  • 모니터링 도구
  • 결제 정보
  • 인증 및 액세스 제어
  • Document AI 프로세서

하나의 프로젝트를 만들거나 여러 프로젝트를 만들 수 있습니다. 프로젝트를 사용하여 Google Cloud 리소스 계층 구조에서 리소스를 구성할 수 있습니다. 프로젝트에 대한 자세한 내용은 Resource Manager 문서를 참조하세요.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

API 사용 설정

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

Enable the Document AI API.

Enable the API

결제 사용 설정

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

Make sure that billing is enabled for your Google Cloud project.

위치

Document AI는 프로젝트의 리소스가 저장되고 처리되는 위치를 제어할 수 있는 기능을 제공합니다. 특히 프로세서를 만들 때는 데이터를 저장하고 처리할 위치를 선택해야 합니다. 기본적으로 Document AI는 미국 위치에 리소스를 저장하고 처리합니다. 유럽 연합 위치를 선택하면 데이터와 프로세스가 유럽 연합에만 저장됩니다.

API를 사용하여 위치 설정

API를 사용하여 처리 요청을 보낼 때마다 프로세서의 위치를 지정해야 합니다. 예를 들어 프로세서가 유럽 연합에서 데이터를 저장하고 처리하도록 구성된 경우 다음과 같이 eu-documentai.googleapis.com URI를 사용합니다.

Process
  • https://eu-documentai.googleapis.com/v1/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:process
  • https://eu-documentai.googleapis.com/v1beta3/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:process
batchProcess
  • https://eu-documentai.googleapis.com/v1/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:batchProcess
  • https://eu-documentai.googleapis.com/v1beta3/projects/$PROJECT_ID/locations/eu/processors/$PROCESSOR_ID:batchProcess

Document AI API 클라이언트 라이브러리 설치

Document AI API를 호출하는 방법에는 세 가지가 있습니다.

클라이언트 라이브러리는 널리 사용되는 여러 언어로 제공됩니다. 클라이언트 라이브러리 설치에 대한 자세한 내용은 Document AI API 클라이언트 라이브러리를 참고하세요.

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

gcloud CLI는 Google Cloud에서 호스팅되는 리소스와 애플리케이션을 관리하는 데 사용할 수 있는 도구 집합을 제공합니다.

다음 링크에서 안내를 제공합니다.

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

인증 설정

API를 사용하는 모든 클라이언트 애플리케이션은 인증되어야 하며 요청된 리소스에 대한 액세스 권한을 받아야 합니다. 인증 설정 방법은 로컬 개발 환경에서 작업 중인지 아니면 프로덕션 환경을 설정 중인지에 따라 다릅니다. 자세한 내용은 애플리케이션 기본 사용자 인증 정보 설정을 참조하세요.

Select the tabs for how you plan to access the API:

gcloud

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

클라이언트 라이브러리

로컬 개발 환경에서 클라이언트 라이브러리를 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

자세한 내용은 Google Cloud 인증 문서의 로컬 개발 환경의 ADC 설정을 참고하세요.

REST

로컬 개발 환경에서 REST API를 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참고하세요.

프로덕션 환경의 인증 설정에 대한 자세한 내용은 Google Cloud 인증 문서의 Set up Application Default Credentials for code running on Google Cloud를 참고하세요.

역할 정보

API를 호출할 때 Google Cloud 호출하는 ID(관련된 사람, 항목, 절차와 정의된 속성)에 적절한 권한이 있어야 합니다. 사용자 계정 또는 서비스 계정에 역할을 부여하여 권한을 부여할 수 있습니다. 자세한 내용은 Identity and Access Management(IAM) 문서를 참조하세요.

Document AI API를 사용해 보려면 아래 단계에서 프로젝트 > 소유자 역할을 사용할 수 있습니다. 프로젝트 > 소유자 역할은 프로젝트의 리소스에 서비스 계정 전체 권한을 부여합니다. 요청에 전체 권한이 필요하지 않다면 Google Cloud 콘솔을 사용하여 더 제한적인 역할을 지정할 수 있습니다. Document AI의 권한 및 역할 목록은 Document AI 권한Document AI 역할을 참고하세요. IAM 역할을 사용하여 권한을 관리하는 방법에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

프로젝트 간 파일 액세스 설정

한 프로젝트에서 Document AI 프로세서를 설정할 때 이 프로젝트가 Document AI 프로세서를 호스팅하는 동일한 조직의 다른 프로젝트에 저장된 입력 파일에 액세스하도록 할 수 있습니다.

교차 프로젝트 액세스를 허용하려면 다음 그림과 같이 기본 Document AI 서비스 계정에 스토리지 객체 뷰어 역할(roles/storage.objectViewer)을 부여해야 합니다.

setup-1

  • 프로젝트 A가 문서 AI 프로세서를 호스팅하고, 선택적으로 버킷 프로세서 출력이 쓰여지는 버킷을 호스팅한다고 가정해 보겠습니다.
  • 프로젝트 B는 Document AI 프로세서의 입력 파일이 포함된 버킷을 소유합니다.
  • 프로젝트 B의 파일에 프로젝트 A에서 액세스할 수 있도록 하려면 프로젝트 B의 입력 버킷에 대한 스토리지 객체 뷰어 역할 (roles/storage.objectViewer)을 프로젝트 A의 Document AI 서비스 계정에 부여해야 합니다.

    setup-2

IAM 및 Storage Object Viewer에 관한 자세한 내용은 Cloud Storage의 IAM 역할을 참고하세요.

기본 제공 서비스 계정

Document AI 서비스 계정은 다음 이름 지정 규칙을 따릅니다.

service-{project number}@gcp-sa-prod-dai-core.iam.gserviceaccount.com

예: service-361747088407@gcp-sa-prod-dai-core.iam.gserviceaccount.com

setup-3

다음 단계: 사용 사례

Document AI API를 사용 설정한 후 Document AI 프로세서를 만들고 사용할 수 있습니다. 가장 적합한 프로세서 유형은 사용 사례에 따라 다릅니다.