このページでは、Vision API の Cloud クライアント ライブラリの使用を開始する方法を説明します。クライアント ライブラリを使用すると、サポートされている言語を使用して、Google Cloud APIs に簡単にアクセスできます。サーバーにリクエストを送信して Google Cloud APIs を直接利用することもできますが、クライアント ライブラリを使用すると、記述するコードの量を大幅に削減できます。
Cloud クライアント ライブラリと以前の Google API クライアント ライブラリの詳細については、クライアント ライブラリの説明をご覧ください。
クライアント ライブラリをインストールする
C++
このクライアント ライブラリの要件とインストールの依存関係の詳細については、C++ 開発環境の設定をご覧ください。
C#
Visual Studio 2017 以降を使用している場合は、Nuget パッケージ マネージャーのウィンドウを開き、次のように入力します。Install-Package Google.Apis
.NET Core コマンドライン インターフェースを使用して依存関係をインストールしている場合は、次のコマンドを実行します。
dotnet add package Google.Apis
詳細については、C# 開発環境の設定をご覧ください。
Go
go get cloud.google.com/go/vision/apiv1
詳細については、Go 開発環境の設定をご覧ください。
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
詳細については、Java 開発環境の設定をご覧ください。
Node.js
npm install --save @google-cloud/vision
詳細については、Node.js 開発環境の設定をご覧ください。
PHP
composer require google/apiclient
詳細については、Google Cloud での PHP の使用をご覧ください。
Python
pip install --upgrade google-cloud-vision
詳細については、Python 開発環境の設定をご覧ください。
Ruby
gem install google-api-client
詳細については、Ruby 開発環境の設定をご覧ください。
認証を設定する
Google Cloud APIs の呼び出しを認証するために、クライアント ライブラリではアプリケーションのデフォルト認証情報(ADC)がサポートされています。このライブラリは、一連の定義済みのロケーションの中から認証情報を探し、その認証情報を使用して API へのリクエストを認証します。ADC を使用すると、アプリケーション コードを変更することなく、ローカルでの開発や本番環境など、さまざまな環境のアプリケーションで認証情報を使用できるようになります。本番環境では、ADC の設定方法はサービスとコンテキストによって異なります。詳細については、アプリケーションのデフォルト認証情報を設定するをご覧ください。
ローカル開発環境では、Google アカウントに関連付けられている認証情報を使用して ADC を設定できます。
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
ログイン画面が表示されます。ログインすると、ADC で使用されるローカル認証情報ファイルに認証情報が保存されます。
クライアント ライブラリの使用
次の例は、クライアント ライブラリの使用方法を示しています。
C++
Go
Java
Node.js
Python
補足資料
C++
次のリストは、C++ のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
C#
次のリストは、C# のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Go
次のリストは、Go のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Java
次のリストは、Java のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Node.js
次のリストは、Node.js のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
PHP
次のリストは、PHP のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Python
次のリストは、Python のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Ruby
次のリストは、Ruby のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
追加のクライアント ライブラリ
上記のライブラリに加えて、Java アプリケーションでは Spring Cloud Google Cloud を使用できます。Spring Vision API を使用すると、Spring Framework で作成されたアプリケーションで Cloud Vision を使用できます。
Spring Cloud Vision をアプリケーションに追加する方法をご覧ください。
使ってみる
Google Cloud を初めて使用される方は、アカウントを作成して、実際のシナリオでの Cloud Vision API のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
Cloud Vision API の無料トライアル