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 untuk menggunakan Cloud Translation - Advanced (v3). Untuk perbandingan, silakan melihat 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 menggunakan Cloud Translation - Basic menjadi menggunakan 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 menggunakan model AutoML dengan Cloud Translation - Advanced, Anda juga harus mengaktifkan AutoML. Untuk mengetahui informasi selengkapnya, silakan melihat panduan Penyiapan
5. Gunakan library dan metode klien 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, silakan melihat panduan penyiapan.

Peran IAM

Saat Anda menggunakan akun layanan untuk Cloud Translation - Basic, akun layanan tersebut hanya digunakan untuk autentikasi. Anda dapat melakukan panggilan ke Cloud Translation - Basic, tanpa perlu memikirkan izin yang terkait dengan akun layanan. Namun, untuk Cloud Translation - Advanced, izin 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 mengetahui informasi selengkapnya, silakan melihat 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, silakan melihat dokumentasi Peran IAM.

Model Terjemahan

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

Akun layanan yang Anda gunakan untuk permintaan terjemahan harus memiliki izin untuk mengakses model NMT dan AutoML, yang dapat ditempatkan di berbagai project. Misalnya, Anda mungkin memiliki project pusat yang berisi model terjemahan yang Anda inginkan 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, lsilakan meihat 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 mengetahui informasi selengkapnya, silakan membaca ringkasan library klien Cloud Translation - Advanced atau coba panduan memulai menerjemahkan teks (edisi advanced).

Resource, project, dan lokasi

Permintaan ke Cloud Translation - Lanjutan 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 dijalankan. Misalnya, nama model AutoML adalah nama resource.

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

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

URL yang Anda kirimkan permintaan getSupportedLanguages mungkin terlihat seperti berikut:

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

Catatan: Semua resource Anda 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 telah berjalan lama—Anda harus menggunakan us-central1. Anda juga dapat menggunakan us-central1 saat menggunakan model terjemahan dan deteksi bahasa secara umum. Anda hanya dapat menggunakan lokasi global saat menggunakan model terjemahan dan deteksi bahasa secara umum.

Cloud Translation - Advanced juga menyediakan endpoint multi-regional, seperti translate-eu.googleapis.com untuk menjaga penanganan data dalam region Uni Eropa. Ini adalah endpoint unik untuk Uni Eropa dan bukan setelan lokasi di API global. Untuk mengetahui informasi selengkapnya, silakan melihat 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, semakin tinggi latensi respons. 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 menolak permintaan yang lebih besar dari jumlah maksimum dan memberikan error 400 INVALID_ARGUMENT, terlepas dari kuota yang tersedia.

Untuk mengetahui informasi selengkapnya tentang kuota dan batas, silakan melihat Kuota.

Langkah berikutnya

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