始めに

このページでは、Cloud Life Sciences API の使用に必要な設定手順について説明します。

クイックスタートを完了している場合は、この手順の一部はすでに完了しています。このページをご覧いただき、Cloud Life Sciences API を使用する準備が整ったことを確認してください)。

始める前に

  1. Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. Cloud Console のプロジェクト セレクタページで、Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタのページに移動

  3. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。 プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  4. Cloud Life Sciences API を有効にします。

    API を有効にする

プロジェクトで最初に Cloud Life Sciences API を有効にした際に、そのプロジェクト用の新しいサービス アカウントに自動的に役割(lifesciences.workflowsRunner)が割り当てられます。この役割によって、プロジェクト内の Compute Engine インスタンスを開始および停止できるようになります。

後で、このデフォルトの役割を関連プロジェクトのサービス アカウントから削除すると、エラーが発生する可能性があります。特に、API を使用してパイプラインを実行しようとすると、権限エラーが発生します。また、API はパイプラインが完了した時点でインスタンスを停止できず、引き続きこのリソースに対する請求が発生します。この問題の修正方法について詳しくは、トラブルシューティングをご覧ください。

Cloud SDK と gcloud コマンドライン ツールを設定する

Cloud SDK をインストールして、Cloud Life Sciences、Compute Engine、Cloud Storage、BigQuery でツールとライブラリを使用します。SDK には gcloudgsutilbq コマンドライン ツールが含まれています。

  1. Cloud SDK をダウンロードしてインストールします。

  2. Cloud SDK を初期化します。

  3. SDK を初期化したら、Cloud Life Sciences コマンドをインストールします。

    gcloud components update beta
    

    gcloud ツールのデフォルト インストールで Compute Engine VM を使用している場合は、コンポーネントを更新できません。Compute Engine VM で Cloud Life Sciences API を有効にするには、次のコマンドを実行して gcloud コマンドライン ツールを再インストールします。

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

API にアクセスするための認証情報のダウンロード

Cloud Life Sciences GitHub リポジトリのコードサンプル、または Cloud Life Sciences API に直接アクセスする gcloud コマンドライン ツール以外のツールを使用している場合は、次の手順を実行してプロジェクトの client_secrets.json ファイルをダウンロードします。

  1. Google アカウントにログインします。

    Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

  2. Cloud Console のプロジェクト セレクタページで、Cloud プロジェクトを選択または作成します。

    プロジェクト セレクタのページに移動

  3. Google Cloud プロジェクトに対して課金が有効になっていることを確認します。 プロジェクトに対して課金が有効になっていることを確認する方法を学習する

  4. Cloud Life Sciences and Cloud Storage JSON API を有効にします。

    API を有効にする

  5. API Console で [認証情報] ページを開きます。
  6. [認証情報を作成] > [OAuth クライアント ID] をクリックします。
  7. アプリケーション タイプを Other に設定し、フォームに入力します。

認証情報を作成したら、Cloud Console の [認証情報] ページに移動し [JSON をダウンロード] をクリックして、client_secret.json ファイルをダウンロードします。file_downloadご使用のアプリケーションだけがアクセスできる場所に、ファイルを安全に保存します。

Cloud Life Sciences API を初めてクエリすると、ダウンロードしたクライアント シークレット ファイルの値を使用して認証されます。この初回認証後、Cloud Life Sciences ツールは後続の API リクエストで使用するトークンを保存します。

次のステップ