探索支援的語言 (基本版)

本文說明如何使用 Cloud Translation API (v2) 列出支援的語言。

事前準備

如要開始使用 Cloud Translation API，您必須擁有已啟用 Cloud Translation API 的專案，並具備適當的憑證。您也可以安裝常用程式設計語言的用戶端程式庫，協助您呼叫 API。詳情請參閱「設定」頁面。

列出支援的語言

REST

如要取得支援語言的清單，請向 https://translation.googleapis.com/language/translate/v2/languages 端點發出 GET 要求。以下為使用 curl 和 PowerShell 的 GET 要求範例。範例中使用的存取憑證，屬於使用 Google Cloud CLI 建立的專案服務帳戶。如需安裝 gcloud CLI、使用服務帳戶建立專案，以及取得存取憑證的操作說明，請參閱「設定」頁面。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_NUMBER_OR_ID： Google Cloud 專案的數值或英數字元 ID

HTTP 方法和網址：

GET https://translation.googleapis.com/language/translate/v2/languages

如要傳送要求，請展開以下其中一個選項：

您應該會收到如下的 JSON 回應：

{
  "languages": [
    {
      "language": "en"
    },
    {
      "language": "fr"
    },
    {
      "language": "zh-CN"
    }
  ]
}

這項查詢會傳回支援語言的 ISO-639 語言代碼。部分語言也會包含國家/地區代碼，例如 zh-CN 或 zh-TW。清單會依語言代碼的字母順序排序。由於空間限制，上述範例已縮短。

Go

import (
	"context"
	"fmt"
	"io"

	"cloud.google.com/go/translate"
	"golang.org/x/text/language"
)

func listSupportedLanguages(w io.Writer, targetLanguage string) error {
	// targetLanguage := "th"
	ctx := context.Background()

	lang, err := language.Parse(targetLanguage)
	if err != nil {
		return fmt.Errorf("language.Parse: %w", err)
	}

	client, err := translate.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("translate.NewClient: %w", err)
	}
	defer client.Close()

	langs, err := client.SupportedLanguages(ctx, lang)
	if err != nil {
		return fmt.Errorf("SupportedLanguages: %w", err)
	}

	for _, lang := range langs {
		fmt.Fprintf(w, "%q: %s\n", lang.Tag, lang.Name)
	}

	return nil
}

Java

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

List<Language> languages = translate.listSupportedLanguages();

for (Language language : languages) {
  System.out.printf("Name: %s, Code: %s\n", language.getName(), language.getCode());
}

Node.js

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

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

async function listLanguages() {
  // Lists available translation language with their names in English (the default).
  const [languages] = await translate.getLanguages();

  console.log('Languages:');
  languages.forEach(language => console.log(language));
}

listLanguages();

Python

def list_languages() -> dict:
    """Lists all available languages."""
    from google.cloud import translate_v2 as translate

    translate_client = translate.Client()

    results = translate_client.get_languages()

    for language in results:
        print("{name} ({language})".format(**language))

    return results

其他語言

C#： 請按照用戶端程式庫頁面的 C# 設定說明操作， 然後前往 .NET 適用的 Cloud Translation 參考說明文件。

PHP： 請按照用戶端程式庫頁面的 PHP 設定說明 操作，然後前往 PHP 適用的 Cloud Translation 參考說明文件。

Ruby： 請按照用戶端程式庫頁面的 Ruby 設定說明 操作，然後前往 Ruby 適用的 Cloud Translation 參考文件。

以譯文語言名稱列出支援的語言

REST

以下為傳回支援語言清單的另一個範例。傳回的語言名稱以指定譯文語言編寫。傳回的清單依譯文語言的字母順序排序。

如要以譯文語言列出支援的語言，請發出 POST 要求，並在要求主體中提供標示譯文語言的 JSON。以下為使用 curl 或 PowerShell 的 POST 要求範例。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_NUMBER_OR_ID： Google Cloud 專案的數值或英數字元 ID

HTTP 方法和網址：

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

JSON 要求主體：

{
    "target": "zh-TW"
}

如要傳送要求，請展開以下其中一個選項：

您應該會收到如下的 JSON 回應：

{
  "data": {
    "languages": [
      {
        "language": "zh-CN",
        "name": "中文(簡體)"
      },
      {
        "language": "fr",
        "name": "法文"
      },
      {
        "language": "en",
        "name": "英文"
      }
    ]
  }
}

在這個範例中，查詢所傳回的語言代碼與上述範例相同，此外還傳回了 name 字串，指定以譯文語言寫入之語言的名稱。由於空間限制，上述範例已縮短。

Go

import (
	"context"
	"fmt"
	"io"

	"cloud.google.com/go/translate"
	"golang.org/x/text/language"
)

func listSupportedLanguages(w io.Writer, targetLanguage string) error {
	// targetLanguage := "th"
	ctx := context.Background()

	lang, err := language.Parse(targetLanguage)
	if err != nil {
		return fmt.Errorf("language.Parse: %w", err)
	}

	client, err := translate.NewClient(ctx)
	if err != nil {
		return fmt.Errorf("translate.NewClient: %w", err)
	}
	defer client.Close()

	langs, err := client.SupportedLanguages(ctx, lang)
	if err != nil {
		return fmt.Errorf("SupportedLanguages: %w", err)
	}

	for _, lang := range langs {
		fmt.Fprintf(w, "%q: %s\n", lang.Tag, lang.Name)
	}

	return nil
}

Java

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

List<Language> languages =
    translate.listSupportedLanguages(Translate.LanguageListOption.targetLanguage("es"));

for (Language language : languages) {
  System.out.printf("Name: %s, Code: %s\n", language.getName(), language.getCode());
}

Node.js

// 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 target = 'The target language for language names, e.g. ru';

async function listLanguagesWithTarget() {
  // Lists available translation language with their names in a target language
  const [languages] = await translate.getLanguages(target);

  console.log('Languages:');
  languages.forEach(language => console.log(language));
}

listLanguagesWithTarget();

Python

def list_languages_with_target(target: str) -> dict:
    """Lists all available languages and localizes them to the target language.

    Target must be an ISO 639-1 language code.
    See https://g.co/cloud/translate/v2/translate-reference#supported_languages
    """
    from google.cloud import translate_v2 as translate

    translate_client = translate.Client()

    results = translate_client.get_languages(target_language=target)

    for language in results:
        print("{name} ({language})".format(**language))

    return results

其他語言

C#： 請按照用戶端程式庫頁面的 C# 設定說明操作， 然後前往 .NET 適用的 Cloud Translation 參考說明文件。

PHP： 請按照用戶端程式庫頁面的 PHP 設定說明 操作，然後前往 PHP 適用的 Cloud Translation 參考說明文件。

Ruby： 請按照用戶端程式庫頁面的 Ruby 設定說明 操作，然後前往 Ruby 適用的 Cloud Translation 參考文件。

其他資源

  • 如需解決常見問題或錯誤的說明，請參閱「疑難排解」頁面。