Autenticarse en Cloud Translation

En este documento se describe cómo autenticarse en Cloud Translation mediante programación. La forma de autenticarte en Cloud Translation depende de la interfaz que uses para acceder a la API y del entorno en el que se ejecute tu código.

Para obtener más información sobre la autenticación, consulta los métodos de autenticación. Google Cloud

Acceso a la API

Cloud Translation admite el acceso mediante programación. Puedes acceder a la API de las siguientes formas:

Bibliotecas de cliente

Las bibliotecas de cliente de Cloud Translation Advanced proporcionan compatibilidad de alto nivel con el lenguaje para autenticarte en Cloud Translation de forma programática. Para autenticar las llamadas a las APIs de Google Cloud , las bibliotecas de cliente admiten las credenciales predeterminadas de la aplicación (ADC). Las bibliotecas buscan credenciales en un conjunto de ubicaciones definidas y las usan para autenticar las solicitudes a la API. Con ADC, puede poner las credenciales a disposición de su aplicación en diversos entornos, como el desarrollo local o la producción, sin necesidad de modificar el código de la aplicación.

REST

Puedes autenticarte en la API Cloud Translation mediante tus credenciales de gcloud CLI o con las credenciales predeterminadas de la aplicación. Para obtener más información sobre la autenticación de solicitudes REST, consulta el artículo Autenticación para usar REST. Para obtener información sobre los tipos de credenciales, consulta Credenciales de la CLI de gcloud y credenciales de ADC.

Claves de API

Las claves de API permiten asociar una llamada a una API con un proyecto, que se usa con fines de facturación y de cuota, sin determinar la identidad de la persona que llama. Las claves de API solo se pueden usar con métodos de API que las admitan.

Cloud Translation admite claves de API para los siguientes métodos de API:

  • Todos los métodos de la API Cloud Translation - Basic (versión 2) admiten claves de API, como translate y detect. La API Cloud Translation Advanced (versión 3) no admite claves de API.

Para obtener información general sobre el uso de claves de API, consulta Autenticar mediante claves de API.

Credenciales de usuario y ADC para Cloud Translation

Una forma de proporcionar credenciales a ADC es usar la CLI de gcloud para insertar tus credenciales de usuario en un archivo de credenciales. Este archivo se coloca en el sistema de archivos local, donde ADC puede encontrarlo. A continuación, ADC usa las credenciales de usuario proporcionadas para autenticar las solicitudes. Este método se suele usar para el desarrollo local.

Si utilizas este método, es posible que se produzca un error de autenticación al intentar autenticarte en Cloud Translation. Para obtener más información sobre este error y cómo solucionarlo, consulta el artículo Las credenciales de usuario no funcionan.

Configurar la autenticación para Cloud Translation

La forma de configurar la autenticación depende del entorno en el que se ejecute el código.

Estas son las opciones más habituales para configurar la autenticación. Para obtener más opciones e información sobre la autenticación, consulta Métodos de autenticación.

Antes de seguir estas instrucciones, debes completar la configuración básica de Cloud Translation, tal como se describe en el artículo Configurar Cloud Translation.

En un entorno de desarrollo local

Puedes configurar las credenciales de un entorno de desarrollo local de las siguientes formas:

Bibliotecas de cliente o herramientas de terceros

Configura las credenciales predeterminadas de la aplicación (ADC) en tu entorno local:

  1. Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

    gcloud init