การซื้อบัญชี Google Cloud: Google Cloud (Google Cloud) แปล API จากศูนย์ถึงหนึ่งการกำหนดค่าและคู่มือการโทร

เมื่อแปลเป็นภาษาท้องถิ่นในต่างประเทศผลิตภัณฑ์อีคอมเมิร์ซข้ามพรมแดนอยู่บนชั้นวางในหลายภาษาหรือสร้างระบบบริการลูกค้าข้ามชาติ

Google Cloud Translation API (Google Cloud แปล API)

ด้วยการสะสมคลังข้อมูลขนาดใหญ่ความแม่นยำหลายภาษาที่สูงมากและความล่าช้าในการตอบสนองเกือบวินาทีจึงกลายเป็นตัวเลือกแรกของทีมเทคนิคส่วนใหญ่

อย่างไรก็ตามสำหรับนักพัฒนาที่ติดต่อ Google Cloud (GCP) เป็นครั้งแรกคอนโซลขนาดใหญ่ระบบสิทธิ์ IAM ที่ซับซ้อนและใบรับรองการรับรองต่างๆมักจะทำให้ผู้คนรู้สึกเวียนหัว

บทความนี้จะละทิ้งสำนวนของเอกสารราชการทั้งหมด

มุมมองจริงของโปรแกรมเมอร์ที่บริสุทธิ์ที่สุด

, อย่าไปรอบๆโค้ง, จับมือคุณเพื่อทำ

เปิดบริการกำหนดค่าสิทธิ์สร้างใบสำคัญและเรียกรหัสท้องถิ่นขั้นสุดท้าย

กระบวนการทั้งหมด

แนวคิดหลัก: เลือกรุ่น API สำหรับธุรกิจของคุณ

ก่อนการกำหนดค่าอย่างเป็นทางการคุณต้องค้นหาเวอร์ชันหลักสองเวอร์ชันของ Google Cloud Translate API ซึ่งจะกำหนดอินเทอร์เฟซและวิธีการเรียกเก็บเงินสำหรับการโทรครั้งต่อไปของคุณ:

Cloud Translation Basic (v2): คุณสมบัติ: ง่ายตรงและพร้อมใช้งานสถานการณ์ที่ใช้งานได้: การแปลข้อความและการแปลหน้าเว็บที่พบบ่อยที่สุดคุณเพียงแค่ต้องโยนข้อความไปยัง API จากนั้นจะตรวจจับภาษาโดยอัตโนมัติและส่งคืนผลการแปลรองรับการใช้คีย์ API หรือบัญชีบริการที่เรียบง่ายในการโทร

Cloud Translation Advanced (v3): คุณสมบัติ: ระดับองค์กรปรับแต่งได้สูงสถานการณ์ที่ใช้งานได้: คุณต้องใช้อภิธานศัพท์ (Glossaries)(ตัวอย่างเช่นชื่อแบรนด์เฉพาะคำศัพท์ระดับมืออาชีพในอุตสาหกรรมไม่ต้องการถูกบังคับให้แปล) หรือคุณต้องระบุรูปแบบการแปลแบบกำหนดเอง (Custom Models) ในสาขาเฉพาะต้องใช้บัญชีบริการ (Service Account) สำหรับการรับรอง OAuth2。

คำแนะนำในทางปฏิบัติ: หากธุรกิจของคุณไม่มีข้อกำหนดที่เข้มงวดสำหรับคำศัพท์ในอุตสาหกรรมที่เป็นมืออาชีพมากขอแนะนำอย่างยิ่งให้เริ่มการกำหนดค่าจาก v2 (พื้นฐาน) ต้นทุนการเชื่อมต่อการพัฒนาต่ำที่สุดและสามารถตอบสนองความต้องการการแปลรายวันได้มากกว่า95%

ประการที่สองขั้นตอนแรก: สร้างโครงการและเปิดใช้งานบริการ API

พื้นฐานของการดำเนินงาน GCP ทั้งหมดเริ่มต้นด้วย "โครงการ (Project)" หากคุณไม่มีบัญชี Google Cloud โปรดลงทะเบียนและผูกบัตรเครดิตการชำระเงินก่อน (ผู้ใช้ใหม่มักจะมีวงเงินฟรี $300)

1.สร้างหรือเลือกโครงการ

ลงชื่อเข้าใช้ Google Cloud Console (Google Cloud Console)

คลิกช่องแบบเลื่อนลงสำหรับการเลือกรายการที่มุมบนซ้ายแล้วคลิก "โครงการใหม่"

การซื้อบัญชี Google Cloud

ป้อนชื่อรายการ (เช่น: my-translation-service) เลือกองค์กรของคุณคลิกสร้าง

2.เปิดใช้งาน API การแปล

ในแถบค้นหาด้านบนของคอนโซลให้พิมพ์ "Cloud Translation API"

คลิกในผลการค้นหาเพื่อเข้าสู่หน้าผลิตภัณฑ์

ตรวจสอบให้แน่ใจว่าคุณเลือกรายการที่คุณเพิ่งสร้างไว้ที่มุมบนซ้ายจากนั้นคลิกปุ่ม "เปิดใช้งาน" สีน้ำเงินหมายเหตุ: หากระบบแจ้งว่าคุณจำเป็นต้องผูกบัญชีการชำระเงินโปรดปฏิบัติตามคำแนะนำเพื่อดำเนินการผูกบัตรเครดิตให้เสร็จสิ้นมิฉะนั้นจะไม่สามารถเปิดใช้งาน API ได้

3.ขั้นตอนที่2: กำหนดค่าใบรับรองการรับรอง (จุดหลีกเลี่ยงที่สำคัญ)

เพื่อความปลอดภัย Google Cloud ไม่สนับสนุนให้เปิดเผยคีย์ API ทั่วโลกในสภาพแวดล้อมการผลิตในการเรียกอินเทอร์เฟซเราจำเป็นต้องสร้างใบรับรองการรับรองที่เหมาะสมนี่คือวิธีการกำหนดค่าที่ใช้บ่อยที่สุดสองวิธี

วิธี A: ใช้คีย์ API (API Key)-เหมาะสำหรับ v2การพัฒนาและทดสอบอย่างรวดเร็ว

หากคุณเลือกเวอร์ชัน v2และเรียกเฉพาะระหว่างเซิร์ฟเวอร์ส่วนหลังการใช้ API Key เป็นวิธีที่เร็วที่สุด

ในแถบนำทางด้านซ้ายของคอนโซลให้ป้อน "APIs & Services" (APIs & Services) -> "Credentials"

คลิก "สร้างข้อมูลประจำตัว" (CREATE CREDENTIALS) ที่ด้านบนของหน้าแล้วเลือก "คีย์ API" (คีย์ API)

ระบบจะปรากฏหน้าต่างแสดงสตริงที่คล้ายกับ AIzaSy... นี่คือคีย์ API ของคุณคัดลอกและเก็บไว้อย่างถูกต้อง

⚠คำเตือนความเสี่ยงสูง (ต้องมีการกำหนดค่า): คีย์ API ที่สร้างขึ้นใหม่จะไม่ถูกจำกัดโดยค่าเริ่มต้นหากแฮกเกอร์สแกนและขโมยบัตรเครดิตของคุณจะระเบิดทันทีคลิก "แก้ไข (ไอคอนดินสอ)" ทางด้านขวาของคีย์ในโมดูล "API restrictions" ให้เลือก "คีย์การจำกัด" เลือก "Cloud Translation API" ในเมนูแบบเลื่อนลงบันทึกด้วยวิธีนี้แม้ว่าคีย์จะรั่วไหลแต่ก็สามารถใช้เพื่อเรียกบริการแปลภาษาเท่านั้นและไม่สามารถใช้เพื่อเปิดเซิร์ฟเวอร์คลาวด์ระดับไฮเอนด์เพื่อขุดได้

วิธี B: ใช้บัญชีบริการ (บัญชีบริการ)-ข้อกำหนดด้านสิ่งแวดล้อมการผลิต (รองรับ v2และ v3)

การซื้อบัญชี Google Cloud

สำหรับการเปิดตัวโครงการอย่างเป็นทางการการใช้บัญชีบริการเพื่อสร้างไฟล์ใบรับรอง JSON ถือเป็นแนวทางปฏิบัติมาตรฐานที่ Google แนะนำอย่างเป็นทางการ

นอกจากนี้ในหน้า "ข้อมูลรับรอง" ให้คลิก "สร้างข้อมูลรับรอง" และเลือก "บัญชีบริการ" ในครั้งนี้

ป้อนชื่อบัญชีบริการ (เช่น: translation-user) แล้วคลิก "สร้างและดำเนินการต่อ"

การกำหนดสิทธิ์ (คีย์): ในกล่องแบบเลื่อนลง "บทบาท" ให้ค้นหาและเลือก "Cloud Translation -> Clou

D การแปลผู้ใช้ API "(Cloud Translation API User) ตัวละครนี้มีสิทธิ์ขั้นต่ำที่จำเป็นในการเรียกใช้อินเทอร์เฟซการแปล

คลิกเพื่อดำเนินการต่อและเสร็จสิ้น

กลับไปที่หน้ารายการข้อมูลรับรองค้นหาบัญชีที่สร้างขึ้นใหม่ในรายการ "บัญชีบริการ" ด้านล่างและคลิก "คีย์การจัดการ" ทางด้านขวา

คลิก "เพิ่มคีย์" (เพิ่มคีย์) -> "สร้างคีย์ใหม่" (สร้างคีย์ใหม่) ประเภทเลือก JSON

หลังจากคลิกสร้างเบราว์เซอร์จะดาวน์โหลดไฟล์ชื่อ xxxx-uuid.json โดยอัตโนมัติไฟล์นี้เป็นคีย์ส่วนตัวของคุณและต้องไม่อัปโหลดไปยังแพลตฟอร์มสาธารณะเช่น GitHub!

4.ขั้นตอนที่สาม: การพัฒนาท้องถิ่นและการปฏิบัติโค้ด (การเชื่อมโยงไปถึงหลายภาษา)

หลังจากได้รับบัตรกำนัลแล้วเราสามารถเขียนโค้ดในเครื่องเพื่อทำการดีบักได้ต่อไปนี้ขึ้นอยู่กับ

API Key

วิธีการร้องขอ HTTP ที่ง่ายที่สุดและขึ้นอยู่กับ

ใบรับรอง JSON

การใช้ SDK ภาษาหลักระดับการผลิต

1.Minimalist Stream: ขอ HTTP POST โดยใช้ API Key

หากคุณไม่ต้องการติดตั้ง SDK ใดๆให้ใช้โดยตรง

Curl

หรือไคลเอนต์ HTTP ที่ใช้กันทั่วไป (เช่น Axios, Postman) สามารถเรียกใช้อินเทอร์เฟซ v2ได้

URL ที่ร้องขอ: https://translation.googleapis.com/language/translate/v2

ขอ: POST

พารามิเตอร์การสืบค้น: คีย์ = API_KEY ของคุณ

Request Body (JSON):

JSON

{

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

"Target": "zh-CN"

}

ส่งกลับผลลัพธ์ (Response):

JSON

{

"Data": {

"Translations": [

{

"TranslatedText": "สวัสดีโลก! ",

"DetectedSourceLanguage": "en"

},

{

"TranslatedText": "วันนี้คุณเป็นอย่างไร? ",

"DetectedSourceLanguage": "en"

}

]

}

}

2.ขั้นตอนการผลิต: ใช้บัญชีบริการ JSON voucher (โดย Node.js และ Python เป็นตัวอย่าง)

ใช้อย่างเป็นทางการ

ก่อน SDK คุณต้องกำหนดค่าตัวแปรสภาพแวดล้อมในสภาพแวดล้อมการทำงานภายในเครื่องหรือเซิร์ฟเวอร์ของคุณเพื่อบอก SDK ว่าใบรับรอง JSON ของคุณอยู่ที่ใด

คำสั่งกำหนดค่า Linux/macOS: Bashexport GOOGLE_APPLICATION_CREDENTIALS = "/path/to/your/google-credentials.json"

คำสั่งกำหนดค่าของ Windows (PowerShell): PowerShell $ env:GOOGLE_APPLICATION_CREDENTIALS = "C:\ path \ to \ your \ google-credentials.json"

🐍รหัสการใช้งาน Python (v2)

ติดตั้งไลบรารีอ้างอิงอย่างเป็นทางการก่อน:

การซื้อบัญชี Google Cloud

Bash

Pip install google-cloud-translate = = 2.0.1

เขียนและเรียกใช้สคริปต์:

ไพธอน

From google. cloud import translate_v2 as translate

Def translate_text(text, target_language = "zh-CN"):

# SDK จะอ่านใบรับรอง JSON ในตัวแปรสภาพแวดล้อมโดยอัตโนมัติ

Translate_client = translate.Client()

# ถ้ารายการที่เข้ามาสนับสนุนการแปลเป็นกลุ่ม

If isinstance(text, bytes):

Text = text.de code("utf-8")

Result = translate_client.translate(text, target_language = target_language)

พิมพ์ (f "ข้อความต้นฉบับ: {result['input']}")

Print (f "ผลการแปล: {result['translatedText']}")

พิมพ์ (f "ตรวจพบภาษาต้นทาง: {result['detectedSourceLanguage']}")

If __name__ = = "__main__":

Translate_text ("Boost your productivity with Google Cloud! ", Ta

Rget_language = "zh-CN")

🟢รหัสการปฏิบัติ Node.js (v2)

ขั้นแรกให้ติดตั้งไลบรารีพึ่งพิงอย่างเป็นทางการ:

แบช

Npm install @ google-cloud/translate

เขียนและเรียกใช้รหัส:

จาวาสคริปต์

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

// อินสแตนซ์ไคลเอ็นต์ SDK จะค้นหาข้อมูลประจำตัวจากตัวแปรสภาพแวดล้อมโดยอัตโนมัติ

Const translate = new Translate();

Async function quickStart() {

Const text = 'Hello, international expansion! ';

Const target = 'zh-CN'; // ภาษาเป้าหมาย: จีนตัวย่อ

ลอง {

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

Console.log ('Text: ${text}');

Console.log ('Translation: ${translation}');

} รับผิดชอบ (ข้อผิดพลาด) {

Console.error ('ข้อผิดพลาดในการแปล:', error);

}

}

QuickStart ();

5.คู่มือฮาร์ดคอร์สำหรับการควบคุมต้นทุนและการหลีกเลี่ยงหลุม

Google Cloud Translation API ไม่ฟรีวิธีการเรียกเก็บเงินคือ

เรียกเก็บเงินตามจำนวนอักขระ

รวมถึงช่องว่างหากไม่ได้รับการควบคุมการทำงานพร้อมกันที่เป็นอันตรายของผู้ใช้ส่วนหน้าหรือการโทรแบบไม่สิ้นสุดที่ระดับรหัสจะนำค่าใช้จ่ายทางเศรษฐกิจจำนวนมากมาสู่องค์กร

1.ชำระบัญชีราคา (ใช้ราคา v2เป็นตัวอย่าง)

ในแต่ละเดือนของการเรียกเก็บเงิน Google Cloud จะให้โควต้าฟรี500,000ตัวอักษร (500,000ตัวอักษร) เพียงพอสำหรับการทดสอบขนาดเล็กหรือบล็อกส่วนตัว

หลังจากเกินโควต้าฟรีราคาจะอยู่ที่ $20/ล้านตัวอักษร (อักขระล้าน)

ลูกคิดหลุม: เมื่อแปลข้อความที่สมบูรณ์ที่มีแท็ก HTML จำนวนมากแท็ก HTML เอง (เช่น <p>, <div>, class = "xxx") จะนับเป็นการเรียกเก็บเงินอักขระด้วยดังนั้นก่อนที่จะส่งข้อความไปยัง API ควรลอกแท็ก HTML ที่ระดับโค้ดและประกอบใหม่หลังจากแปลข้อความธรรมดา

สามารถช่วยคุณประหยัดได้30% ~ 50% ของค่าใช้จ่ายจำนวนมาก

2.กำหนดค่า "ฟิวส์จำกัด" ในคอนโซล

เพื่อป้องกันการเรียกเก็บเงินที่สูงเสียดฟ้าเนื่องจากการวนซ้ำของรหัสหรือการโจมตีของแฮ็กเกอร์ขีดจำกัดสูงสุดของการโทรจะต้องถูกล็อคในวันแรก

ไปที่ "API และบริการ"-> "API และบริการที่เปิดใช้งาน" ในคอนโซล GCP และค้นหา API การแปลเมฆ

หลังจากคลิกเข้าไปแล้วให้สลับไปที่แท็บโควต้าและขีดจำกัดของระบบ (Quotas & System Limits)

ค้นหา "Queries per minute ต่อนาที" และ "Characters per day"

คลิกแก้ไขเพื่อจำกัดการประมาณการธุรกิจของคุณให้อยู่ในช่วงที่เหมาะสม (ตัวอย่างเช่น: สูงสุด200,000อักขระต่อวัน) เมื่อเกิน API จะส่งคืน429 Too Many Requests โดยตรงเพื่อรายงานข้อผิดพลาดซึ่งจะล็อควงเงินการใช้บัตรเครดิตของคุณ

3.สร้างชั้นแคชท้องถิ่น (Cache)

ธุรกิจการแปลมีลักษณะตามธรรมชาติ: คำศัพท์ความถี่สูงและอัตราการทำซ้ำประโยคคงที่สูงมาก

การซื้อบัญชี Google Cloud

การเพิ่มประสิทธิภาพสถาปัตยกรรม: สร้างเลเยอร์แคชอย่างง่ายบนเซิร์ฟเวอร์แบ็กเอนด์ของคุณ (เช่นการใช้ Redis) ก่อนที่จะเรียกอินเทอร์เฟซให้ไปที่ Redis เพื่อตรวจสอบว่ามีแคชเป้าหมายการแปลที่ตรงกับข้อความหรือไม่ (ตัวอย่างเช่น MD5 (ภาษาเป้าหมายดั้งเดิม) เป็นคีย์)

หากเป็นเช่นนั้นให้อ่านแคชโดยตรงซึ่งใช้เวลา1มิลลิวินาทีและมีค่าใช้จ่าย0หากไม่เป็นเช่นนั้นให้เรียก Google API อีกครั้งและเขียนผลลัพธ์กลับไปที่ Redis การย้ายง่ายๆนี้สามารถลดค่าใช้จ่าย API ได้มากกว่า60% สำหรับแอปพลิเคชันสำหรับผู้ใหญ่

หก. สรุป

บริบทหลักของการกำหนดค่า Google Cloud Translate API นั้นชัดเจนมาก:

สร้างโครงการ-> เริ่มบริการ-> รับบัตรกำนัล (ผู้มีอำนาจจำกัด)-> กำหนดค่าการปรับแต่งสภาพแวดล้อม-> กำหนดโควต้าการ์ดป้องกันการระเบิด

。

สำหรับธุรกิจประจำวันของบริษัทในต่างประเทศให้คำนึงถึง "หลักการอนุญาตขั้นต่ำ" ในการใช้บัญชีบริการ (Service Account) และติดตั้งแคช Redis แบบแบ็คเอนด์และโควต้าฮาร์ดท็อปด้าน GCP คุณสามารถมีปริมาณงานที่มั่นคงสูงและมีงบประมาณที่สมบูรณ์โครงสร้างพื้นฐานการแปลหลายภาษาชั้นนำที่ควบคุมได้