クイックスタート

このクイックスタートでは、以下の処理を順に行います。

• Cloud Storage のバケットを作成する
• 画像を Cloud Storage にアップロードして公開する
• その画像を Vision API にリクエストに指定して送信する

これらの手順を行うための所要時間は約 5 分です。Cloud Storage には 5 GB まで無料でデータを格納でき、1 か月に Vision API に機能リクエストを 1,000 回まで無料で行うことができます。

始める前に

まだ、プロジェクトを設定しておらず、Google Cloud Storage バケットを作成していない場合は、次の説明に沿ってこれらの作業を行います。

プロジェクトを設定する

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

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

2. GCP Console で [リソースの管理] ページに移動し、既存のプロジェクトを選択するか、新しいプロジェクトを作成します。

   注: このチュートリアルで作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの完了後にそのプロジェクトを削除すれば、プロジェクトとチュートリアルに関連するすべてのリソースを削除できます。

   [リソースの管理] ページに移動

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

   課金を有効にする方法について

{% dynamic if "no_credentials" in setvar.task_params %}{% dynamic setvar credential_type %}NO_AUTH{% dynamic endsetvar %}{% dynamic if not setvar.redirect_url %}{% dynamic setvar redirect_url %}https://console.cloud.google.com{% dynamic endsetvar %}{% dynamic endif %}{% dynamic endif %}{% dynamic if setvar.in_henhouse_no_auth_whitelist %}{% dynamic if not setvar.credential_type %}{% dynamic setvar credential_type %}NO_AUTH{% dynamic endsetvar %}{% dynamic endif %}{% dynamic elif setvar.in_henhouse_service_account_whitelist %}{% dynamic if not setvar.credential_type %}{% dynamic setvar credential_type %}SERVICE_ACCOUNT{% dynamic endsetvar %}{% dynamic endif %}{% dynamic endif %}{% dynamic if not setvar.service_account_roles and setvar.credential_type == "SERVICE_ACCOUNT" %}{% dynamic setvar service_account_roles %}{% dynamic endsetvar %}{% dynamic endif %}{% dynamic setvar console %}{% dynamic if "no_steps" not in setvar.task_params %}
4. {% dynamic endif %}{% dynamic if setvar.api_list %}{% dynamic if setvar.in_henhouse_no_auth_whitelist or setvar.in_henhouse_service_account_whitelist %}GCP Console プロジェクトをセットアップします。

   プロジェクトをセットアップする

   クリックして、以下を行います。

   • プロジェクトを作成または選択します。
   • プロジェクトに{% dynamic if setvar.api_names %}{% dynamic print setvar.api_names %}{% dynamic else %}必要な{% dynamic endif %}{% dynamic if "," in setvar.api_list %} API{% dynamic elif "API" in setvar.api_names %}{% dynamic else %} API{% dynamic endif %} を有効にします。
   {% dynamic if setvar.credential_type == 'SERVICE_ACCOUNT' %}
   • サービス アカウントを作成します。
   • JSON として秘密鍵をダウンロードします。
   {% dynamic endif %}

   これらのリソースは、GCP Console でいつでも表示および管理できます。

   {% dynamic else %}{% dynamic if "no_text" not in setvar.task_params %}{% dynamic if setvar.api_names %}{% dynamic print setvar.api_names %}{% dynamic else %}必要な{% dynamic endif %}{% dynamic if "," in setvar.api_list %} API{% dynamic elif "API" in setvar.api_names %}{% dynamic else %} API{% dynamic endif %} を有効にします。 {% dynamic endif %}

   {% dynamic if "," in setvar.api_list %}API{% dynamic else %}API{% dynamic endif %}を有効にする

   {% dynamic endif %}{% dynamic endif %}{% dynamic if "no_steps" not in setvar.task_params %}
{% dynamic endif %}{% dynamic endsetvar %}{% dynamic print setvar.console %}

Cloud Storage バケットを作成する

1. GCP Console で、Cloud Storage ブラウザに移動します。

   Cloud Storage ブラウザに移動

2. [バケットを作成] をクリックします。
3. [バケットを作成] ダイアログ内で、以下の属性を指定します。
   • 名前: 一意のバケット名。バケットの名前空間は、全世界で、誰もが見られるようになっていますので、機密情報をバケット名に含めないようにしてください。
   • ストレージ クラス: Multi-Regional
   • バケットデータが保存されるロケーション。
4. [作成] をクリックします。

Cloud Vision API サービスへのリクエストを行う

1. demo-image.jpg をダウンロードします。（場合によってはリンクを右クリックする必要があります）。

2. GCP Console Storage ブラウザを開きます。

3. 前のセクションで作成したバケットを選択します。

4. [ファイルをアップロード] をクリックし、ローカルマシンから Cloud Storage バケットにアップロードする demo-image.jpg ファイルを選択します。

   

   これがアップロードした画像ファイルです。

   

5. ファイルがアップロードされ、Cloud Storage ブラウザに一覧表示されたら、画像を公開します。

6. image.source.imageUri フィールド内の bucket-name-123 を、demo-image.jpg ファイルのアップロード場所である Cloud Storage バケットに置き換えて、以下の対話型 API Explorer テンプレートを完成させます。

7. [実行] をクリックして、リクエストをサービスに送信します。JSON レスポンスが上に表示されます。

これで、Cloud Vision API サービスへの最初の images.annotate リクエストを実行しました。

クリーンアップ

不要な Google Cloud Platform の課金を避けるため、作成した Cloud Storage バケットおよびプロジェクトが不要な場合は、GCP Console を使用してそれらを削除してください。

次のステップ

• Cloud Vision API クライアント ライブラリを使用し、言語を選択して Cloud Vision API の使用を開始します。
• 入門ガイドを参照します。
• サンプルとチュートリアルを参照する。