このページでは、Vision API の Cloud クライアント ライブラリの使用を開始する方法を説明します。以前の Google API クライアント ライブラリをはじめ、Cloud API のクライアント ライブラリの詳細については、クライアント ライブラリの説明をご覧ください。
クライアント ライブラリのインストール
C#
詳細については、C# 開発環境の設定をご覧ください。
Install-Package Google.Cloud.Vision.V1 -Pre
Go
詳細については、Go 開発環境の設定をご覧ください。
go get -u cloud.google.com/go/vision/apiv1
Java
詳細については、Java 開発環境の設定をご覧ください。
Maven を使用している場合は、次のものを pom.xml
ファイルに追加します。BOM の詳細については、Google Cloud Platform ライブラリ BOM をご覧ください。
Gradle を使用している場合は、次のものを依存関係に追加します。
sbt を使用している場合は、次のものを依存関係に追加します。
IntelliJ または Eclipse を使用している場合は、次の IDE プラグインを使用してプロジェクトにクライアント ライブラリを追加できます。
プラグインでは、サービス アカウントのキー管理などの追加機能も提供されます。詳細は各プラグインのドキュメントをご覧ください。
Node.js
詳細については、Node.js 開発環境の設定をご覧ください。
npm install --save @google-cloud/vision
PHP
詳細については、Google Cloud での PHP の使用をご覧ください。
composer require google/cloud-vision
Python
詳細については、Python 開発環境の設定をご覧ください。
pip install --upgrade google-cloud-vision
Ruby
詳細については、Ruby 開発環境の設定をご覧ください。
gem install google-cloud-vision
認証の設定
クライアント ライブラリを実行するには、サービス アカウントを作成して環境変数を設定し、認証を設定する必要があります。以下の手順で認証を設定します。その他の認証方法については、GCP 認証のドキュメントをご覧ください。
Cloud Console
-
Cloud Console で、[サービス アカウント キーの作成] ページに移動します。
[サービス アカウント キーの作成] ページに移動 - [サービス アカウント] リストから [新しいサービス アカウント] を選択します。
- [サービス アカウント名] フィールドに名前を入力します。
- [ロール] リストから値を選択しないでください。このサービスにアクセスするために必要なロールはありません。
- [作成] をクリックします。このサービス アカウントにはロールがないという警告メッセージが表示されます。
- [ロールなしで作成] をクリックします。キーが含まれている JSON ファイルがパソコンにダウンロードされます。
コマンドライン
ローカルマシン上の Cloud SDK を使用するか、または Cloud Shell 内で以下のコマンドを実行できます。
-
サービス アカウントを作成します。NAME をサービス アカウントの名前に置き換えます。
gcloud iam service-accounts create NAME
-
キーファイルを生成します。FILE_NAME はキーファイルの名前に置き換えてください。
gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com
環境変数 GOOGLE_APPLICATION_CREDENTIALS
を設定して、アプリケーション コードに認証情報を指定します。[PATH] は、サービス アカウント キーが含まれる JSON ファイルのファイルパスに置き換えます。この変数は現在のシェル セッションにのみ適用されるため、新しいセッションを開く場合は、変数を再度設定します。
Linux または macOS
export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
例:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
Windows
PowerShell を使用する場合:
$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
例:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"
コマンド プロンプトを使用する場合:
set GOOGLE_APPLICATION_CREDENTIALS=[PATH]
クライアント ライブラリの使用
次の例は、クライアント ライブラリの使用方法を示しています。
C#
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある C# の設定手順を行ってください。詳細については、Vision C# API のリファレンス ドキュメントをご覧ください。
Go
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Go の設定手順を行ってください。詳細については、Vision Go API のリファレンス ドキュメントをご覧ください。
Java
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Java の設定手順を行ってください。詳細については、Vision Java API のリファレンス ドキュメントをご覧ください。
Node.js
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Node.js の設定手順を行ってください。詳細については、Vision Node.js API のリファレンス ドキュメントをご覧ください。
PHP
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある PHP の設定手順を行ってください。詳細については、Vision PHP API のリファレンス ドキュメントをご覧ください。
Python
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Python の設定手順を行ってください。詳細については、Vision Python API のリファレンス ドキュメントをご覧ください。
Ruby
このサンプルを試す前に、Vision クイックスタート: クライアント ライブラリの使用にある Ruby の設定手順を行ってください。詳細については、Vision Ruby API のリファレンス ドキュメントをご覧ください。
補足資料
C#
Go
Java
Node.js
PHP
Python
Ruby
追加のクライアント ライブラリ
上記のライブラリに加えて、Java アプリケーションでは Spring Cloud GCP を使用できます。Spring Vision API を使用すると、Spring Framework で作成されたアプリケーションで Cloud Vision を使用できます。
Spring Cloud Vision をアプリケーションに追加する方法をご覧ください。