このガイドでは、Natural Language の使用開始に必要な設定手順をすべて説明します。
Google Cloud コンソールについて
Google Cloud コンソールは、Google Cloud プロダクトを使用するシステムのプロビジョニング、構成、管理、モニタリングに使用されるウェブ UI です。Google Cloud コンソールを使用して、Natural Language リソースの設定と管理を行います。
プロジェクトを作成する
Google Cloud が提供するサービスを使用するには、プロジェクトを作成する必要があります。
プロジェクトを使用して、すべての Google Cloud のリソースがまとめられます。プロジェクトは、次のコンポーネントから構成されます。
- 共同編集者
- 有効な API とその他のリソース
- モニタリング ツール
- 課金情報
- 認証とアクセス制御
1 つのプロジェクトを作成できるほか、複数のプロジェクトを作成してリソース階層内で Google Cloud リソースを構成することもできます。プロジェクトの詳細については、Resource Manager ドキュメントをご覧ください。
Google Cloud Console の [プロジェクト セレクタ] ページで、Google Cloud プロジェクトを選択または作成します。
課金を有効にする
請求先アカウントは、特定のリソースセットに対する支払いをだれが行うかの定義に使用され、1 つ以上のプロジェクトにリンクできます。プロジェクトの利用料金は、リンクされた請求先アカウントに請求されます。ほとんどの場合、プロジェクトの作成時に請求情報を構成します。詳細については、お支払いとご請求に関するドキュメントをご覧ください。
Google Cloud プロジェクトで課金が有効になっていることを確認します。
API を有効にする
Cloud Natural Language API をプロジェクトで有効にする必要があります。API の有効化の詳細については、Service Usage のドキュメントをご覧ください。
Cloud Natural Language API を有効にします。
gcloud CLI をインストールして初期化する
Natural Language API を使用する場合は、gcloud CLI をインストールして初期化する必要があります。gcloud CLI は、Google Cloud でホストされるリソースとアプリケーションの管理に使用できるツールのセットです。これには gcloud CLI が含まれます。次のリンクで手順を説明します。
Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。
gcloud init
認証の設定
API を使用するクライアント アプリケーションはすべて、認証の対象であり、リクエストされるリソースへのアクセス権が付与されている必要があります。認証の設定方法は、ローカル開発環境で作業しているか、本番環境を設定しているのかによって異なります。詳細については、アプリケーションのデフォルト認証情報を設定するをご覧ください。
API へのアクセス方法に応じてタブを選択してください。
gcloud
Google Cloud CLI をインストールし、次のコマンドを実行して初期化します。
gcloud init
C#
このページの .NET サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
Go
このページの Go サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
Java
このページの Java サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
Node.js
このページの Node.js サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
PHP
このページの PHP サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
Python
このページの Python サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
Ruby
このページの Ruby サンプルをローカル開発環境から使用するには、gcloud CLI をインストールして初期化し、自身のユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定してください。
- Google Cloud CLI をインストールします。
-
gcloud CLI を初期化するには:
gcloud init
-
Google アカウントのローカル認証情報を作成します。
gcloud auth application-default login
詳細については、Google Cloud の認証に関するドキュメントのローカル開発環境の認証の設定をご覧ください。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
本番環境の認証の設定については、Google Cloud の認証に関するドキュメントの Google Cloud で実行するコードのためのアプリケーションのデフォルト認証情報を設定する をご覧ください。
Natural Language API クライアント ライブラリをインストールする
Natural Language API を呼び出すには、3 通りの方法があります。
クライアント ライブラリは複数のよく使われている言語で利用できます。クライアント ライブラリのインストールについては、Cloud Natural Language クライアント ライブラリをご覧ください。
ロールについて
Cloud Natural Language API へのアクセスにロールは必要ありません。認証済みのユーザーまたはアプリケーションは、権限に関係なく API を呼び出せます。