場所

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

デフォルトでは、Cloud Natural Language はグローバル ロケーションでリソースを処理します。つまり、Cloud Natural Language は、リソースが特定のロケーションやリージョンに留まることを保証しません。EU ロケーションを選択すると、Google は 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）にアクセスします。データの保存と処理を欧州連合国内または米国内に限定するには、エンドポイントを明示的に設定する必要があります。下のコードサンプルで、この設定方法を示します。

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