場所

Cloud Natural Language では、プロジェクトのリソースが処理されるロケーションをある程度制御できます。たとえば、EU または米国でのみデータに対して機械学習処理を実行するように Cloud Natural Language を構成できます。

デフォルトでは、Cloud Natural Language はリソースをグローバル ロケーションで処理します。つまり、Cloud Natural Language は、リソースが特定のロケーションやリージョンに留まることを保証しません。欧州連合ロケーションを選択すると、EU 内でのみ機械学習が実行されます。米国ロケーションを選択すると、データの保存と機械学習の実行が米国内で行われます。ユーザーはどこからでもデータにアクセスできます。

API を使用してロケーションを設定する

Cloud Natural Language は、グローバル API エンドポイント（language.googleapis.com）、EU エンドポイント（eu-language.googleapis.com）、米国エンドポイント（us-language.googleapis.com）をサポートしています。EU 内に限定してデータの処理を行うには、REST API の呼び出しで URI に language.googleapis.com ではなく eu-language.googleapis.com を使用します。データの処理を米国内に限定するには、REST API の呼び出しで、URI language.googleapis.com に代わり、URI us-language.googleapis.com を使用します。

テキスト管理 API はオーストラリアでも利用できます。REST API 呼び出しで URI language.googleapis.com の代わりに URI au-language.googleapis.com を使用するとアクセスできます。

クライアント ライブラリを使用してロケーションを設定する

クライアント ライブラリは、デフォルトでグローバル API エンドポイント（language.googleapis.com）にアクセスします。データの保存と処理を欧州連合国内または米国内に限定するには、エンドポイントを明示的に設定する必要があります。下のコードサンプルで、この設定方法を示します。

# 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)

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);

// 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);