Bermigrasi ke Advanced dari Basic

Pengguna Cloud Translation - Basic (v2) saat ini yang ingin menggunakan fitur Cloud Translation terbaru, seperti glosarium dan model AutoML, harus memigrasikan aplikasi mereka ke Cloud Translation - Advanced (v3). Untuk perbandingan, baca Membandingkan Basic dan Advanced.

Migrasi ke edisi Advanced mencakup penggunaan Identity and Access Management (IAM) dan library klien edisi Advanced. Bagian berikut menguraikan tugas migrasi dan perbedaan utama antara kedua edisi tersebut.

Bermigrasi ke edisi Advanced

Langkah-langkah berikut menguraikan tindakan yang diperlukan untuk mengupdate aplikasi yang sudah ada dari Cloud Translation - Basic menjadi Cloud Translation - Advanced.

1. Lakukan inventarisasi project, aplikasi, dan pengguna Google Cloud Anda yang mengakses Cloud Translation - Basic API. Anda harus menyediakan akun layanan dan memperbaruinya untuk menggunakan library klien Cloud Translation - Advanced.
2. Siapkan akun layanan dan autentikasi untuk aplikasi Anda.
3. Gunakan peran IAM untuk menetapkan izin di akun layanan.
4. Aktifkan Cloud Translation - Advanced untuk project Anda. Jika Anda menggunakan model AutoML dengan Cloud Translation - Advanced, Anda juga harus mengaktifkan AutoML. Untuk informasi selengkapnya, buka halaman Penyiapan.
5. Gunakan library klien dan metode Cloud Translation - Advanced. Untuk permintaan Cloud Translation - Advanced, Anda harus menyertakan nomor project (atau ID project), dan lokasi project, seperti global atau us-central1.
6. Pastikan ukuran permintaan terjemahan ke Cloud Translation - Advanced tidak melebihi batas.
7. Rencanakan pemantauan kuota permintaan terjemahan. Kedua versi API ini memiliki kuota harian dan bulanan yang sama.
8. Tinjau setiap potensi perubahan di penagihan.

Perbedaan utama antara edisi Advanced dan Basic

Untuk membantu Anda memahami tugas migrasi, bagian berikut menjelaskan perbedaan utama antara edisi Advanced dan Basic.

Akun layanan

Untuk Cloud Translation - Basic, Anda dapat mengirim permintaan terautentikasi menggunakan kunci API atau akun layanan.

Cloud Translation - Advanced memiliki fitur yang memerlukan resource yang dikelola pelanggan; resource ini memerlukan peran IAM dan pengelolaan izin. Oleh karena itu, Anda tidak dapat menggunakan kunci API untuk melakukan autentikasi ke layanan. Sebagai gantinya, Anda harus menggunakan akun layanan saat melakukan autentikasi ke Cloud Translation - Advanced.

Untuk informasi selengkapnya, buka halaman Penyiapan.

Peran IAM

Saat Anda menggunakan akun layanan untuk Cloud Translation - Basic, akun layanan tersebut digunakan hanya untuk autentikasi. Anda dapat melakukan panggilan apa pun ke Cloud Translation - Basic, tanpa perlu memikirkan izin yang terkait dengan akun layanan. Namun, untuk Cloud Translation - Advanced, izin tersebut akan berlaku.

Untuk memberikan izin kepada akun layanan agar dapat memanggil Cloud Translation - Advanced, Anda harus menetapkan peran IAM ke akun tersebut. Cloud Translation - Advanced memiliki beberapa peran IAM yang dapat Anda berikan ke akun layanan untuk mengakses resource tertentu dalam project. Misalnya, jika ingin menggunakan akun layanan untuk menerjemahkan teks, Anda harus menetapkan peran roles/cloudtranslate.user pada akun layanan tersebut. Untuk informasi selengkapnya, baca peran IAM di detail Cloud Translation - Advanced.

Jika berencana menggunakan model AutoML atau fitur apa pun yang mengandalkan Cloud Storage, Anda juga harus menyertakan peran yang sesuai untuk layanan tersebut. Untuk melihat daftar semua peran IAM, baca dokumentasi Peran IAM.

Model Terjemahan

Saat Anda meminta terjemahan menggunakan Cloud Translation - Basic, Google akan menggunakan model Terjemahan Mesin Neural (NMT) terlatih. Untuk Cloud Translation - Advanced, Anda dapat menggunakan model NMT terlatih, LLM Terjemahan, atau model AutoML Translation kustom.

Akun layanan yang Anda gunakan untuk permintaan terjemahan harus memiliki izin untuk mengakses model NMT dan AutoML, yang lokasinya bisa berada di project yang berbeda-beda. Misalnya, Anda mungkin memiliki sebuah project sentral yang berisi model terjemahan Anda untuk menyederhanakan pemeliharaan dan penagihan. Akun layanan dalam project tersebut atau project lain dapat menggunakan model tersebut, tetapi memerlukan izin untuk melakukannya.

Untuk informasi selengkapnya tentang model terjemahan, baca Menerjemahkan teks (Advanced).

Library klien

Library klien dan metode untuk Cloud Translation - Advanced berbeda dengan Cloud Translation - Basic. Misalnya, panggilan ke Cloud Translation - Advanced memerlukan nama resource. Untuk informasi selengkapnya, baca ringkasan library klien Cloud Translation - Advanced atau coba panduan memulai menerjemahkan teks (edisi Advanced).

Resource, project, dan lokasi

Permintaan ke Cloud Translation - Advanced memerlukan nama resource yang ingin Anda gunakan. Resource biasanya terdiri dari nama yang memenuhi syarat yang menyertakan nama project dan lokasinya, yang menentukan tempat permintaan tersebut dijalankan. Misalnya, nama model AutoML adalah nama resource.

Jika project Google Cloud Anda memiliki nama my-project dan lokasi resource-nya adalah us-central1, maka nama lengkap resource Anda mungkin seperti berikut ini:

projects/MY_PROJECT/locations/us-central1/...

URL yang Anda kirimkan permintaan getSupportedLanguages mungkin terlihat seperti berikut ini:

https://translation.googleapis.com/v3/projects/my-project/locations/us-central1/supportedLanguages

Catatan: Semua resource yang ada dalam satu permintaan ke Cloud Translation - Advanced harus memiliki lokasi yang sama. Saat ini, hanya lokasi global dan us-central1 yang didukung. Untuk semua resource kustom—model AutoML, glosarium, operasi yang berjalan lama—Anda harus menggunakan us-central1. Anda juga dapat menggunakan us-central1 saat menggunakan model terjemahan dan deteksi bahasa umum. Anda hanya dapat menggunakan lokasi global saat menggunakan model terjemahan dan deteksi bahasa umum.

Cloud Translation - Advanced juga menyediakan endpoint multi-regional, seperti translate-eu.googleapis.com untuk menjaga penanganan data di dalam region Uni Eropa. Ini adalah endpoint unik untuk Uni Eropa dan bukan setelan lokasi di API global. Untuk informasi selengkapnya, baca Endpoint global dan multi-regional.

Batas konten per permintaan

Cloud Translation API dioptimalkan untuk menerjemahkan permintaan yang lebih kecil. Panjang maksimum yang direkomendasikan untuk setiap permintaan adalah 5 ribu karakter (poin kode). Namun, semakin banyak karakter yang Anda sertakan, latensi respons akan semakin tinggi. Untuk Cloud Translation - Advanced, jumlah maksimum poin kode untuk satu permintaan adalah 30 ribu. Cloud Translation - Basic memiliki ukuran permintaan maksimum sebesar 100 ribu byte.

Cloud Translation API akan menolak permintaan yang lebih besar dari jumlah maksimum dan akan memberikan error 400 INVALID_ARGUMENT, terlepas dari kuota yang tersedia.

Untuk informasi selengkapnya tentang kuota dan batas, baca Kuota.

Langkah berikutnya

Gunakan Cloud Translation - Advanced untuk menerjemahkan teks, membuat glosarium, atau membuat permintaan batch.