このドキュメントでは、プログラムで Cloud Healthcare API を認証する方法について説明します。Cloud Healthcare API に対する認証方法は、API へのアクセスに使用するインターフェース と、コードが実行されている環境によって異なります。
認証の詳細については、 Google Cloud 認証方法をご覧ください。 .
API アクセス
Cloud Healthcare API は、プログラムからのアクセスをサポートしています。次の方法で API にアクセスできます。
クライアント ライブラリ
Google API クライアント ライブラリでは、 Cloud Healthcare API の認証をプログラムで行うための高レベルの言語サポートが提供されます。 API の呼び出しを認証するために、クライアント ライブラリでは アプリケーションのデフォルト認証情報（ADC）がサポートされています。 このライブラリは、一連の定義済みロケーションの中から認証情報を探し、それらの認証情報を使用して API へのリクエストを認証します。 Google Cloud ADC を使用すると、アプリケーション コードを変更することなく、ローカルでの開発や本番環境など、さまざまな環境のアプリケーションで認証情報を使用できるようになります。
Google Cloud CLI
gcloud CLI を使用して Cloud Healthcare API にアクセスする場合は、gcloud CLI コマンドで使用される認証情報を提供する Google アカウントで gcloud CLI にログインします。
組織のセキュリティ ポリシーによってユーザー アカウントに必要な権限が与えられない場合は、サービス アカウントの権限借用を使用できます。
詳細については、gcloud CLI を使用して認証するをご覧ください。Cloud Healthcare API で gcloud CLI を使用する方法については、gcloud CLI のリファレンス ページをご覧ください。
REST
Cloud Healthcare API の認証には、gcloud CLI 認証情報またはアプリケーションのデフォルト認証情報を使用します。REST リクエストの認証の詳細については、REST を使用して認証するをご覧ください。認証情報の種類については、gcloud CLI の認証情報と ADC の認証情報をご覧ください。
Cloud Healthcare API の認証を設定する
認証の設定方法は、コードが実行されている環境によって異なります。
認証の設定には、次のオプションが最も一般的に使用されます。認証のその他のオプションと詳細については、認証方法をご覧ください。
ローカル開発環境の場合
ローカル開発環境の認証情報は、次の方法で設定できます。
クライアント ライブラリまたはサードパーティ ツール
ローカル環境で アプリケーションのデフォルト認証情報（ADC） を設定します。
-
Google Cloud CLI をインストールします。 インストール後、 初期化するには、次のコマンドを実行して Google Cloud CLI を初期化します。
gcloud init外部 ID プロバイダ（IdP）を使用している場合は、まず フェデレーション ID を使用して gcloud CLI にログインする必要があります。
-
ローカルシェルを使用している場合は、ユーザー アカウントのローカル認証情報を作成します。
gcloud auth application-default login
Cloud Shell を使用している場合は、この操作を行う必要はありません。