En este documento, se describe cómo usar la API de Cloud Translation (v2) para generar una lista de los idiomas admitidos.
Antes de comenzar
Antes de comenzar a usar la API de Cloud Translation, debes tener un proyecto que tenga habilitada esta API y las credenciales adecuadas. También puedes instalar bibliotecas cliente para los lenguajes de programación comunes que te ayudarán a realizar llamadas a la API. Para obtener más información, consulta la página Configuración.
Obtén una lista de los idiomas compatibles
REST
Para obtener una lista de todos los idiomas admitidos, realiza una solicitud GET
al extremo https://translation.googleapis.com/language/translate/v2/languages
.
A continuación, se muestra un ejemplo de una solicitud GET
mediante curl
y PowerShell.
En el ejemplo, se usa el token de acceso correspondiente a la configuración de una cuenta de servicio para el proyecto con Google Cloud CLI. Si deseas obtener instrucciones para instalar gcloud CLI, configurar un proyecto con una cuenta de servicio y obtener un token de acceso, consulta la página Configuración.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER_OR_ID
: el ID numérico o alfanumérico del proyecto de Google Cloud
Método HTTP y URL:
GET https://translation.googleapis.com/language/translate/v2/languages
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "languages": [ { "language": "en" }, { "language": "fr" }, { "language": "zh-CN" } ] }
Esta consulta muestra los códigos de idioma ISO-639 de los idiomas compatibles. Algunos códigos de idioma también incluyen un código de país, como zh-CN o zh-TW. La lista está ordenada alfabéticamente por código de idioma. El ejemplo anterior se acortó debido a restricciones de espacio.
Go
Java
Node.js
Python
Lenguajes adicionales
C#: sigue lasinstrucciones de configuración de C# en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Cloud Translation para .NET.
PHP: sigue las instrucciones de configuración de PHP en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Cloud Translation para PHP.
Ruby: sigue las instrucciones de configuración de Ruby en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Cloud Translation para Ruby.
Obtén una lista de los idiomas compatibles con el nombre del idioma objetivo
REST
Aquí hay otro ejemplo que muestra la lista de idiomas compatibles. Los nombres de idioma mostrados están escritos en un idioma objetivo específico. La lista mostrada está ordenada alfabéticamente según el idioma objetivo.
Para enumerar los idiomas admitidos en un idioma objetivo, realiza una solicitud POST
y proporciona un JSON que identifique el idioma objetivo en el cuerpo de la solicitud. A continuación, se muestra un ejemplo de una solicitud POST
mediante curl
o PowerShell.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_NUMBER_OR_ID
: el ID numérico o alfanumérico del proyecto de Google Cloud
Método HTTP y URL:
POST https://translation.googleapis.com/language/translate/v2/languages
Cuerpo JSON de la solicitud:
{ "target": "zh-TW" }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "data": { "languages": [ { "language": "zh-CN", "name": "中文(簡體)" }, { "language": "fr", "name": "法文" }, { "language": "en", "name": "英文" } ] } }
En este caso, la consulta muestra los mismos códigos de idioma que más arriba, junto con las strings name
que indican los nombres de los idiomas escritos en el idioma objetivo, zh-TW. El ejemplo anterior se acortó debido a restricciones de espacio.
Go
Java
Node.js
Python
Lenguajes adicionales
C#: sigue lasinstrucciones de configuración de C# en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Cloud Translation para .NET.
PHP: sigue las instrucciones de configuración de PHP en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Cloud Translation para PHP.
Ruby: sigue las instrucciones de configuración de Ruby en la página Bibliotecas cliente y, luego, visita la documentación de referencia de Cloud Translation para Ruby.
Recursos adicionales
- Para obtener ayuda en la resolución de errores o problemas habituales, consulta la página Solución de problemas.