Comenzar

Esta página te guiará a través de los pasos de configuración necesarios para usar la API de Cloud Life Sciences.

(Si completaste la Guía de inicio rápido, ya realizaste alguno de estos pasos. Revisa esta página a fin de asegurarte de que estás listo para usar la API de Cloud Life Sciences).

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página Selector de proyectos de Cloud Console, selecciona o crea un proyecto de Cloud.

    Ir a la página Selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud. Obtén información sobre cómo confirmar que tienes habilitada la facturación para tu proyecto.

  4. Habilita la API de Cloud Life Sciences.

    Habilita la API

Cuando habilitas por primera vez la API de Cloud Life Sciences en un proyecto, una cuenta de servicio nueva recibe automáticamente la función de lifesciences.workflowsRunner, que le permite iniciar y detener instancias de Compute Engine dentro del proyecto.

Si luego quitas esta función predeterminada de la cuenta de servicio del proyecto pertinente es posible que se produzcan errores. En particular, los intentos de ejecutar las canalizaciones con la API generarán errores de permiso. La API tampoco podrá cerrar las instancias en ejecución cuando se completen las canalizaciones y se continuarán facturando estos recursos. Para obtener detalles sobre cómo solucionar este problema, consulta Solución de problemas.

Configura el SDK de Cloud y la herramienta de línea de comandos de gcloud

Instala el SDK de Cloud para usar las herramientas y bibliotecas en Cloud Life Sciences, Compute Engine, Cloud Storage y BigQuery. El SDK incluye las herramientas de línea de comandos gcloud, gsutil y bq.

  1. Instala y descarga el SDK de Cloud.

  2. Inicializa el SDK de Cloud.

  3. Después de inicializar el SDK, instala los comandos de Cloud Life Sciences:

    gcloud components update beta
    

    Si usas una VM de Compute Engine con la instalación predeterminada de la herramienta gcloud, no podrás actualizar los componentes. Para habilitar la API de Cloud Life Sciences en una VM de Compute Engine, vuelve a instalar la herramienta de línea de comandos de gcloud; para ello, ejecuta los siguientes comandos:

    sudo apt-get remove google-cloud-sdk
        curl https://sdk.cloud.google.com | bash
        exec -l $SHELL
        gcloud init
    

Descarga credenciales para el acceso a la API

Si estás usando una muestra de código del repositorio de GitHub de Cloud Life Sciences o una herramienta que no sea la herramienta de línea de comandos de gcloud, que accede directamente a la API de Cloud Life Sciences, realiza los siguientes pasos a fin de descargar un archivo client_secrets.json para tu proyecto.

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página Selector de proyectos de Cloud Console, selecciona o crea un proyecto de Cloud.

    Ir a la página Selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud. Obtén información sobre cómo confirmar que tienes habilitada la facturación para tu proyecto.

  4. Habilita las API de Cloud Life Sciences and Cloud Storage JSON.

    Habilita las API

  5. Abre la página Credenciales en la consola de API.
  6. Haz clic en Crear credenciales > ID de cliente de OAuth.
  7. Configura el tipo de aplicación como Other y completa el formulario.

Después de crear tus credenciales, descarga el archivo client_secret.json. Para ello, ve a la página Credenciales en Cloud Console y haz clic en Descargar JSONfile_download. Almacena el archivo de forma segura en una ubicación a la que solo pueda acceder tu aplicación.

La primera vez que consultes la API de Cloud Life Sciences, te autenticarás con los valores del archivo de secretos del cliente que descargaste. Después de esta autenticación inicial, las herramientas de Cloud Life Sciences guardan un token para utilizar durante las solicitudes a la API posteriores.

Qué sigue