言語の検出（Basic）

このドキュメントでは、Cloud Translation - Basic（v2）を使用して文字列の言語を検出する方法について説明します。

始める前に

Cloud Translation API を使用するには、Cloud Translation API が有効になっているプロジェクトと適切な認証情報が必要です。また、この API の呼び出しを支援する一般的なプログラミング言語のクライアントライブラリをインストールすることもできます。詳細については、設定ページをご覧ください。

テキスト文字列の言語の検出

テキスト文字列の言語を検出するには、次の形式の URL を使用して HTTP リクエストを送信します。

https://translation.googleapis.com/language/translate/v2/detect

1 つの文字列の言語の検出

REST

テキストの言語を検出するには、POST リクエストを作成して適切なリクエスト本文を提供します。以下は、curl または PowerShell を使用した POST リクエストの例です。この例では、Google Cloud CLI を使用するプロジェクト用に設定されたサービスアカウントのアクセストークンを使用します。Google Cloud CLI のインストール、サービスアカウントでのプロジェクトの設定、アクセストークンの取得を行う手順については、設定ページをご覧ください。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_NUMBER_OR_ID: Google Cloud プロジェクトの数字または英数字の ID

HTTP メソッドと URL:

POST https://translation.googleapis.com/language/translate/v2/detect

リクエストの本文（JSON）:

{
  "q": "Mi comida favorita es una enchilada."
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://translation.googleapis.com/language/translate/v2/detect"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://translation.googleapis.com/language/translate/v2/detect" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "data": {
    "detections": [
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "es"
        }
      ]
    ]
  }
}

このレスポンスで、language は検出された言語コードです。残り 2 つのフィールド isReliable と confidence は、下位互換性のための非推奨のフィールドです。これらの値を意思決定やしきい値に使用しないことをおすすめします。

Go

このサンプルを試す前に、Cloud Translation クイックスタート: クライアントライブラリの使用にある Go の設定手順を完了してください。詳細については、Cloud Translation Go API リファレンスドキュメントをご覧ください。

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

import (
	"context"
	"fmt"

	"cloud.google.com/go/translate"
)

func detectLanguage(text string) (*translate.Detection, error) {
	// text := "こんにちは世界"
	ctx := context.Background()
	client, err := translate.NewClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("translate.NewClient: %w", err)
	}
	defer client.Close()
	lang, err := client.DetectLanguage(ctx, []string{text})
	if err != nil {
		return nil, fmt.Errorf("DetectLanguage: %w", err)
	}
	if len(lang) == 0 || len(lang[0]) == 0 {
		return nil, fmt.Errorf("DetectLanguage return value empty")
	}
	return &lang[0][0], nil
}

Java

このサンプルを試す前に、クライアントライブラリを使用して Cloud Translation クイックスタートにある Java の設定手順を完了してください。詳細については、Cloud Translation Java API リファレンスドキュメントをご覧ください。

// TODO(developer): Uncomment these lines.
// import com.google.cloud.translate.*;
// Translate translate = TranslateOptions.getDefaultInstance().getService();

List<String> texts = new LinkedList<>();
texts.add("Hello, World!");
texts.add("¡Hola Mundo!");
List<Detection> detections = translate.detect(texts);

System.out.println("Language(s) detected:");
for (Detection detection : detections) {
  System.out.printf("\t%s\n", detection);
}

Node.js

このサンプルを試す前に、クライアントライブラリを使用して Cloud Translation クイックスタートにある Node.js の設定手順を完了してください。詳細については、Cloud Translation Node.js API リファレンスドキュメントをご覧ください。

// Imports the Google Cloud client library
const {Translate} = require('@google-cloud/translate').v2;

// Creates a client
const translate = new Translate();

/**
 * TODO(developer): Uncomment the following line before running the sample.
 */
// const text = 'The text for which to detect language, e.g. Hello, world!';

// Detects the language. "text" can be a string for detecting the language of
// a single piece of text, or an array of strings for detecting the languages
// of multiple texts.
async function detectLanguage() {
  let [detections] = await translate.detect(text);
  detections = Array.isArray(detections) ? detections : [detections];
  console.log('Detections:');
  detections.forEach(detection => {
    console.log(`${detection.input} => ${detection.language}`);
  });
}

detectLanguage();

Python

このサンプルを試す前に、クライアントライブラリを使用して Cloud Translation クイックスタートにある Python の設定手順を完了してください。詳細については、Cloud Translation Python API リファレンスドキュメントをご覧ください。

def detect_language(text: str) -> dict:
    """Detects the text's language."""
    from google.cloud import translate_v2 as translate

    translate_client = translate.Client()

    # Text can also be a sequence of strings, in which case this method
    # will return a sequence of results for each text.
    result = translate_client.detect_language(text)

    print(f"Text: {text}")
    print("Confidence: {}".format(result["confidence"]))
    print("Language: {}".format(result["language"]))

    return result

その他の言語

C#: クライアントライブラリページの C# の設定手順を行ってから、.NET 用の Cloud Translation リファレンスドキュメントをご覧ください。

PHP: クライアントライブラリページの PHP の設定手順を行ってから、PHP 用の Cloud Translation リファレンスドキュメントをご覧ください。

Ruby: クライアントライブラリページの Ruby の設定手順を行ってから、Ruby 用の Cloud Translation リファレンスドキュメントをご覧ください。

複数の文字列の言語の検出

REST

複数の文字列の言語を検出するには、q パラメータを使用して各文字列を指定します。この例では、検出のために 2 つの個別の文字列を渡しています。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_NUMBER_OR_ID: Google Cloud プロジェクトの数字または英数字の ID

HTTP メソッドと URL:

POST https://translation.googleapis.com/language/translate/v2/detect

リクエストの本文（JSON）:

{
  "q": ["Hello world", "我的名字叫傑夫"]
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d @request.json \
    "https://translation.googleapis.com/language/translate/v2/detect"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://translation.googleapis.com/language/translate/v2/detect" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "data": {
    "detections": [
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "en"
        }
      ],
      [
        {
          "confidence": 1,
          "isReliable": false,
          "language": "zh-TW"
        }
      ]
    ]
  }
}

この場合、レスポンスには、リクエストで指定された対応する 2 つの原文の文字列と同じ順番で検出結果が含まれます。

Go

複数のテキストの言語を検出するには、前の例に示されている Client#DetectLanguage メソッドに渡されるスライスに複数の文字列を組み込みます。

Java

複数のテキストの言語を検出するには、前の例に示されている Translate#detect メソッドに文字列のリストを渡すだけです。

Node.js

複数のテキストの言語を検出するには、前の例に示されている Translate#detect メソッドに文字列の配列を渡すだけです。

Python

複数のテキストの言語を検出するには、前の例に示されている Client#detect_language メソッドに文字列のリストを渡すだけです。

その他の言語

C#: クライアントライブラリページの C# の設定手順を行ってから、.NET 用の Cloud Translation リファレンスドキュメントをご覧ください。

PHP: クライアントライブラリページの PHP の設定手順を行ってから、PHP 用の Cloud Translation リファレンスドキュメントをご覧ください。

Ruby: クライアントライブラリページの Ruby の設定手順を行ってから、Ruby 用の Cloud Translation リファレンスドキュメントをご覧ください。

Ruby

複数のテキストの言語を検出するには、前の例に示されている Translate#detect メソッドに、複数の文字列を渡すだけです。

参考情報

一般的な問題またはエラーの解決に関するヘルプについては、トラブルシューティングページをご覧ください。