Pembelian akaun Google Cloud: Panduan konfigurasi dan pemanggilan API terjemahan Google Cloud (Google Cloud) dari peringkat asas hingga lanjutan
Sewaktu melaksanakan lokalisasi untuk pasaran luar negara, memaparkan produk e-dagang rentas sempadan dalam pelbagai bahasa, atau membina sistem khidmat pelanggan antarabangsa,
API Terjemahan Google Cloud (Google Cloud Translation API)
Dengan pengumpulan korpus yang sangat besar, kadar ketepatan pelbagai bahasa yang amat tinggi serta kelewatan respons yang hampir pada tahap saat, ia telah menjadi pilihan utama bagi kebanyakan pasukan teknikal.
Namun, bagi para pembangun yang baharu mengenali Google Cloud Platform (GCP), antaramuka konsolnya yang begitu luas, sistem kebenaran IAM yang rumit serta pelbagai kredensial pengesahan (Akaun Perkhidmatan) sering membuatkan mereka berasa keliru dan pening kepala.
Artikel ini akan meninggalkan semua bahasa retorik dalam dokumen rasmi, dengan tujuan untuk
Perspektif praktikal sebenar daripada seorang pemrogram yang paling tulen
, Tanpa berbelit-belit, panduan langkah demi langkah untuk membawa anda menyelesaikan daripada
Membuka perkhidmatan, konfigurasi kebenaran, menghasilkan kredensial, sehingga akhirnya panggilan kod setempat
Keseluruhan proses tersebut.
1. Konsep Utama: Pilih versi API yang sesuai dengan perniagaan anda
Sebelum membuat konfigurasi secara rasmi, anda perlu memahami dua versi utama API Penterjemahan Google Cloud, yang menentukan antara muka panggilan dan kaedah pengebilan anda pada masa hadapan:
Terjemahan Awan Asas (v2): Ciri-ciri: mudah, langsung, serta boleh terus digunakan sebaik dikeluarkan daripada kotak. Senario penggunaan: Terjemahan teks biasa dan terjemahan laman web. Anda hanya perlu menghantar satu perenggan teks kepada API, dan ia akan secara automatik mengesan bahasa serta membalas hasil terjemahan. Menyokong panggilan menggunakan API Key ringkas atau akaun perkhidmatan.
Penterjemahan Awan Lanjutan (v3): Ciri-ciri: Tahap perusahaan, sangat boleh disesuaikan. Senario penggunaan: Anda perlu menggunakan glosari (Glossaries) (contohnya: nama jenama tertentu, istilah profesional dalam industri yang tidak mahu diterjemahkan secara paksa), atau anda perlu menetapkan model terjemahan tersuai bagi bidang tertentu (Custom Models). Ia mesti menggunakan akaun perkhidmatan (Service Account) untuk pengesahan OAuth2.
Cadangan praktikal: Jika perniagaan anda tidak memerlukan istilah industri yang sangat khusus secara wajib, adalah amat disarankan untuk memulakan konfigurasi daripada versi v2 (Asas), kerana kos integrasi pembangunan adalah paling rendah dan ia mampu memenuhi lebih daripada 95% keperluan terjemahan harian.
Kedua, Langkah Pertama: Mencipta projek dan mengaktifkan perkhidmatan API
Asas bagi semua operasi GCP bermula daripada “projek”. Jika anda masih belum mempunyai akaun Google Cloud, sila daftar terlebih dahulu dan ikatkan kad kredit pembayaran anda (pengguna baharu biasanya layak menerima kredit percuma sebanyak 300 dolar AS).
1. Cipta atau pilih projek
Log masuk ke Google Cloud Console.
Klik kotak terjun pilihan projek di bahagian kiri atas, kemudian klik “Projek Baharu” (New Project).
Pembelian akaun Google Cloud
Masukkan nama projek (contohnya: perkhidmatan-terjemahan-saya), pilih organisasi anda, kemudian klik Cipta.
2. Mengaktifkan API Terjemahan
Di bar carian bahagian atas konsol, masukkan: "Cloud Translation API".
Klik pada hasil carian untuk memasuki halaman produk tersebut.
Pastikan projek yang baru anda cipta dipilih di sudut kiri atas, kemudian klik butang biru “Dayakan” (Enable). Perhatian: Jika sistem meminta anda mengikat akaun pembayaran, sila ikuti arahan untuk melengkapkan pengikatan kad kredit; jika tidak, API tidak akan dapat diaktifkan.
Tiga, Langkah kedua: Konfigurasikan kredensial pengesahan (perkara penting yang perlu dielakkan)
Google Cloud, demi menjamin keselamatan, sangat tidak menggalakkan pendedahan kunci API global dalam persekitaran pengeluaran. Untuk memanggil antara muka, kita perlu menghasilkan kredensial pengesahan yang sesuai. Di sini disediakan dua kaedah konfigurasi yang paling lazim digunakan.
Cara A: Menggunakan Kunci API (API Key) – sesuai untuk pembangunan dan ujian pantas versi 2
Jika anda memilih versi v2 dan hanya membuat panggilan antara pelayan belakang, penggunaan API Key merupakan kaedah yang paling pantas.
Di bar navigasi sebelah kiri konsol, sila masuk ke “API dan Perkhidmatan” (APIs & Services) -> “Kredensial” (Credentials) secara berturut-turut.
Klik “Cipta Kredensial” (CREATE CREDENTIALS) di bahagian atas halaman, kemudian pilih “Kunci API” (API key).
Sistem akan memaparkan sebuah tetingkap yang memperlihatkan satu rentetan aksara seperti AIzaSy..., itulah API Key anda. Salin dan simpan dengan selamat.
⚠Arahan Risiko Tinggi (Wajib Disetel): API Key yang baru sahaja dicipta secara lalai tidak mempunyai sebarang had. Jika dicanai oleh penggodam dan digunakan secara curi, kad kredit anda akan terus melebihi had kredit dalam sekelip mata. Klik pada “Ubah (ikon pensil)” di sebelah kanan kekunci tersebut. Dalam modul “Had API” (API restrictions), pilih “Hadkan kekunci” (Restrict key). Tandakan “Cloud Translation API” dalam menu leret turun. Menyimpan. Dengan cara ini, walaupun kunci tersebut bocor, ia hanya boleh digunakan untuk memanggil perkhidmatan terjemahan dan tidak dapat digunakan untuk membuka pelayan awan berprestasi tinggi bagi tujuan perlombongan.
Cara B: Menggunakan Akaun Perkhidmatan (Service Account) – Piawaian Alam Sekitar Pengeluaran (menyokong v2 dan v3)
Pembelian akaun Google Cloud
Bagi pelancaran projek secara rasmi, penggunaan akaun perkhidmatan untuk menghasilkan fail kelayakan JSON merupakan amalan standard yang disarankan oleh pihak Google.
Di halaman “Kredensial” yang sama, klik “Cipta Kredensial”, kali ini pilih “Akaun Perkhidmatan” (Service Account).
Masukkan nama akaun perkhidmatan (contohnya: translation-user), kemudian klik “Cipta dan Teruskan”.
Mengekalkan kebenaran (penting): Dalam kotak longkang “Peranan”, cari dan pilih “Cloud Translation -> Clou”
Pengguna API Terjemahan (Pengguna API Terjemahan Awan). Watak ini mempunyai kebenaran minimum yang diperlukan untuk memanggil antara muka terjemahan.
Klik teruskan dan selesaikan.
Kembali ke halaman senarai kredensial, dalam senarai “Akaun Perkhidmatan” di bahagian bawah, cari akaun yang baru sahaja dicipta, kemudian klik “Urus Kunci” (Manage keys) di sebelah kanan.
Klik “Tambah Kunci” (ADD KEY) -> “Cipta Kunci Baharu” (Create new key), kemudian pilih jenis JSON.
Selepas mengeklik Cipta, pelayar akan memuat turun secara automatik sebuah fail bernama xxxx-uuid.json. Fail ini ialah kunci peribadi anda, jangan sekali-kali memuat naiknya ke platform awam seperti GitHub!
Empat, Langkah Ketiga: Pembangunan Tempatan dan Pelaksanaan Kod (Pelaksanaan Pelbagai Bahasa)
Selepas menerima bukti, kita boleh menulis kod di lokasi untuk menjalankan pengujian. Berikut masing-masing diberikan berdasarkan
Kunci API
Cara permintaan HTTP yang paling ringkas, serta berasaskan
Kelayakan JSON
Pelaksanaan SDK bahasa arus perdana bertaraf pengeluaran.
1. Aliran ringkas: Menggunakan Kunci API untuk membuat permintaan HTTP POST
Jika anda tidak mahu memasang sebarang SDK, gunakan terus
keriting
Antara lain, klien HTTP yang biasa digunakan (seperti Axios, Postman) juga boleh memanggil antara muka v2.
URL permintaan: https://translation.googleapis.com/language/translate/v2
Cara permintaan: POS
Parameter carian: kunci=API_KEY anda
Badan Permintaan (JSON):
JSON
{
"q": ["Hello world! ", "Apa khabar anda hari ini? "],
"target": "zh-CN"
}
Hasil balasan (Respons):
JSON
{
"data": {
"terjemahan": [
{
"translatedText": "Hai, dunia! ",
"bahasaSumberDikesan": "en"
},
{
"translatedText": "Bagaimana keadaan anda hari ini? ",
"bahasaSumberDikesan": "en"
}
]
}
}
2. Aliran pengeluaran: Menggunakan kelayakan JSON akaun perkhidmatan (contohnya dalam Node.js dan Python)
Dalam penggunaan rasmi
Sebelum menggunakan SDK, anda perlu menyediakan satu pemboleh ubah persekitaran dalam lingkungan operasi setempat atau pelayan anda untuk memberitahu SDK di mana fail kredensial JSON anda disimpan.
Arahan konfigurasi Linux/macOS: Bashexport GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/google-credentials.json"
Arahan konfigurasi Windows (PowerShell): PowerShell$env:GOOGLE_APPLICATION_CREDENTIALS="C:\path\to\your\google-credentials.json"
🐍Kod amali Python (v2)
Pertama sekali, pasang pustaka kebergantungan rasmi:
Pembelian akaun Google Cloud
Bash
pip pasang google-cloud-translate==2.0.1
Menulis dan menjalankan skrip:
Python
daripada google.cloud import translate_v2 sebagai translate
def terjemahkan_teks(teks, bahasa_sasaran="zh-CN"):
# SDK akan secara automatik membaca kelayakan JSON dalam pembolehubah persekitaran GOOGLE_APPLICATION_CREDENTIALS
translate_client = translate.Client()
# Jika input yang diberikan ialah senarai, ia menyokong terjemahan secara beramai-ramai
jika isinstance(teks, bytes):
teks = teks.decode("utf-8")
keputusan = terjemah_klien.terjemahkan(teks, bahasa_sasaran=bahasa_sasaran)
cetak(f"Teks asal: {result['input']}")
cetak(f"Keputusan terjemahan: {result['translatedText']}")
cetak(f"Bahasa sumber yang dikesan: {result['detectedSourceLanguage']}")
jika __nama__ == "__main__":
Tingkatkan produktiviti anda dengan Google Cloud! ", dia
rset_bahasa="zh-CN")
🟢Kod praktikal Node.js (v2)
Pertama sekali, pasang pustaka kebergantungan rasmi:
Bash
npm install @google-cloud/translate
Menulis dan menjalankan kod:
JavaScript
const {Terjemah} = require('@google-cloud/translate').v2;
// Mewujudkan contoh klien, SDK akan secara automatik mencari kredensial daripada pemboleh ubah persekitaran
const terjemah = baru Terjemahan();
fungsi tak sekata permulaanPantas() {
satu teks = 'Hello, pengembangan antarabangsa! ';
const sasaran = 'zh-CN'; // Bahasa sasaran: Bahasa Cina Ringkas
cuba {
const [terjemahan] = await terjemah.terjemahkan(teks, sasaran);
console.log('Teks: ${text}');
console.log('Terjemahan: ${terjemahan}');
} tangkap (rantaian) {
console.error('Ralat terjemahan:', error);
}
}
permulaanPantas();
Lima, Panduan Mantap untuk Kawalan Kos dan Mengelakkan Perangkap
API Terjemahan Google Cloud bukannya percuma, kaedah pengebilannya adalah
Dikenakan bayaran mengikut bilangan aksara (Characters)
, termasuk ruang. Jika tidak dikawal, pelbagai permintaan berbahaya secara serentak daripada pengguna di bahagian hadapan atau panggilan gelung tak terhingga pada tahap kod boleh menyebabkan beban kewangan yang besar kepada perusahaan.
1. Selesaikan pengiraan harga (menggunakan harga v2 sebagai contoh)
Setiap bulan pengebilan, Google Cloud akan memberikan kredit percuma untuk 500,000 aksara. Bagi ujian berskala kecil atau blog peribadi, ia sudah mencukupi.
Selepas melebihi had percuma, harga ialah AS$20 bagi setiap sejuta aksara (Million characters).
Panduan mengelakkan kos tersembunyi: Semasa menterjemahkan teks penuh yang mengandungi banyak tag HTML, tag HTML itu sendiri (seperti <p>, <div>, class="xxx") juga akan dikira sebagai aksara bagi tujuan pengebilan. Oleh itu, sebelum menghantar teks ke API, adalah lebih baik untuk menyingkirkan tag HTML pada peringkat kod terlebih dahulu, menterjemahkan teks tulen tersebut dan kemudian menyusun semula keseluruhannya. Ini
Boleh membantu anda menjimatkan 30% secara langsung ~ 50% daripada bil besar.
2. Konfigurasikan "had fius" pada konsol
Untuk mengelakkan bil setinggi langit yang disebabkan oleh gelung kod atau serangan penggodam, had atas panggilan mesti dikunci pada hari pertama.
Masukkan "API dan Perkhidmatan"-> "API dan Perkhidmatan yang Diaktifkan" pada konsol GCP untuk mencari Cloud Translation API.
Setelah mengklik untuk masuk, beralih ke tab "Kuota & Sistem" (Quotas & Sistem).
Cari "Queries per minute" dan "Characters per hari".
Klik Ubah dan hadkannya ke julat anggaran perniagaan anda yang munasabah (contohnya: sehingga 200,000 aksara dipanggil setiap hari). Setelah dilebihi, API secara langsung akan mengembalikan 429 Too Many Requests untuk melaporkan kesalahan, dengan itu mengunci had penggunaan kad kredit anda.
3. Membina Lapisan Cache Tempatan (Cache)
Perniagaan terjemahan mempunyai ciri semula jadi: kadar pengulangan kosa kata frekuensi tinggi dan ayat tetap sangat tinggi.
Pembelian akaun Google Cloud
Pengoptimuman seni bina: Bina lapisan cache sederhana di pelayan belakang anda (seperti menggunakan Redis). Sebelum memanggil antara muka setiap kali, pergi ke Redis untuk memeriksa sama ada terdapat cache sasaran terjemahan yang sesuai dengan teks (contohnya: MD5 (bahasa sasaran asal) sebagai Kunci).
Sekiranya demikian, baca cache secara langsung, yang memerlukan 1 milisaat dan 0 kos; jika tidak, hubungi Google API dan tuliskan hasilnya kembali ke Redis. Langkah mudah ini secara langsung dapat mengurangkan lebih daripada 60% overhead API untuk aplikasi yang matang.
Enam, Rumusan
Konteks teras untuk mengkonfigurasi API Terjemahan Awan Google sebenarnya sangat jelas:
Projek pembinaan-> Perkhidmatan permulaan-> Dapatkan baucar (pihak berkuasa terhad)-> Gunakan dengan perubahan persekitaran-> Tetapkan had kad kalis letupan
。
Untuk perniagaan harian syarikat di luar negara, ingatlah "prinsip kebenaran minimum" untuk menggunakan akaun perkhidmatan (Service Account), dan dengan cache Redis back-end dan bahagian atas kuota GCP, anda boleh mempunyai satu set stabil, throughput tinggi, dan anggaran lengkap Infrastruktur terjemahan pelbagai bahasa yang terkawal.
