Translator リソースを作成する
この記事では、Azure portal で Translator リソースを作成する方法について説明します。 Azure Translator は、クラウドベースの機械翻訳サービスであり、REST API の Azure Cognitive Services ファミリに含まれます。 Azure リソースは、作成するサービスのインスタンスです。 Azure サービスに対するすべての API 要求には、アクセスを認証するために、エンドポイント URL と読み取り専用のキーが必要です。
前提条件
開始するには、アクティブな Azure アカウントが必要です。 お持ちでない場合は、無料の 12 か月のサブスクリプションを作成できます。
リソースを作成する
Translator サービスには、2 つの異なるリソースの種類を使用してアクセスできます。
単一サービス リソースの種類を使用すると、1 つのサービス API キーとエンドポイントにアクセスできます。
マルチサービス リソースの種類を使用すると、1 つの API キーとエンドポイントを使用して複数の Cognitive Services にアクセスできます。
ヒント
1 つのエンドポイント/キーで複数の Cognitive Services にアクセスする予定の場合は、Cognitive Services リソースを作成します。 Translator サービス アクセスの場合のみ、Translator の単一サービス リソースを作成します。 Azure Active Directory 認証を使用する場合は、単一サービス リソースが必要になることに注意してください。
プロジェクトとインスタンスの詳細を入力する
[サブスクリプション]。 使用できる Azure サブスクリプションのいずれかを選択します。
[リソース グループ]。 新しいリソース グループを作成するか、同じライフサイクル、アクセス許可、ポリシーを共有する既存のリソース グループにリソースを追加することができます。
[リソース リージョン] . ご自身のビジネスまたはアプリケーションが特定のリージョンを必要としない限り、 [グローバル] を選択します。 マネージド ID 認証でドキュメント翻訳機能を使用する予定の場合は、非グローバル リージョンを選択してください。
[名前]。 自分のリソースに対して選択した名前を入力します。 選択した名前は Azure 内で一意である必要があります。
Note
ドキュメント翻訳など、カスタム ドメイン エンドポイントを必要とする Translator 機能を使用する場合は、[名前] フィールドに入力する値が、エンドポイントのカスタム ドメイン名パラメーターになります。
価格レベル。 自分のニーズに合った価格レベルを選択します。
- 各サブスクリプションに Free レベルがあります。
- Free レベルは有料プランと同じ機能を備えており、有効期限がありません。
- サブスクリプションごとに利用できる Free レベルは 1 つだけです。
- ドキュメント翻訳は、Free レベルではサポートされません。 その機能を試すには、Standard S1 を選択してください。
マルチサービス リソースを作成した場合は、チェック ボックスを使用して追加の使用状況の詳細を確認する必要があります。
[確認および作成] を選択します。
サービス条件を確認し、 [作成] を選択してリソースをデプロイします。
リソースが正常にデプロイされた後、 [リソースに移動] を選択します。
認証キーとエンドポイント URL
すべての Cognitive Services API 要求には、認証のためにエンドポイント URL と読み取り専用キーが必要です。
認証キー。 自分のキーは、Translation サービスへの要求ごとに渡される一意の文字列です。 自分のキーは、クエリ文字列パラメーターを使用するか、HTTP 要求ヘッダーで指定して渡すことができます。
エンドポイント URL。 特定の Azure リージョンまたはエンドポイントが必要な場合を除き、API 要求ではグローバル エンドポイントを使用します。 「ベース URL」を参照してください。 グローバル エンドポイント URL は
api.cognitive.microsofttranslator.comです。
認証キーとエンドポイントを取得する
- 新しいリソースがデプロイされた後、 [リソースに移動] を選択するか、自分のリソース ページに直接移動します。
- 左側のレールの [リソース管理] で、 [キーとエンドポイント] を選択します。
- 自分のキーとエンドポイント URL をコピーして、Microsoft Notepad などのアクセスしやすい場所に貼り付けます。
リソースまたはリソース グループを削除する方法
警告
リソース グループを削除すると、そのグループに含まれるすべてのリソースも削除されます。
Cognitive Services または Translator リソースを削除するには、リソースを削除するか、リソース グループを削除します。
リソースを削除するには:
- Azure portal で、リソース グループに移動します。
- 隣接するチェック ボックスをオンにして、削除するリソースを選択します。
- 右端近くの上部メニューから [削除] を選択します。
- [Deleted Resources](削除対象のリソース) ダイアログ ボックスに "はい" と入力します。
- [削除] を選択します。
リソース グループを削除するには:
- Azure portal で、リソース グループに移動します。
- 左端近くの上部メニュー バーから、 [リソース グループの削除] を選択します。
- リソース グループ名を入力し、 [削除] を選択して、削除要求を確定します。
Translator の使用を開始する方法
このクイックスタートでは、REST API で Translator サービスを使用する方法について説明します。
その他のリソース
- Microsoft Translator のコード サンプル. GitHub で、多言語の Translator のコード サンプルを入手できます。
- Microsoft Translator サポート フォーラム
- Azure を使ってみる (3 分間のビデオ)