在 Cloud Code 中使用 Cloud 用戶端程式庫

本頁說明如何快速開始使用 Cloud 用戶端程式庫和 Cloud Code。您將使用 Hello World 範例應用程式設定新的 Kubernetes 應用程式，然後更新應用程式以使用 Cloud Translation API，將回應翻譯成西班牙文。

事前準備

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

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

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. 安裝 Git，讓 Cloud Code 執行 Git 作業，例如複製範例。
  5. 如果尚未安裝 Cloud Code 外掛程式，請先安裝。

建立應用程式

  1. 從指令區塊面板 (Cmd/Ctrl+Shift+P) 執行「Cloud Code: New Application」，選擇「Kubernetes Application」，然後選擇偏好語言的 Hello World 應用程式。舉例來說，您可以選擇「Node.js: Hello World」，建立 Node.js Hello World 應用程式入門範例。
  2. 儲存新應用程式。系統會顯示通知，確認已建立應用程式，並開啟含有應用程式的新視窗。

設定憑證

  1. 如要開啟終端機，請依序點選「Terminal」(終端機) >「New Terminal」(新增終端機)。

  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.' \
--role='roles/cloudtranslate.user'

  4. 建立服務帳戶金鑰：

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

  5. 將金鑰設為預設憑證：

    export \
 GOOGLE_APPLICATION_CREDENTIALS=key.json

從應用程式呼叫 Cloud Translation API

Go

  1. 安裝 Cloud Translation API Cloud 用戶端程式庫：

    1. 如要開啟終端機，請依序點選「Terminal」(終端機) >「New Terminal」(新增終端機)。

    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() 函式中新增下列程式碼，翻譯指定文字。依序選取「File」(檔案) >「Save」(儲存)，重新設定程式碼格式：

    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