Googleクラウドアカウント購入: Google Cloud翻訳APIの0から1への構成と呼び出しガイド

海外でのローカリゼーション、国境を越えた電気商商品の多言語で、あるいは多国籍のコールシステムを構築するとき

グーグルクラウド翻訳API (グーグルクラウド翻訳API)

その巨大なコーパスの蓄積、極めて高い多言語精度と秒レベルに近い応答遅延によって、ほとんどの技術チームの優先となった。

しかし、初めてgoogleクラウド (GCP) に接触した開発者にとって、その巨大なコンソール、複雑なIAM権限体系、各種認証証明書 (Service Account) は、しばしばめまいがする。

本文はすべての公式文書の決まり文句を捨てて、

最も純粋なプログラマの実写的な視点

、曲がり角を回さないで、手を持ってあなたを完成させます。

サービスの開通、権限の設定、証明書の生成、最終的なローカルコードへの呼び出し

の全流れ。

一、核心概念: あなたの業務に適したAPIバージョンを選択します

正式に構成する前に、googleクラウド翻訳APIの2つのコアバージョンを明らかにしなければなりません。これは、次の呼び出しのインタフェースと課金方法を決定します

Cloud translate Basic (v2): 特徴: 簡単、直接、開梱すぐ。適用シーン: 最も一般的なテキスト翻訳、web翻訳。APIにテキストを渡すだけで、言語を自動的に検出して翻訳結果を返します。簡単なAPI Keyまたはサービスアカウントを使用した呼び出しをサポートします。

Cloud translate Advanced (v 3): 特徴: 企業レベル、高度カスタマイズ。適用シナリオ: 用語集 (Glossaries) を使用する必要があります (例: 特定のブランド名、業界の専門用語は強制的に翻訳されたくない) または、特定の領域のカスタム翻訳モデルを指定する必要があります。サービスアカウントを使用してOAuth2認証を行う必要があります。

実技提案: もしあなたの業務に非常に専門的な業界用語のハードな要求がなければ、v2 (Basic) から配置することを強く提案し、開発ドッキングコストが最も低い95% 以上の日常的な翻訳ニーズを完全に満たすことができる。

二、第一歩: プロジェクトの作成とAPIサービスの有効化

すべてのGCP操作の基礎は「プロジェクト」から始まった。Googleのクラウドアカウントを持っていない場合は、まず決済クレジットカードを登録してバインドしてください (新しいユーザーは通常300ドルの無料額があります)。

1.項目を作成または選択する

Google Cloudコンソールにログインします。

左上のプロジェクトをクリックしてドロップダウンボックスを選択し、「新規プロジェクト」 (New Project) をクリックします。

Googleクラウドアカウント購入

プロジェクト名を入力し (例: my-translation-service) 、組織を選択し、「作成」をクリックします。

2.Translation APIを有効にする

コンソール上部の検索バーに「Cloud Translation API」と入力します。

検索結果の中をクリックしてこの製品ページに入ります。

左上隅に作成した項目が選択されていることを確認し、青い「有効」ボタンをクリックします。注意: 決済アカウントをバインドする必要があることが通知された場合は、指示に従ってクレジットカードのバインドを完了してください。そうしないとAPIを有効にできません。

三、第二ステップ: 認証証明書の配置 (重要な避難所)

Googleクラウドはセキュリティを保証するために、本番環境でグローバルなAPIキーを公開することを奨励していない。インタフェースを呼び出すためには、適切な認証証明書を生成する必要があります。ここでは、最も一般的な構成方法を2つ紹介します。

方式A: APIキーを使用: v2の迅速な開発とテストに適しています

V2バージョンを選択し、バックエンドサーバ間で呼び出すだけの場合は、API Keyを使用するのが最も早い方法です。

コンソールの左側のナビゲーションバーで、「APIとサービス」 (APIs & Services) -> 「証明書」 (Credentials) の順に進みます。

ページ上部の「証明書の作成」をクリックし、「APIキー」を選択します。

ウィンドウが表示され、AIzaSy... のような文字列が表示されます。これがあなたのAPIキーです。コピーして大切に保管します。

⚠ハイリスク警告 (必須構成): 作成したばかりのAPI Keyにはデフォルトで制限はありません。ハッカーに掃かれて盗まれると、クレジットカードが瞬時に爆発します。この鍵の右側にある「修正 (鉛筆アイコン) 」をクリックします。「API制限」 (API restrictions) モジュールで、「キーを制限」 (Restrict key) を選択します。ドロップダウンメニューで「Cloud Translation API」にチェックを入れます。保存します。このように、この鍵が漏洩しても、翻訳サービスを呼び出すしかなく、高配クラウドサーバを開いて鉱山を掘ることはできない。

方式B: サービスアカウントを使用します。本番環境仕様 (v 2とv 3をサポート)

Googleクラウドアカウント購入

正式なプロジェクトがオンラインになった場合、サービスアカウントを使ってJSON証明書ファイルを生成することはGoogleが公式に推奨する標準的な方法である。

また、「証明書」ページで「証明書の作成」をクリックし、今回は「サービスアカウント」を選択します。

サービスアカウント名を入力し (例: translation-user) 、「作成して続行」をクリックします。

権限の割り当て (キー): 「ロール」ドロップダウンボックスで、「Cloud Translation -> Clou」を検索して選択します

D translate APIユーザー」 (Cloud translate API User)。このロールには、翻訳インタフェースを呼び出すために必要な最小権限があります。

「続行」をクリックして完了します。

証明書リストページに戻って、下の「サービスアカウント」リストで作成したばかりのアカウントを見つけ、右側の「管理キー」をクリックします。

「キーを追加」 (ADD KEY) -> 「新しいキーを作成」 (Create new key) をクリックし、タイプはJSONを選択します。

「作成」をクリックすると、ブラウザは自動的にxxxx-uuid.jsonというファイルをダウンロードします。このファイルはあなたの秘密鍵で、GitHubなどの公開プラットフォームには絶対にアップロードできません!

四、第三ステップ: ローカル開発とコード操作 (多言語着地)

証明書を入手したら、ローカルでコードを書いてデバッグすることができます。以下それぞれに基づいて

APIキー

の最も簡単なHTTP要求方式と

JSON証明書

の生産レベルの主流言語SDKの実現。

1.極めて簡単なフロー: APIキーを使用したhttppost要求

SDKをインストールしたくない場合は、そのまま使用します

カール

または、Axios、Postmanなどの一般的なHTTPクライアントがv2インタフェースを呼び出すことができます。

リクエストURL:https://translation.googleapis.com/language/translate/v2

リクエスト方法: POST

クエリパラメータ: key = あなたのAPI_KEY

Request Body (JSON):

JSON

{

"Q": ["Hello world! ", "How are you today?"],

「ターゲット」: 「zh-CN」

}

結果を返します

JSON

{

"Data": {

「』: [

{

"TranslatedText": "こんにちは、世界! ",

"Detectedsourcelangage": "en"

},

{

「TranslatedText」: 「今日はどうですか。「」

"Detectedsourcelangage": "en"

}

]

}

}

2.生産フロー: サービスアカウントJSON証明書を使用する (Node.jsとPythonを例にとる)

公式を使っています

SDKの前に、ローカルの実行環境またはサーバに環境変数を設定して、SDKのJSON証明書がどこにあるかを伝える必要があります。

Linux/macOS構成コマンド: basヘキサポートgoogle _ application_credentials = "/path/to/your/google-credentials.json"

Windows (PowerShell) 構成コマンド: PowerShell $ dv: GOOGLE_APPLICATION_CREDENTIALS = "C:\ path \ to \ your \ google-credentials.json"

🐍Python実操作コード (v2)

まず、公式依存ライブラリをインストールします

Googleクラウドアカウント購入

バッシュ

Pip installgoogle-cloud-translate = = 2.0.1

スクリプトを作成して実行します

パイソン

From google.cloud import translate _ v2 as translate

Deftranslate _ text(text、if _ language = "zh-CN"):

# SDKは環境変数GOOGLE_APPLICATION_CREDENTIALSのJSON証明書を自動的に読み取ります

Translate _ Client = translate.Client()

# リストをインポートした場合、一括翻訳をサポートします

If isinstance(text, bytes):

Text = text.de code (「utf-8」)

Result = translate _ client.Translate

Print (f "元のテキスト: {result['input']}")

Print (f "翻訳結果: {result['translatedText']}")

Print (f "検出されたソース言语: {result ['detectedsourcelage']}")

If _ _ _ _ = = "_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

Translate _ text ",Ta

Rget_language = "zh-CN")

🟢Node.js実操作コード (v2)

まず、公式依存ライブラリをインストールします

バッシュ

Npm install @ google-cloud/translate

コードを書いて実行します:

JavaScript

Const {Translate} = require('@ google-cloud/translate').v2;

// クライアントをインスタンス化すると、SDKは自動的に環境変数から証明書を探します

Const translate = new Translate();

Async function quickStart() {

Const text = 'Hello、internatialsion! ';

コトンターゲット = 'zh-CN'; // ターゲット言語: 簡体字中国語

試みる {

Const [translation] = await translate.translate(text, target);

コンソール.log('Text: ${text}');

コンソール.log;

} catch (エラー) {

コンソール.error('翻訳エラー:', error);

}

}

QuickStart ();

五、コストコントロールとピット回避ハードコアガイドブック

Google Cloud Translation APIは無料ではなく、課金方法は

文字数で課金する

スペースを含む。コントロールしなければ、フロントユーザーの悪意のある同時性やコードレベルのデッドサイクル呼び出しは、企業に重い経済請求書をもたらす。

1.価格勘定を計算する (v2価格を例にとる)

請求書の月ごとに、googleクラウドは50万文字 (500、000文字) の無料額を贈る。小規模なテストや個人ブログでは十分です。

無料額を超えると、価格は20ドル/百万文字になります。

ピットそろばん: HTMLタグを多く含むリッチテキストを翻訳する場合、HTMLタグ自体 (p> 、div> 、class = "xxx" など) も課金文字とみなされる。そのため、テキストをAPIに送る前に、コードレベルでHTMLタグを剥離し、プレーンテキストを翻訳して再組み立てすることが望ましい

30% ~ 50% の巨額の請求書を直接節約できます。

2.コンソールで「溶断限度額」を設定する

コードのデッドサイクルやハッカー攻撃による天価請求書を防ぐためには、初日に呼び出し上限をロックしなければならない。

GCPコンソールで「APIとサービス」-> 「有効化されたAPIとサービス」にアクセスし、Cloud Translation APIを見つけます。

クリックして入ったら、「クォータとシステム限度額」 (Quotas & System Limits) タブに切り替えます。

「1分間あたりのクエリ回数 (Queries perminute) 」と「1日あたりの文字数制限 (漢字perday) 」が見つかりました。

「変更」をクリックして、ビジネスの見積もりの合理的な範囲に制限します (例: 1日に最大200、000文字の呼び出し)。超過すると、APIは直接429 Too Many Requestsエラーに戻り、クレジットカードの消費額をロックします。

3.ローカルキャッシュ層 (Cache) の構築

翻訳業務には天然の特性があります。高周波語彙と固定文式の繰り返し率が極めて高いです。

Googleクラウドアカウント購入

アーキテクチャの最適化: Redisを使用するなど、バックエンドサーバで簡単なキャッシュ層を構築します。インタフェースを呼び出すたびに、Redisにそのテキストに対応する翻訳ターゲットキャッシュ (例: MD5(原文 + ターゲット言語) がKeyとしてあるかどうかを調べる。

もしあれば、キャッシュを直接読むのに1ミリ秒と0のコストがかかりますもしそうでなければ、google APIを呼び出し、結果をRedisに書き戻します。この簡単な行動は、成熟したアプリケーションのために、APIのオーバーヘッドの60% 以上を直接切り倒すことができる。

六、まとめ

Googleクラウド翻訳APIを配置する核心的な脈絡は、実ははっきりしている

プロジェクトの構築-> サービスの開始-> 証明書の取得 (制限権限)-> 環境変更の設定-> 限度額の防爆カードの設定

。

企業の日常的な海外業務については、「最小権限の原則」を覚えてサービスアカウント (Service Account) を使用し、バックエンドRedisキャッシュとGCP側のクォータのハードトップを割り当て安定し、高スループットで、予算が完全に制御できるトップレベルの多言語翻訳インフラを持つことができます。