Cloud Translation - Advanced mendukung penerjemahan teks menggunakan model kustom, dan untuk membuat glosarium guna memastikan bahwa Cloud Translation API menerjemahkan terminologi spesifik domain pelanggan dengan benar.
Untuk mengetahui petunjuk cara menginstal Google Cloud CLI, menyiapkan project dengan akun layanan, serta mendapatkan token akses, silakan melihat halaman Penyiapan. Jika berencana menggunakan glosarium atau fitur batch, Anda juga harus membuat bucket Cloud Storage dan memberi akun layanan akses ke bucket tersebut.
Untuk menerjemahkan dokumen berformat, seperti PDF, silakan melihat Menerjemahkan dokumen.
Sebelum memulai
Sebelum dapat mulai menggunakan Cloud Translation API, Anda harus memiliki project yang mengaktifkan Cloud Translation API, dan harus memiliki kredensial yang sesuai. Anda juga dapat menginstal library klien untuk bahasa pemrograman umum yang bisa membantu Anda melakukan panggilan ke API. Untuk mengetahui informasi selengkapnya, silakan melihat halaman Penyiapan.
Membandingkan model
Saat meminta terjemahan dari Cloud Translation - Advanced, Anda dapat menentukan model terjemahan yang akan digunakan. Jika tidak ada model yang ditentukan, model nmt
akan digunakan.
Model | Sesuai untuk | Contoh |
---|---|---|
Model Terjemahan Mesin Neural (NMT) |
Kasus penggunaan teks umum seperti konten situs umum yang tidak spesifik untuk suatu domain, misalnya artikel berita. |
Artikel berita, Media sosial, Aplikasi chat, Ulasan |
Model AutoML Translation | Teks khusus domain. Pelanggan memberikan data pelatihan khusus untuk kasus penggunaan mereka, untuk pasangan bahasa tertentu guna menyesuaikan model NMT Google untuk tujuan domain. | Berita Keuangan, dokumen teknis, teks apa pun yang menggunakan istilah dan jargon yang unik untuk bidang tersebut. |
Anda menentukan model terjemahan menggunakan ID modelnya. Untuk model NMT, ID modelnya adalah general/nmt
. Silakan melihat bagian berikutnya untuk mengetahui informasi tentang ID model AutoML Translation.
Menerjemah teks
Teks input dapat berupa teks biasa atau HTML. Cloud Translation API tidak menerjemahkan tag HTML apa pun dalam input, dan hanya menerjemahkan teks yang muncul di antara tag. Output-nya mempertahankan tag HTML (tidak diterjemahkan), dengan teks terjemahan di antara tag, selama memungkinkan karena perbedaan antara bahasa sumber dan target. Urutan tag HTML dalam output mungkin berbeda dengan urutan dalam teks input karena perubahan urutan kata dalam terjemahan.
Menerjemahkan string input
REST
Untuk menerjemahkan teks, buat permintaan POST
dan berikan JSON dalam isi permintaan, yang mengidentifikasi bahasa sumber (source_language_code
), target bahasa (target_language_code
), dan teks yang akan diterjemahkan
(contents
). Anda dapat menyediakan beberapa string teks untuk diterjemahkan dengan menyertakannya dalam JSON (lihat contoh). Anda dapat mengidentifikasi bahasa sumber dan target
menggunakan kode ISO-639-nya.
Berikut ini contoh permintaan POST
yang menggunakan
curl
atau PowerShell. Contoh ini menggunakan token akses untuk akun layanan yang disiapkan untuk project menggunakan Google Cloud CLI Google Cloud.
Untuk mengetahui petunjuk cara menginstal Google Cloud CLI, menyiapkan project dengan akun layanan, serta mendapatkan token akses, silakan melihat halaman Penyiapan.
Sebelum menggunakan data permintaan apa pun, ganti nilai berikut ini:
- PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda
Metode HTTP dan URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText
Isi JSON permintaan:
{ "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, come here!", "Bring me some coffee!"] }
Untuk mengirim permintaan, luaskan salah satu opsi berikut:
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "translations": [ { "translatedText": "Доктор Ватсон, иди сюда!", }, { "translatedText": "Принеси мне кофе!", } ] }
Array translations
berisi dua kolom translatedText
dengan terjemahan
yang disediakan dalam bahasa targetLanguageCode
yang diminta (ru
: Rusia). Terjemahan dicantumkan dalam urutan yang sama dengan array sumber yang sesuai dalam permintaan.
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Go Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Java Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Node.js Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Python Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C# : Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk .NET.
PHP : Ikuti Petunjuk penyiapan PHP di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk PHP.
Ruby : Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk Ruby.
Menerjemahkan teks menggunakan model kustom
REST
Anda dapat menentukan model mana yang akan digunakan untuk terjemahan menggunakan parameter kueri
model
.
Contoh berikut menerjemahkan teks menggunakan model kustom dengan ID model
1395675701985363739
. Anda bisa mendapatkan ID model untuk model kustom dari daftar model di Konsol Google Cloud atau dari respons API saat melatih model.
Sebelum menggunakan data permintaan apa pun, ganti nilai berikut ini:
- PROJECT_ID: Project ID Google Cloud Anda.
- LOCATION: Region tempat model kustom berada, seperti
us-central1
.
Metode HTTP dan URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText
Isi JSON permintaan:
{ "model": "projects/PROJECT_ID/locations/LOCATION/models/1395675701985363739", "sourceLanguageCode": "en", "targetLanguageCode": "ru", "contents": ["Dr. Watson, please discard your trash. You've shared unsolicited email with me. Let's talk about spam and importance ranking in a confidential mode."] }
Untuk mengirim permintaan, pilih salah satu dari beberapa opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
, lalu jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText"
/powershell
Simpan isi permintaan dalam file bernama request.json
, lalu jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION:translateText" | Select-Object -Expand Content
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "translation": { "translatedText": "Доктор Ватсон, пожалуйста, откажитесь от своего мусора. Вы поделились нежелательной электронной почтой со мной. Давайте поговорим о спаме и важности рейтинга в конфиденциальном режиме.", "model": "projects/PROJECT_NUMBER/locations/LOCATION/models/1395675701985363739" } }
Go
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Go di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Go Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Java di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Java Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Node.js di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Node.js Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Sebelum mencoba contoh ini, ikuti petunjuk penyiapan Python di panduan memulai Cloud Translation menggunakan library klien. Untuk mengetahui informasi selengkapnya, silakan melihat dokumentasi referensi API Python Cloud Translation.
Untuk melakukan autentikasi ke Cloud Translation, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, silakan melihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Bahasa tambahan
C# : Ikuti Petunjuk penyiapan C# di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk .NET.
PHP : Ikuti Petunjuk penyiapan PHP di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk PHP.
Ruby : Ikuti Petunjuk penyiapan Ruby di halaman library klien, lalu buka Dokumentasi referensi Cloud Translation untuk Ruby.
Transliterasi
Transliterasi adalah setelan konfigurasi dalam metode translateText
. Jika
mengaktifkan transliterasi, Anda akan menerjemahkan teks yang diubah ke dalam aksara Romawi (skrip Latin) langsung
ke target bahasa. Misalnya, Anda dapat menerjemahkan teks bahasa Jepang yang diubah ke dalam aksara Latin
langsung ke bahasa Inggris, Spanyol, atau China. Terjemahan yang dihasilkan berada dalam
sistem penulisan target bahasa.
Dalam permintaan transliterasi Anda, hanya sertakan teks yang diubah ke dalam aksara Latin. Jika Anda menggabungkan teks yang diubah ke dalam aksara Latin dengan teks yang tidak diubah ke dalam aksara Latin, Cloud Translation tidak dapat memastikan terjemahan yang konsisten dan tepat.
Pertimbangan
Perbedaan antara transliterasi dengan terjemahan teks standar terletak dalam hal berikut ini:
- Transliterasi mendukung bahasa dalam jumlah yang terbatas. Untuk informasi selengkapnya, silakan melihat kolom Transliterasi di halaman Bahasa yang didukung.
- Jenis MIME harus
text/plain
. HTML tidak didukung. - Transliterasi didukung oleh model standar default saja. Model kustom tidak didukung.
- Transliterasi memiliki kuota konten default yang lebih rendah. Untuk mengetahui informasi selengkapnya, silakan melihat Kuota dan batas.
REST
Tetapkan kolom transliteration_config
pada metode translateText
.
Sebelum menggunakan data permintaan apa pun, ganti nilai berikut ini:
- PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda.
- LOCATION: Region tempat Anda ingin menjalankan operasi ini. Contoh,
us-central1
. - SOURCE_LANGUAGE: (Opsional) Kode bahasa teks input. Jika diketahui, setel ke salah satu kode bahasa yang tercantum di Dukungan bahasa.
- TARGET_LANGUAGE: Target bahasa untuk menerjemahkan teks input. Setel ke salah satu kode bahasa yang tercantum di Dukungan bahasa.
- SOURCE_TEXT: Teks yang diubah ke dalam aksara Latin di bahasa sumber yang akan diterjemahkan.
Metode HTTP dan URL:
POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText
Isi JSON permintaan:
{ "source_language_code": "SOURCE_LANGUAGE", "target_language_code": "TARGET_LANGUAGE", "contents": "SOURCE_TEXT", "mime_type": "text/plain", "transliteration_config": { "enable_transliteration": true} }
Untuk mengirim permintaan, luaskan salah satu opsi berikut:
Anda akan melihat respons JSON yang mirip dengan berikut ini:
{ "translations": [ { "translatedText": "TRANSLATED_TEXT", } ] }
Referensi tambahan
- Untuk mendapatkan bantuan terkait cara menyelesaikan masalah atau error umum, silakan melihat halaman Pemecahan masalah.