Marcação da API Translation

A API Cloud Translation é disponibilizada para qualquer um que queira integrar o próprio site ou aplicativo a ela. O uso dessas APIs é regido pelos Termos de Serviço. Entre outras coisas, esses Termos exigem a adesão a certas diretrizes sobre como o texto resultante precisa ser exibido no seu site. A finalidade deste documento e dos Requisitos de atribuição é ajudar você a atender a essas exigências.

Se os resultados inalterados da Cloud Translation API forem publicados e pesquisados na Web, indique o texto como conteúdo traduzido automaticamente. Isso é obrigatório para que o Google e outros mecanismos de pesquisa possam diferenciar textos originais e traduzidos.

Em pequenos snippets ou seções dentro de um documento HTML

Delimite o texto traduzido em um <div lang="..."></div> (para blocos) ou <span lang="..."></span> (para fragmentos in-line) e defina o atributo lang="" como o código de idioma apropriado. Siga este formato:

  • Use o formato a seguir para definir lang="": <código do idioma de chegada>-x-mtfrom-<código do idioma de origem>.
  • Por exemplo, para um texto em francês que foi traduzido automaticamente do inglês, a tag HTML será: <span lang="fr-x-mtfrom-en">Bonjour</span> ou <div lang="fr-x-mtfrom-en"> Bonjour </div>.
  • Se o idioma de origem ou o de chegada for desconhecido, use a especificação de idioma "und" para indicar idioma indeterminado. Por exemplo, <span lang="und-x-mtfrom-und"> … </span> indica idiomas de origem ou de chegada indeterminados.

  • Se preferir, insira um atributo lang="" em qualquer elemento que já una o texto traduzido. Por exemplo, se os resultados inalterados da API Cloud Translation estiverem em um parágrafo <p>, coloque o lang="" em </p>, como em <p lang="ar-x-mtfrom-jp"> para texto traduzido do japonês para o árabe.

Em documentos inteiros ou páginas da Web

Para uma página inteira, quando o documento original não estiver disponível on-line ou o URL do documento original ainda for desconhecido, insira o atributo lang="" conforme descrito na seção anterior sobre o elemento <html>:

<DOCTYPE HTML>
  <html lang="en-x-mtfrom-fr">
    <head>
      <title>The Bee</title>
        ...

Em uma página inteira, quando o documento original estiver disponível on-line, insira um elemento <link> no <head> do documento HTML, com o atributo rel="" definido como "alternate machine-translated-from", hreflang="" configurado como o código de idioma original e href="" configurado para a página original. Por exemplo:

<DOCTYPE HTML>
  <html lang="en-x-mtfrom-fr">
    <head>
      <title>The Bee</title>
      <link rel="alternate machine-translated-from" hreflang="fr"
            href="http://fr.example.com/abeille.html">
    </head>
    <body>
        ...

O código HTML acima especifica que esta página foi traduzida automaticamente do francês para o inglês, e que o documento original em francês está no local fictício http://fr.example.com/abeille.html.

Para mais informações, os códigos de idiomas são descritos abaixo: