# General Translation React SDKs (gt-react, gt-next): getGT
URL: https://generaltranslation.com/ja/docs/react/nextjs/reference/functions/get-gt.mdx
---

title: getGT
description: General Translation を使用して、非同期の Next.js App Router コンポーネント内で単独の文字列を翻訳します。getGT の API リファレンス。

---

`getGT` 関数は、現在の App Router リクエストに対応する非同期の文字列翻訳関数を返します。非同期コンポーネントで [`useGT`](/docs/react/reference/hooks/use-gt) を使用できない場合は、`gt-next/server` からインポートします。

`getGT` はサーバー専用で、Pages Router では動作しません。

## 概要 [#overview]

```tsx
import { getGT } from 'gt-next/server';

const gt = await getGT();
const label = gt('Submit');
```

## 仕組み [#how-it-works]

* **ビルド時の翻訳。** 本番用の翻訳はデプロイ前に準備され、現在のリクエストのロケールに合わせて読み込まれます。
* **開発時の翻訳。** 開発用 API キーを使うことで、開発中にオンデマンド翻訳を利用できます。
* **静的なソース文字列。** compiler が抽出できるように、文字列リテラルを渡してください。
* **変数。** 補間値は翻訳後に挿入されるため、翻訳されません。

## 戻り値 [#returns]

**型** `Promise<(content: string, options?: GTTranslationOptions) => string>`

Promise が解決されると返される関数は、ソース文字列を翻訳し、補間変数に加えて、`$context`、`$id`、`$maxChars` などの [`GTTranslationOptions`](/docs/react/reference/types/inline-translation-options) を受け取ります。

## 例 [#example]

```tsx title="app/contact/page.tsx"
import { getGT } from 'gt-next/server';

export default async function ContactPage() {
  const gt = await getGT();
  return <input aria-label={gt('Email address')} />;
}
```