# General Translation Platform: TranslateManyEntry
URL: https://generaltranslation.com/zh/docs/platform/core/reference/types/translate-many-entry.mdx
---

title: TranslateManyEntry
description: "`translate` 和 `translateMany` 条目的输入结构。TranslateManyEntry 类型的 API 参考。"

---

`TranslateManyEntry` 是 [`translate`](/docs/platform/core/reference/gt-class-methods/translation/translate) 和 [`translateMany`](/docs/platform/core/reference/gt-class-methods/translation/translate-many) 接受的输入类型。它可以是普通字符串，也可以是包含源内容和可选元数据的对象。

## 概览 [#overview]

`TranslateManyEntry` 是一种联合类型：可以传入一个纯字符串，按原样翻译；也可以传入一个包含 `source` 和可选 `metadata` 的对象，以便进行更细致的控制。

```typescript
type TranslateManyEntry = string | { source: Content; metadata?: EntryMetadata };
```

## 成员 [#members]

| 成员                | 描述          | 类型       |
| ----------------- | ----------- | -------- |
| [String](#string) | 纯字符串，直接翻译。  | `string` |
| [Object](#object) | 源内容，可附带元数据。 | `object` |

### 字符串 [#string]

**类型** `string`

最简单的形式。普通字符串会直接被翻译：

```typescript
'Hello, world!'
```

### 对象 [#object]

**类型** `object`

一个包含 `source` 和可选 `metadata` 的对象：

| 属性         | 说明           | 类型                                                                    | 可选 |
| ---------- | ------------ | --------------------------------------------------------------------- | -- |
| `source`   | 要翻译的源内容。     | [`Content`](/docs/platform/core/reference/types/content)              | 否  |
| `metadata` | 用于自定义翻译的元数据。 | [`EntryMetadata`](/docs/platform/core/reference/types/entry-metadata) | 是  |

`source` 可接受任意 [`Content`](/docs/platform/core/reference/types/content) 值：

```typescript
type Content = JsxChildren | IcuMessage | StringMessage | I18nextMessage;
```

## 示例 [#example]

```typescript
import { GT } from 'generaltranslation';

const gt = new GT({ apiKey: 'your-api-key', projectId: 'your-project-id' });

// 单个字符串
const result = await gt.translate('Hello, world!', 'es');

// 字符串数组
const results = await gt.translateMany(['Home', 'About', 'Contact'], 'es');
```

```typescript
import { GT } from 'generaltranslation';
import { TranslateManyEntry } from 'generaltranslation/types';

const gt = new GT({ apiKey: 'your-api-key', projectId: 'your-project-id' });

const entries: TranslateManyEntry[] = [
  { source: 'Hello, world!' },
  {
    source: '{count, plural, other {{count} items}}',
    metadata: {
      dataFormat: 'ICU',
      context: 'Item count display'
    }
  }
];

const results = await gt.translateMany(entries, { targetLocale: 'es' });
```