この古いバージョンの AutoML Natural Language は非推奨となり、2024 年 3 月 15 日以降は Google Cloud で使用できなくなります。以前の AutoML Natural Language のすべての機能と新機能は、Vertex AI プラットフォームで使用可能です。リソースを移行する方法については、Vertex AI に移行するをご覧ください。

ロケーション

AutoML Natural Language では、プロジェクトのリソース（データセットとモデル）が保存、処理される場所をある程度制御できます。たとえば、EU でのみ保存データを保存して、機械学習処理を実行するように AutoML Natural Language を構成できます。

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

AutoML Natural Language UI におけるロケーションの設定

新しいデータセットを作成するときは、データセット名を入力するテキストボックスのすぐ下のプルダウンリストを使用してデータセットのロケーションを指定します。そのデータセットを使用してトレーニングされたモデルは、同じロケーションに作成されます。

データセットとモデルのリスティングページには [ロケーション] プルダウンリストがあり、これを使用して、選択したロケーションのリソースを表示できます。

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

AutoML Natural Language は、グローバル API エンドポイント（automl.googleapis.com）と EU エンドポイント（eu-automl.googleapis.com）の両方をサポートします。EU 内に限定してデータの保存と処理を行うには、REST API 呼び出しで URI に automl.googleapis.com ではなく eu-automl.googleapis.com を使用します。

AutoML API を使用する場合は、ロケーションと一意の ID を含む完全なリソース名を使用してリソースを識別します。たとえば、データセットのリソース名の形式は、projects/{project-id}/locations/{location}/datasets/{dataset-id} となります。グローバルロケーションに保存されているリソースの場合は、{location} 変数を値 us-central1 で置き換えます。EU ロケーションに保存されているリソースの場合は、{location} 変数を値 eu で置き換えます。

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

AutoML クライアントライブラリは、デフォルトでグローバル API エンドポイント（automl.googleapis.com）にアクセスします。EU でのみデータを保存して処理するには、エンドポイントを明示的に設定する必要があります。下のコードサンプルで、この構成方法を示します。

Python

AutoML Natural Language のクライアントライブラリをインストールして使用する方法については、AutoML Natural Language のクライアントライブラリをご覧ください。詳細については、AutoML Natural Language Python API のリファレンスドキュメントをご覧ください。

AutoML Natural Language で認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証の設定をご覧ください。

from google.cloud import automl_v1beta1 as automl

# You must first create a dataset, using the `eu` endpoint, before you can
# call other operations such as: list, get, import, delete, etc.
client_options = {"api_endpoint": "eu-automl.googleapis.com:443"}

# Instantiates a client
client = automl.AutoMlClient(client_options=client_options)

# A resource that represents Google Cloud Platform location.
# project_id = 'YOUR_PROJECT_ID'
project_location = f"projects/{project_id}/locations/eu"

Java

AutoML Natural Language のクライアントライブラリをインストールして使用する方法については、AutoML Natural Language のクライアントライブラリをご覧ください。詳細については、AutoML Natural Language Java API のリファレンスドキュメントをご覧ください。

AutoMlSettings settings =
    AutoMlSettings.newBuilder().setEndpoint("eu-automl.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.
AutoMlClient client = AutoMlClient.create(settings);

// A resource that represents Google Cloud Platform location.
LocationName projectLocation = LocationName.of(projectId, "eu");

Node.js

AutoML Natural Language のクライアントライブラリをインストールして使用する方法については、AutoML Natural Language のクライアントライブラリをご覧ください。詳細については、AutoML Natural Language Node.js API のリファレンスドキュメントをご覧ください。

const automl = require('@google-cloud/automl').v1beta1;

// You must first create a dataset, using the `eu` endpoint, before you can
// call other operations such as: list, get, import, delete, etc.
const clientOptions = {apiEndpoint: 'eu-automl.googleapis.com'};

// Instantiates a client
const client = new automl.AutoMlClient(clientOptions);

// A resource that represents Google Cloud Platform location.
const projectLocation = client.locationPath(projectId, 'eu');