Halaman ini diterjemahkan oleh Cloud Translation API.

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. Alat 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 mencantumkan bahasa yang tersedia, menerjemahkan teks, dan juga mendeteksi bahasa 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 menampilkan 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 Anda menilai 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.

295004821bab6a87.pngS

96d86d3d5655cdbe.pngS

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:

84688aa223b1c3a2.pngS

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

320e18fedb7fbe0.pngS

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. Mengaktifkan Translation API

Sebelum dapat mulai menggunakan Translation API, Anda harus mengaktifkan API. Anda dapat mengaktifkan API 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 untuk menggunakan Translation API.

5. Mencantumkan Bahasa yang Tersedia

Di bagian ini, pertama-tama Anda akan mencantumkan semua bahasa yang tersedia di Translation API.

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 kodenya*.* Perhatikan bahwa kami mencantumkan nama bahasa dalam bahasa Inggris, tetapi dapat dicantumkan dalam bahasa apa pun.

Kembali ke 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 dari satu bahasa ke bahasa lain. Teks diterjemahkan menggunakan model Terjemahan Mesin Neural (NMT). Jika model NMT tidak didukung untuk pasangan terjemahan bahasa 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 kodenya. Ini menerjemahkan teks "Hello World" (Halo Dunia) dari bahasa Inggris ke Turki*.*

Kembali ke 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 dapat menggunakan Translate API untuk mendeteksi bahasa string teks.

Untuk mendeteksi bahasa, 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 = "Selam Dünya!";
            var detection = client.DetectLanguage(text);
            Console.WriteLine($"Language: {detection.Language}\tConfidence: {detection.Confidence}");
        }
    }
}

Luangkan waktu satu atau dua menit untuk mempelajari kodenya. Perangkat ini mendeteksi bahasa teks "Selam Dünya!" yang merupakan frasa bahasa Turkiye*.*

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

dotnet run

Language: tr        Confidence: 1

Ringkasan

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

8. Selamat!

Anda telah mempelajari cara menggunakan Translation API dengan 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 dinonaktifkan, lalu klik 'Delete' di bagian atas: tindakan ini 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.