Java Idiomatic Client para la traducción de la nube.
? En octubre de 2022, esta biblioteca se mudó a Google-Cloud-Java/Java-Translate. Este repositorio será archivado en el futuro. Las versiones futuras aparecerán en el nuevo repositorio (https://github.com/googleapis/google-cloud-java/releases). Las coordenadas Maven Artifact ( com.google.cloud:google-cloud-translate
) siguen siendo las mismas.
Si está utilizando Maven con BOM, agregue esto a su archivo pom.xml:
< dependencyManagement >
< dependencies >
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >libraries-bom</ artifactId >
< version >26.1.3</ version >
< type >pom</ type >
< scope >import</ scope >
</ dependency >
</ dependencies >
</ dependencyManagement >
< dependencies >
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >google-cloud-translate</ artifactId >
</ dependency >
</ dependencies >
Si está utilizando Maven sin BOM, agregue esto a sus dependencias:
< dependency >
< groupId >com.google.cloud</ groupId >
< artifactId >google-cloud-translate</ artifactId >
< version >2.3.5</ version >
</ dependency >
Si está utilizando Gradle 5.x o posterior, agregue esto a sus dependencias:
implementation platform( ' com.google.cloud:libraries-bom:26.1.4 ' )
implementation ' com.google.cloud:google-cloud-translate '
Si está utilizando Gradle sin BOM, agregue esto a sus dependencias:
implementation ' com.google.cloud:google-cloud-translate:2.6.0 '
Si está utilizando SBT, agregue esto a sus dependencias:
libraryDependencies + = " com.google.cloud " % " google-cloud-translate " % " 2.6.0 "
Consulte la sección de autenticación en el ReadMe del directorio base.
Las llamadas de API de la aplicación del cliente deben recibir la autorización de la autorización necesarias para las API deseadas de traducción en la nube, y el principal autenticado debe tener los roles IAM necesarios para acceder a los recursos de GCP utilizando las llamadas API de traducción en la nube.
Necesitará un proyecto de consola de plataforma de Google Cloud con la API de traducción en la nube habilitada. Deberá habilitar la facturación para usar la traducción de Google Cloud. Siga estas instrucciones para configurar su proyecto. También deberá configurar el entorno de desarrollo local instalando el SDK de Google Cloud y ejecutando los siguientes comandos en la línea de comandos: gcloud auth login
y gcloud config set project [YOUR PROJECT ID]
.
Deberá obtener la biblioteca google-cloud-translate
. Consulte la sección QuickStart para agregar google-cloud-translate
como una dependencia en su código.
La traducción en la nube puede traducir dinámicamente el texto entre miles de pares de idiomas. La traducción permite que los sitios web y programas se integren programáticamente con el servicio de traducción.
Consulte los documentos de la biblioteca de clientes de traducción en la nube para aprender a usar esta biblioteca de clientes de traducción en la nube.
TranslateExample
es una interfaz de línea de comandos simple que proporciona parte de la funcionalidad de Google Translation.
Para realizar solicitudes autenticadas a la traducción de Google, debe crear un objeto de servicio con credenciales o usar una clave API. La forma más sencilla de autenticar es usar credenciales predeterminadas de la aplicación. Estas credenciales se infieren automáticamente de su entorno, por lo que solo necesita el siguiente código para crear su objeto de servicio:
import com . google . cloud . translate . Translate ;
import com . google . cloud . translate . TranslateOptions ;
Translate translate = TranslateOptions . getDefaultInstance (). getService ();
Observe que este código también se puede usar con una clave API. Por defecto, se busca una clave API en la variable de entorno GOOGLE_API_KEY
. Una vez que se establece la clave API, puede hacer llamadas de API invocando métodos en el servicio de traducción creado a través de TranslateOptions.getDefaultInstance().getService()
.
También puede establecer explícitamente la tecla API de la siguiente manera:
Translate translate = TranslateOptions . newBuilder (). setApiKey ( "myKey" ). build (). getService ();
Con la traducción de Google puede detectar el lenguaje de algún texto. El servicio le proporcionará el código del lenguaje detectado y un nivel de confianza.
Agregue la siguiente importación en la parte superior de su archivo:
import com . google . cloud . translate . Detection ;
Luego elija una muestra de texto:
final String mysteriousText = "Hola Mundo" ;
Luego agregue el siguiente código para detectar el idioma del texto:
Detection detection = translate . detect ( mysteriousText );
String detectedLanguage = detection . getLanguage ();
La traducción de Google le permite traducir algún texto. Al traducir uno o más textos, puede proporcionar el idioma de origen o dejar que el servicio lo detecte para usted.
Agregue las siguientes importaciones en la parte superior de su archivo:
import com . google . cloud . translate . Translate . TranslateOption ;
import com . google . cloud . translate . Translation ;
Luego agregue el siguiente código para traducir el texto, especificando el idioma detectado previamente ( detectedLanguage
) como su idioma de origen e inglés como idioma de destino (siempre que el idioma de origen sea opcional, si no se especifica, el servicio intentará detectarlo automáticamente) :
Translation translation = translate . translate (
mysteriousText ,
TranslateOption . sourceLanguage ( detectedLanguage ),
TranslateOption . targetLanguage ( "en" ));
En DetectLanguageAndtranslate.java, armamos todo el código que se muestra arriba en un programa. El programa supone que las credenciales predeterminadas de la aplicación o una clave API válida están disponibles.
Las muestras están en las samples/
directorio.
Muestra | Código fuente | Probar |
---|---|---|
Muestra de inicio rápido | código fuente | |
Traducir texto con glosario y modelo | código fuente | |
Documento de traducción por lotes | código fuente | |
Traducir documento | código fuente |
Para obtener ayuda, siga las instrucciones en el documento de solución de problemas compartidos.
La traducción de la nube utiliza GRPC y HTTP/JSON para la capa de transporte.
Se requiere Java 8 o superior para usar este cliente.
Las bibliotecas de clientes Java de Google, las bibliotecas de clientes de Google Cloud y las bibliotecas de API de Google Cloud, sigan la Hoja de ruta de soporte de Oracle Java SE (consulte la sección de lanzamientos de productos Oracle Java SE).
En general, el desarrollo de nuevos características ocurre con el soporte para la versión Java LTS más baja cubierta por el principal soporte de Oracle (que generalmente dura 5 años desde la disponibilidad general inicial). Si se cambia el mínimo requerido JVM para una biblioteca determinada, se acompaña de un lanzamiento importante de Semver.
Java 11 y (en septiembre de 2021) Java 17 son las mejores opciones para el nuevo desarrollo.
Google prueba sus bibliotecas de clientes con todas las versiones LTS actuales cubiertas por el soporte extendido de Oracle (que generalmente dura 8 años desde la disponibilidad general inicial).
Las bibliotecas de clientes de Google admiten versiones heredadas de Java Runtimes con bibliotecas estables a largo plazo que no reciben actualizaciones de características sobre la base de los mejores esfuerzos, ya que puede no ser posible respaldar todos los parches.
Google proporciona actualizaciones sobre la base de los mejores esfuerzos a las aplicaciones que continúan usando Java 7, aunque las aplicaciones pueden necesitar actualizar a las versiones actuales de la biblioteca que admite su JVM.
Las últimas versiones y las versiones Java compatibles se identifican en el repositorio individual de GitHub github.com/GoogleAPIs/java-SERVICENAME
y en google-cloud-java.
Esta biblioteca sigue el versículo semántico.
Las contribuciones a esta biblioteca siempre son bienvenidas y muy alentadas.
Vea contribuir para más información sobre cómo comenzar.
Tenga en cuenta que este proyecto se publica con un código de conducta de contribuyentes. Al participar en este proyecto, acepta cumplir con sus términos. Consulte el Código de conducta para obtener más información.
Apache 2.0 - Consulte la licencia para obtener más información.
Versión java | Estado |
---|---|
Java 8 | |
Java 8 OSX | |
Java 8 Windows | |
Java 11 |
Java es una marca registrada de Oracle y/o sus afiliados.