Menggunakan Translation API dengan C#

1. Ringkasan

Google Cloud Translation API menyediakan antarmuka terprogram yang sederhana untuk menerjemahkan string arbitrer secara dinamis ke dalam bahasa apa pun yang didukung menggunakan Terjemahan Mesin Neural yang canggih. API ini juga dapat digunakan untuk mendeteksi bahasa jika bahasa sumber tidak diketahui.

Dalam codelab ini, Anda akan berfokus pada penggunaan Translation API dengan C#. Anda akan mempelajari cara membuat daftar bahasa yang tersedia, menerjemahkan teks, dan mendeteksi bahasa dari teks tertentu.

Yang akan Anda pelajari

Cara menggunakan Cloud Shell
Cara mengaktifkan Translation API
Cara Mengautentikasi permintaan API
Cara menginstal library klien Google Cloud untuk C#
Cara mencantumkan bahasa yang tersedia
Cara menerjemahkan teks
Cara mendeteksi bahasa

Yang Anda butuhkan

Project Google Cloud Platform
Browser, seperti Chrome atau Firefox
Pemahaman dalam menggunakan C#

Survei

Bagaimana Anda akan menggunakan tutorial ini?

Hanya membacanya

Membacanya dan menyelesaikan latihan

Bagaimana penilaian Anda terhadap pengalaman Anda dengan C#?

Pemula

Menengah

Mahir

Bagaimana penilaian Anda terhadap pengalaman menggunakan layanan Google Cloud Platform?

Pemula

Menengah

Mahir

2. Penyiapan dan Persyaratan

Penyiapan lingkungan mandiri

Login ke Google Cloud Console dan buat project baru atau gunakan kembali project yang sudah ada. Jika belum memiliki akun Gmail atau Google Workspace, Anda harus membuatnya.

Project name adalah nama tampilan untuk peserta project ini. String ini adalah string karakter yang tidak digunakan oleh Google API. Anda dapat memperbaruinya kapan saja.
Project ID bersifat unik di semua project Google Cloud dan tidak dapat diubah (tidak dapat diubah setelah ditetapkan). Cloud Console otomatis membuat string unik; biasanya Anda tidak mementingkan kata-katanya. Di sebagian besar codelab, Anda harus merujuk Project ID-nya (umumnya diidentifikasi sebagai PROJECT_ID). Jika tidak suka dengan ID yang dibuat, Anda dapat membuat ID acak lainnya. Atau, Anda dapat mencobanya sendiri, dan lihat apakah ID tersebut tersedia. ID tidak dapat diubah setelah langkah ini dan tersedia selama durasi project.
Sebagai informasi, ada nilai ketiga, Project Number, yang digunakan oleh beberapa API. Pelajari lebih lanjut ketiga nilai ini di dokumentasi.

Selanjutnya, Anda harus mengaktifkan penagihan di Konsol Cloud untuk menggunakan resource/API Cloud. Menjalankan operasi dalam codelab ini tidak akan memakan banyak biaya, bahkan mungkin tidak sama sekali. Guna mematikan resource agar tidak menimbulkan penagihan di luar tutorial ini, Anda dapat menghapus resource yang dibuat atau menghapus project-nya. Pengguna baru Google Cloud memenuhi syarat untuk mengikuti program Uji Coba Gratis senilai $300 USD.

Mulai Cloud Shell

Meskipun Google Cloud dapat dioperasikan dari jarak jauh menggunakan laptop Anda, dalam codelab ini, Anda akan menggunakan Google Cloud Shell, lingkungan command line yang berjalan di Cloud.

Dari Google Cloud Console, klik ikon Cloud Shell di toolbar kanan atas:

Hanya perlu waktu beberapa saat untuk penyediaan dan terhubung ke lingkungan. Jika sudah selesai, Anda akan melihat tampilan seperti ini:

Mesin virtual ini berisi semua alat pengembangan yang Anda perlukan. Layanan ini menawarkan direktori beranda tetap sebesar 5 GB dan beroperasi di Google Cloud, sehingga sangat meningkatkan performa dan autentikasi jaringan. Semua pekerjaan Anda dalam codelab ini dapat dilakukan di browser. Anda tidak perlu menginstal apa pun.

3. Aktifkan Translation API

Sebelum dapat mulai menggunakan Translation API, Anda harus mengaktifkan API. Anda dapat mengaktifkan API dengan menggunakan perintah berikut di Cloud Shell:

gcloud services enable translate.googleapis.com

4. Instal library klien Google Cloud Translation API untuk C#

Pertama, buat aplikasi konsol C# sederhana yang akan Anda gunakan untuk menjalankan contoh Translation API.

dotnet new console -n TranslationApiDemo

The template "Console Application" was created successfully.
Processing post-creation actions...
...
Restore succeeded.

Selanjutnya, buka folder TranslationApiDemo dan tambahkan paket NuGet Google.Cloud.Translation.V2 ke project:

cd TranslationApiDemo/
dotnet add package Google.Cloud.Translation.V2

info : Adding PackageReference for package 'Google.Cloud.Translation.V2' into project '/home/atameldev/TranslationDemo/TranslationDemo.csproj'.
log  : Restoring packages for /home/atameldev/TranslationDemo/TranslationDemo.csproj...
...
info : PackageReference for package 'Google.Cloud.Translation.V2' version '1.0.0' added to file '/home/atameldev/TranslationDemo/TranslationDemo.csproj'.

Sekarang, Anda siap menggunakan Translation API.

5. Mencantumkan Bahasa yang Tersedia

Di bagian ini, Anda akan mencantumkan semua bahasa yang tersedia di Translation API terlebih dahulu.

Pertama, buka editor kode dari sisi kanan atas Cloud Shell:

Buka file Program.cs di dalam folder TranslationApiDemo dan ganti kode dengan kode berikut:

using System;
using Google.Cloud.Translation.V2;

namespace TranslationApiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = TranslationClient.Create();
            foreach (var language in client.ListLanguages(LanguageCodes.English))
            {
                Console.WriteLine($"{language.Code}\t{language.Name}");
            }
        }
    }
}

Luangkan waktu satu atau dua menit untuk mempelajari kode*.* Perhatikan bahwa kami mencantumkan nama bahasa dalam bahasa Inggris, tetapi nama tersebut dapat dicantumkan dalam bahasa apa pun.

Kembali di Cloud Shell, jalankan aplikasi. Anda akan melihat output berikut:

dotnet run

af        Afrikaans
sq        Albanian
am        Amharic
ar        Arabic
hy        Armenian
az        Azerbaijani
eu        Basque
be        Belarusian
...
yi        Yiddish
yo        Yoruba
zu        Zulu

Ringkasan

Pada langkah ini, Anda dapat mencantumkan semua bahasa yang tersedia di Translation API. Anda dapat menemukan daftar lengkap bahasa yang didukung di halaman Dukungan Bahasa.

6. Terjemahkan teks

Anda dapat menggunakan Translate API untuk menerjemahkan teks dalam satu bahasa ke bahasa lain. Teks diterjemahkan menggunakan model Terjemahan Mesin Neural (NMT). Jika model NMT tidak didukung untuk pasangan bahasa terjemahan yang diminta, model Terjemahan Mesin Berbasis Frasa (PBMT) akan digunakan.

Untuk menerjemahkan teks, buka file Program.cs di dalam folder TranslationApiDemo dan ganti kode dengan kode berikut:

using System;
using Google.Cloud.Translation.V2;

namespace TranslationApiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = TranslationClient.Create();
            var text = "Hello World!";
            var response = client.TranslateText(text, LanguageCodes.Turkish, LanguageCodes.English);
            Console.WriteLine(response.TranslatedText);
        }
    }
}

Luangkan waktu satu atau dua menit untuk mempelajari kode. Aplikasi ini menerjemahkan teks "Hello World" dari bahasa Inggris ke bahasa Turkiye*.*

Kembali di Cloud Shell, jalankan aplikasi. Anda akan melihat output berikut:

dotnet run

Selam Dünya!

Ringkasan

Pada langkah ini, Anda dapat menggunakan Translation API untuk menerjemahkan teks dari bahasa Inggris ke bahasa Turki. Baca selengkapnya tentang Menerjemahkan teks.

7. Deteksi bahasa

Anda juga dapat menggunakan Translation API untuk mendeteksi bahasa string teks.

Untuk mendeteksi bahasa, buka file Program.cs di dalam folder TranslationApiDemo, lalu ganti kode dengan kode berikut:

using System;
using Google.Cloud.Translation.V2;

namespace TranslationApiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            var client = TranslationClient.Create();
            var text = "Selam Dünya!";
            var detection = client.DetectLanguage(text);
            Console.WriteLine($"Language: {detection.Language}\tConfidence: {detection.Confidence}");
        }
    }
}

Luangkan waktu satu atau dua menit untuk mempelajari kode. API ini mendeteksi bahasa teks "Selam Dünya!" yang ternyata merupakan frasa dalam bahasa Turki*.*

Kembali di Cloud Shell, jalankan aplikasi. Anda akan melihat output berikut:

dotnet run

Language: tr        Confidence: 1

Ringkasan

Pada langkah ini, Anda dapat mendeteksi bahasa suatu teks menggunakan Translation API. Baca selengkapnya tentang Mendeteksi bahasa.

8. Selamat!

Anda telah mempelajari cara menggunakan Translation API menggunakan C#.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Platform Anda untuk resource yang digunakan di panduan memulai ini:

Buka Cloud Platform Console.
Pilih project yang ingin Anda nonaktifkan, lalu klik 'Hapus' di bagian atas: tindakan ini akan menjadwalkan penghapusan project.

Pelajari Lebih Lanjut

Google Cloud Translation API: https://cloud.google.com/translate/docs
C#/.NET di Google Cloud Platform: https://cloud.google.com/dotnet/
Klien .NET Google Cloud: https://googlecloudplatform.github.io/google-cloud-dotnet/

Lisensi

Karya ini dilisensikan berdasarkan Lisensi Umum Creative Commons Attribution 2.0.