问题排查

如何让 Cloud Translation 高级版了解哪些内容不需要翻译？

您可以使用以下 HTML 标记：

<span translate="no"> </span>
<span class="notranslate"> </span>

若要使用此功能，必须采用 HTML 格式提交源文本（mimeType 必须为 text/html）。以 text/plain 形式发送内容时，您无法选择性地忽略细分。

为什么译文中会添加 style 特性 (Attribute) 以及 text-align 和 direction CSS 属性 (Property)？

如果请求翻译的文本包含 HTML 格式，并且您是在以下两种语言之间进行翻译，那么就会发生这种情况：即将从右向左的语言翻译成从左向后的语言，或将从左向右的语言翻译成从右向左的语言。在翻译中加入 HTML style 特性以及 text-align 和 direction CSS 属性是为了确保按照正确的方向翻译文本。例如，将 <h2>Sample text</h2> 从英语翻译为希伯来语时，系统将返回以下 JSON 代码：

{
  "data": {
    "translations": [
      {
        "translatedText": "\u003ch2 style=\";text-align:right;direction:rtl\"\u003e טקסט לדוגמה (דברים) \u003c/h2\u003e"
      }
    ]
  }
}

我在调用此 API 时遇到 HTTP 403 错误。

您的结算账号可能存在问题（例如信用卡已过期），或者您可能超出了每日计费总量或每分钟字符数的配额。如果超出每日限制，您会收到 Daily Limit Exceeded 错误，如果超出每分钟字符数配额，则会收到 User Rate Limit Exceeded 错误。

如需查看项目的结算状态，请参阅 Cloud Billing 文档中的验证项目的结算状态。

如需查看或更改项目的用量配额，请访问 Google Cloud 控制台中的“配额”页面。

此 API 有时返回 HTTP 500 (Internal Errors) 响应

如果您在提交文本时没有指定源语言，则可能会发生这种情况。如果 Google 无法确定给定文本的源语言（通常是因为文本太短），我们将返回 500。要解决这种情况，明确指定源语言即可。

我可以在一个请求中指定多个目标语言吗？

您可以在批量请求中提供最多十种目标语言。如果您没有发出批量请求，则只能使用您的请求指定单一目标语言。

能否为一个单词提供多种翻译？

不能。您只能通过网页界面 (translate.google.com) 使用此功能。

对于原生 PDF 文档翻译，输出内容包含叠加在源文本上的译文。

Cloud Translation 不会移除底层文本，从而导致阴影文本。如需了解详情，请参阅翻译文档。

对于扫描的 PDF 文档翻译，翻译不适用于源文本不是水平方向的页面。

如果文本不是水平方向，则 Cloud Translation 无法正确解析要翻译的文本。您可以启用自动旋转功能，以便文本在翻译之前正确确定方向。如需了解详情，请参阅翻译文档。