Cloud Code で Cloud クライアント ライブラリを使用する

Cloud Code で Cloud クライアント ライブラリを使用する

このページでは、Cloud クライアント ライブラリと Cloud Code をすぐに使い始める方法について説明します。Hello World サンプル アプリケーションを使用して新しい Kubernetes アプリケーションを設定し、Cloud Translation API を使用してレスポンスをスペイン語に翻訳するようにアプリケーションを更新します。

始める前に

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Google Kubernetes Engine and Cloud Translation APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Google Kubernetes Engine and Cloud Translation APIs.

   Enable the APIs

8. Git をインストールして、Cloud Code がサンプルのクローン作成などの Git オペレーションを実行できるようにします。
9. Cloud Code プラグインをインストールします（まだインストールしていない場合）。

アプリケーションを作成する

1. コマンド パレット（Cmd/Ctrl +Shift +P ）を使用して、Cloud Code: 新しいアプリケーション、Kubernetes アプリケーションを実行し、お好みの言語の Hello World アプリを選択します。たとえば、[Node.js: Hello World] を選択して、スターターの Node.js Hello World アプリを作成します。
2. 新しいアプリケーションを保存します。 アプリケーションが作成されたことを確認する通知が表示され、アプリケーションの新しいウィンドウが開きます。

認証情報の設定

注: サービス アカウント キーが正しく管理されていない場合は、セキュリティ リスクが発生します。可能であれば、サービス アカウント キーよりも安全な代替手段を選択してください。サービス アカウント キーで認証する必要がある場合は、秘密鍵のセキュリティと、サービス アカウント キーを管理するためのベスト プラクティスで説明されているその他の操作は、ユーザーの責任で実施してください。サービス アカウント キーを作成できない場合は、組織でサービス アカウント キーの作成が無効になっている可能性があります。詳細については、デフォルトで安全な組織リソースの管理をご覧ください。

1. ターミナルを開くには、[ターミナルl] > [新しいターミナル] をクリックします。

2. API リクエストを認証するためのサービス アカウントを作成します。

   gcloud iam service-accounts create \
   translation-quickstart \
   --project PROJECT_ID

3. サービス アカウントに Cloud Translation API ユーザーのロールを付与します。

   gcloud projects \
   add-iam-policy-binding \
   PROJECT_ID \
   --member='serviceAccount:translation-quickstart@PROJECT_ID.iam.gserviceaccount.com' \
   --role='roles/cloudtranslate.user'

4. サービス アカウント キーを作成します。

   gcloud iam service-accounts keys \
   create key.json --iam-account \
   translation-quickstart@PROJECT_ID.iam.gserviceaccount.com

5. このキーをデフォルトの認証情報として設定します。

   export \
    GOOGLE_APPLICATION_CREDENTIALS=key.json
   

アプリケーションから Cloud Translation API を呼び出す

Go

1. Cloud Translation API Cloud クライアント ライブラリをインストールします。

   1. ターミナルを開くには、[ターミナル] > [新しいターミナル] をクリックします。

   2. 次のコマンドを実行します。

      go get cloud.google.com/go/translate/apiv3
      

2. app.go ファイルを作成します。

3. app.go を開き、パッケージ名、インポート、アプリのスケルトンを追加します。

   package main
   
   import (
     "context"
     "fmt"
   
     translate "cloud.google.com/go/translate/apiv3"
     translatepb "google.golang.org/genproto/googleapis/cloud/translate/v3"
   )
   
   func translateText(w io.Writer, projectID string, sourceLang string, targetLang string, text string) error {
   
   }
   
   func main() {
   
   }
   

4. translateText() 関数に、指定されたテキストを翻訳する次のコードを追加します。[ファイル] > [保存] を選択して、コードの形式を変更します。

   ctx := context.Background()
   client, err := translate.NewTranslationClient(ctx)
   if err != nil {
     return fmt.Errorf("NewTranslationClient: %v", err)
   }
   defer client.Close()
   
   req := &translatepb.TranslateTextRequest{
     Parent:             fmt.Sprintf("projects/%s/locations/global", projectID),
     SourceLanguageCode: sourceLang,
     TargetLanguageCode: targetLang,
     MimeType:           "text/plain", // Mime types: "text/plain", "text/html"
     Contents:           []string{text},
   }
   
   resp, err := client.TranslateText(ctx, req)
   if err != nil {
     return fmt.Errorf("TranslateText: %v", err)
   }
   
   // Display the translation for each input text provided
   for _, translation := range resp.GetTranslations() {
     fmt.Fprintf(w, "Translated text: %v\n", translation.GetTranslatedText())
   }
   
   return nil
   

5. main() 関数で translateText() を呼び出します。次のパラメータ値は、英語をスペイン語に翻訳します。

   projectID := "<var>PROJECT_ID</var>"
   sourceLang := "en-US"
   targetLang := "es"
   text := "Text to translate"
   
   err := translateText(os.Stdout, projectID, sourceLang, targetLang, text)
   if err != nil {
     fmt.Print(err)
   }
   

6. ターミナルからアプリケーションを実行します。

   go run app.go
   

Java

1. pom.xml を開き、次のコード スニペットを dependencies セクションに追加します。

   <dependencies>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>4.11</version>
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>google-cloud-translate</artifactId>
     </dependency>
   </dependencies>
   

2. 次に、pom.xml ファイルで、次のコード スニペットを dependencyManagement セクションに追加します。

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>com.google.cloud</groupId>
         <artifactId>libraries-bom</artifactId>
         <version>26.39.0</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>
   

   Google Cloud でサポートされているライブラリの最新バージョンを使用していることを確認します。バージョンのリストについては、Google Cloud でサポートされているライブラリをご覧ください。

3. Java クラスパス / 構成を同期するかどうかを尋ねられたら、[Always] をクリックします。

4. app.java という名前のファイルを作成します。

5. app.java で、パッケージ定義の後に次のインポートを含めます。

   import com.google.cloud.translate.v3.LocationName;
   import com.google.cloud.translate.v3.TranslateTextRequest;
   import com.google.cloud.translate.v3.TranslateTextResponse;
   import com.google.cloud.translate.v3.Translation;
   import com.google.cloud.translate.v3.TranslationServiceClient;
   import java.io.IOException;
   

6. translateText() メソッドを App クラスに追加します。このメソッドは、変数を設定し、オーバーロードされた translateText() メソッドに渡します。次の値は、英語からスペイン語に翻訳します。

   public static void translateText() throws IOException {
     String projectId = "<walkthrough-project-id/>";
     String targetLanguage = "es";
     String text = "Hello world!";
     translateText(projectId, targetLanguage, text);
   }
   

7. オーバーロードされた translateText() メソッドを追加します。このメソッドは、テキストを取得してターゲット言語に翻訳します。

   public static void translateText(String projectId, String targetLanguage, String text)
     throws IOException {
   
     try (TranslationServiceClient client = TranslationServiceClient.create()) {
       LocationName parent = LocationName.of(projectId, "global");
   
       TranslateTextRequest request =
         TranslateTextRequest.newBuilder()
         .setParent(parent.toString())
         .setMimeType("text/plain")
         .setTargetLanguageCode(targetLanguage)
         .addContents(text)
         .build();
   
       TranslateTextResponse response = client.translateText(request);
   
       // Display the translation for each input text provided
       for (Translation translation : response.getTranslationsList()) {
         System.out.printf("Translated text: %s\n", translation.getTranslatedText());
       }
     }
   }
   

8. main のプリント ステートメントを translateText() の呼び出しに置き換えます。

   try {
     translateText();
   }
   catch (IOException e) {
     e.printStackTrace();
   }
   

Node.js

1. Cloud Translation API Cloud クライアント ライブラリをインストールします。

   1. [Cloud Code] をクリックし、[Cloud APIs] エクスプローラを展開します。
   2. [Cloud AI] を展開し、[Cloud Translation API] をクリックします。
   3. クライアント ライブラリをインストールするには、[NodeJS] をクリックして、play_arrow [ターミナルで実行] をクリックします。
      

2. プロジェクトに app.js ファイルを作成します。

3. app.js を開き、ファイルの先頭で Translation クライアント ライブラリをインポートします。

   const {TranslationServiceClient} = require('@google-cloud/translate');
   

4. Translation API クライアントを作成し、プロジェクト ID、ロケーション、翻訳するテキストの変数を追加します。

   // Instantiates a client
   const translationClient = new TranslationServiceClient();
   
   const projectId = 'PROJECT_ID';
   const location = 'global';
   const text = 'Hello, world!';
   

5. 次の async 関数を追加します。この関数は、Hello, world! テキストの言語を検出し、テキストをスペイン語に翻訳します。

   async function translateText() {
       // Construct request
       const request = {
           parent: `projects/PROJECT_ID/locations/LOCATION`,
           contents: [text],
           mimeType: 'text/plain', // mime types: text/plain, text/html
           sourceLanguageCode: 'en',
           targetLanguageCode: 'es',
       };
   
       // Run request
       const [response] = await translationClient.translateText(request);
   
       for (const translation of response.translations) {
           console.log(`Translation: ${translation.translatedText}`);
       }
   }
   

6. app.js ファイルの最後で translateText() を呼び出します。

   translateText();
   

7. アプリケーションを実行するには、コマンド パレット（Ctrl/Cmd +Shift +P を押下）を開いて、 Cloud Code: Kubernetes での実行 を実行します。

8. アプリケーションがデプロイされたら、webview に表示された URL を開いて、実行中のサービスを表示します。

Python

1. Cloud Translation API Cloud クライアント ライブラリをインストールします。

   1. [Cloud Code] をクリックし、[Cloud APIs] エクスプローラを展開します。
   2. [Cloud AI] を展開し、[Cloud Translation API] をクリックします。
   3. クライアント ライブラリをインストールするには、[Python] をクリックして、play_arrow [ターミナルで実行] をクリックします。
      注: Chromebook などの Linux ベースのオペレーティング システムを使用している場合は、pip ではなく pip3 を使用するようにコマンドを変更します。Mac を使用している場合は、pip3 を使用して --user フラグを追加するようにコマンドを変更します。

2. プロジェクトに app.py ファイルを作成します。

3. app.py で、ファイルの先頭にクライアント ライブラリをインポートします。

   from google.cloud import translate
   

4. translate_text 関数を追加します。これにより、Cloud Translation API を操作するために、クライアントを初期化します。

   def translate_text(text="Hello, world!", project_id="PROJECT_ID"):
   
   client = translate.TranslationServiceClient()
   location = "global"
   parent = "projects/PROJECT_ID/locations/LOCATION"
   

5. テキストを英語からスペイン語に翻訳して結果を出力するには、translate_text 関数で Cloud Translation API Cloud クライアント ライブラリへの次の呼び出しを追加します。

      response = client.translate_text(
       request={
           "parent": parent,
           "contents": [text],
           "mime_type": "text/plain",
           "source_language_code": "en-US",
           "target_language_code": "es",
       }
   )
   
   for translation in response.translations:
       print("Translated text: {}".format(translation.translated_text))
   

6. app.py の最後で translate_text() を呼び出します。

   translate_text()

7. アプリケーションを実行するには、コマンド パレット（Ctrl/Cmd +Shift +P を押下）を開いて、 Cloud Code: Kubernetes での実行 を実行します。

8. アプリケーションがデプロイされたら、webview に表示された URL を開いて、実行中のサービスを表示します。

クリーンアップ

アプリケーションを中止すると、実行中にデプロイされたすべての Kubernetes リソースは自動で削除されます。

このクイックスタートで使用した他のリソースについてアカウントに課金されないようにするには、プロジェクトを再利用する場合、プロジェクトを削除するか、作成したクラスタを削除してください。

クラスタを削除するには:

1. Kubernetes Explorer で、クラスタ名を一時停止し、open_in_new [Google Cloud コンソールで開く] をクリックします。
2. [削除] をクリックし、[削除] をクリックします。

プロジェクト（およびクラスタを含む関連リソース）を削除するには、次のようにします。

注意: プロジェクトを削除すると、次のような影響があります。

• プロジェクト内のすべてのものが削除されます。このドキュメントのタスクで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
• カスタム プロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタム プロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（たとえば、appspot.com）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

サポートを利用する

フィードバックを送信するには、GitHub で問題を報告します。または、Stack Overflow で質問します。

次のステップ

• Cloud Translation API の詳細を確認する
• Cloud クライアント ライブラリの詳細を確認する
• Cloud Code for VS Code の詳細を確認する