위치

Cloud Natural Language를 사용하면 프로젝트의 리소스가 저장되고 처리되는 위치를 제어할 수 있습니다. 특히 저장 데이터를 저장하고 EU 또는 미국에서만 데이터를 머신러닝 처리하도록 Cloud Natural Language를 구성할 수 있습니다.

기본적으로 Cloud Natural Language는 Global 위치에 리소스를 저장하고 처리합니다. 즉, Cloud Natural Language는 리소스가 특정 위치 또는 지역 내에만 유지된다고 보장하지 않습니다. EU 위치를 선택하면 Google은 EU에서만 데이터를 저장하고 머신러닝을 수행합니다. 미국 위치를 선택하면 Google은 미국에서만 데이터를 저장하고 머신러닝을 수행합니다. 개발자와 사용자는 어디에서든 데이터에 액세스할 수 있습니다.

API를 사용하여 위치 설정

Cloud Natural Language는 전역 API 엔드포인트(language.googleapis.com), EU 엔드포인트(eu-language.googleapis.com), 미국 엔드포인트(us-language.googleapis.com)를 모두 지원합니다. 데이터를 EU에서만 저장하고 처리하려면 REST API 호출에서 language.googleapis.com 대신 eu-language.googleapis.com URI를 사용하세요. 미국에서만 데이터를 저장하고 처리하려면 REST API 호출에서 language.googleapis.com 대신 us-language.googleapis.com URI를 사용하세요.

텍스트 검토의 경우 오스트레일리아(미리보기)에서 데이터를 저장하고 처리할 수 있습니다. 이렇게 하려면 REST API 호출에서 language.googleapis.com 대신 au-language.googleapis.com URI를 사용하세요.

클라이언트 라이브러리를 사용하여 위치 설정

기본적으로 클라이언트 라이브러리는 전역 API 엔드포인트(language.googleapis.com)에 액세스합니다. 데이터를 유럽 연합 또는 미국에서만 저장하고 처리하려면 엔드포인트를 명시적으로 설정해야 합니다. 아래의 코드 샘플은 이 설정을 구성하는 방법을 보여줍니다.

Python

Natural Language용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Natural Language 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Natural Language Python API 참고 문서를 참조하세요.

Natural Language에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요. 

# Imports the Google Cloud client library
from google.cloud import language_v1

client_options = {"api_endpoint": "eu-language.googleapis.com:443"}

# Instantiates a client
client = language_v1.LanguageServiceClient(client_options=client_options)

Java

Natural Language용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Natural Language 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Natural Language Java API 참고 문서를 참조하세요.

Natural Language에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요. 

LanguageServiceSettings settings =
    LanguageServiceSettings.newBuilder().setEndpoint("eu-language.googleapis.com:443").build();

// Initialize client that will be used to send requests. This client only needs to be created
// once, and can be reused for multiple requests. After completing all of your requests, call
// the "close" method on the client to safely clean up any remaining background resources.
LanguageServiceClient client = LanguageServiceClient.create(settings);

Node.js

Natural Language용 클라이언트 라이브러리를 설치하고 사용하는 방법은 Natural Language 클라이언트 라이브러리를 참조하세요. 자세한 내용은 Natural Language Node.js API 참고 문서를 참조하세요.

Natural Language에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요. 

// Imports the Google Cloud client library
const language = require('@google-cloud/language');

// Specifies the location of the api endpoint
const clientOptions = {apiEndpoint: 'eu-language.googleapis.com'};

// Instantiates a client
const client = new language.LanguageServiceClient(clientOptions);