Translation API'yi C# ile Kullanma

1. Genel Bakış

Google Cloud Translation API, son teknoloji ürünü Nöral Makine Çevirisi kullanarak rastgele dizeleri desteklenen dillere dinamik olarak çevirmek için basit bir programatik arayüz sunar. Ayrıca, kaynak dilin bilinmediği durumlarda dilin tespit edilmesi için de kullanılabilir.

Bu codelab'de, Translation API'yi C# ile kullanmaya odaklanacaksınız. Mevcut dilleri nasıl listeleyeceğinizi, metni nasıl çevireceğinizi ve belirli bir metindeki dili nasıl tespit edeceğinizi öğreneceksiniz.

Neler öğreneceksiniz?

• Cloud Shell'i kullanma
• Translation API'yi etkinleştirme
• API isteklerinin kimliğini doğrulama
• C# için Google Cloud istemci kitaplığını yükleme
• Kullanılabilir diller nasıl listelenir?
• Metin nasıl çevrilir?
• Dil nasıl algılanır?

Gerekenler

• Bir Google Cloud Platform Projesi
• Chrome veya Firefox gibi bir tarayıcı
• C# kullanımı hakkında bilgi

Anket

Bu eğiticiden nasıl yararlanacaksınız?

Yalnızca okuma Okuyun ve alıştırmaları tamamlayın

C# ile ilgili deneyiminizi nasıl değerlendirirsiniz?

Acemi Orta Yeterli

Google Cloud Platform hizmetlerinin kullanımıyla ilgili deneyiminizi nasıl değerlendirirsiniz?

Acemi Orta Yeterli

2. Kurulum ve Gereksinimler

Kendi hızınızda ortam kurulumu

1. Google Cloud Console'da oturum açıp yeni bir proje oluşturun veya mevcut bir projeyi yeniden kullanın. Gmail veya Google Workspace hesabınız yoksa hesap oluşturmanız gerekir.

• Proje adı, bu projenin katılımcıları için görünen addır. Google API'leri tarafından kullanılmayan bir karakter dizesidir. İstediğiniz zaman güncelleyebilirsiniz.
• Proje Kimliği, tüm Google Cloud projelerinde benzersizdir ve değiştirilemez (belirlendikten sonra değiştirilemez). Cloud Console, otomatik olarak benzersiz bir dize oluşturur. bunun ne olduğunu umursamıyorsunuz. Çoğu codelab'de proje kimliğinizi (genellikle PROJECT_ID olarak tanımlanır) belirtmeniz gerekir. Oluşturulan kimliği beğenmezseniz rastgele bir kimlik daha oluşturabilirsiniz. Alternatif olarak, kendi ölçümünüzü deneyip mevcut olup olmadığına bakabilirsiniz. Bu adımdan sonra değiştirilemez ve proje süresince kalır.
• Bilginiz olması açısından, bazı API'lerin kullandığı üçüncü bir değer, yani Proje Numarası daha vardır. Bu değerlerin üçü hakkında daha fazla bilgiyi belgelerde bulabilirsiniz.

Dikkat: Proje kimliği genel olarak benzersizdir ve seçildikten sonra başkaları tarafından kullanılamaz. Bu kimliğin tek kullanıcısı sizsiniz. Proje silinse bile kimlik tekrar kullanılamaz

Not: Gmail hesabı kullanıyorsanız varsayılan konumu Kuruluş yok olarak bırakabilirsiniz. Google Workspace hesabı kullanıyorsanız kuruluşunuz için uygun bir konum seçin.

2. Sonraki adımda, Cloud kaynaklarını/API'lerini kullanmak için Cloud Console'da faturalandırmayı etkinleştirmeniz gerekir. Bu codelab'i çalıştırmanın maliyeti, yüksek değildir. Bu eğitim dışında faturalandırmanın tekrarlanmasını önlemek amacıyla kaynakları kapatmak için oluşturduğunuz kaynakları silebilir veya projeyi silebilirsiniz. Yeni Google Cloud kullanıcıları 300 ABD doları değerindeki ücretsiz denemeden yararlanabilir.

Cloud Shell'i başlatma

Google Cloud dizüstü bilgisayarınızdan uzaktan çalıştırılabilse de bu codelab'de, Cloud'da çalışan bir komut satırı ortamı olan Google Cloud Shell'i kullanacaksınız.

Google Cloud Console'da, sağ üstteki araç çubuğunda bulunan Cloud Shell simgesini tıklayın:

Ortamı sağlamak ve bağlamak yalnızca birkaç dakika sürer. Tamamlandığında şuna benzer bir sonuç görmeniz gerekir:

İhtiyacınız olan tüm geliştirme araçlarını bu sanal makinede bulabilirsiniz. 5 GB boyutunda kalıcı bir ana dizin sunar ve Google Cloud üzerinde çalışarak ağ performansını ve kimlik doğrulamasını büyük ölçüde iyileştirir. Bu codelab'deki tüm çalışmalarınız tarayıcıda yapılabilir. Herhangi bir şey yüklemeniz gerekmez.

3. Translation API'yi Etkinleştirme

Translation API'yi kullanmaya başlamadan önce API'yi etkinleştirmeniz gerekir. Cloud Shell'de aşağıdaki komutu kullanarak API'yi etkinleştirebilirsiniz:

gcloud services enable translate.googleapis.com

Not: Bu komut HATA veriyorsa geçerli proje kimliğinin codelab proje kimliğinizle eşleştiğinden emin olun.

Cloud Shell tarafından kullanılan geçerli proje kimliğini bulmak için aşağıdaki komutu kullanın:

gcloud info | grep "project"

Proje kimliği doğru değilse doğru proje kimliğini kullanmak için aşağıdaki komutu kullanın:

gcloud config set project <PROJECT_ID>

<PROJECT_ID> kısmını doğru Proje Kimliğiyle değiştirin.

4. C# için Google Cloud Translation API istemci kitaplığını yükleme

Öncelikle, Translation API örneklerini çalıştırmak için kullanacağınız basit bir C# konsol uygulaması oluşturun.

dotnet new console -n TranslationApiDemo

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

Sonra, TranslationApiDemo klasörüne gidin ve projeye Google.Cloud.Translation.V2 NuGet paketini ekleyin:

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'.

Artık Translation API'yi kullanmaya hazırsınız!

5. Kullanılabilir Dilleri Listeleyin

Bu bölümde öncelikle Translation API'deki mevcut tüm dilleri listeleyeceksiniz.

İlk olarak Cloud Shell'in sağ üst tarafından kod düzenleyiciyi açın:

TranslationApiDemo klasörünün içindeki Program.cs dosyasına gidin ve kodu aşağıdakiyle değiştirin:

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}");
            }
        }
    }
}

Bir veya iki dakikanızı ayırarak kodu inceleyin*.* Dil adlarının İngilizce olarak listelendiğini, ancak herhangi bir dilde de listelenebileceğini unutmayın.

Cloud Shell'e dönüp uygulamayı çalıştırın. Aşağıdaki çıkışı göreceksiniz:

dotnet run

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

Not: Bu C# kodu işinize yaramazsa API isteklerinin kimliğini doğrulama adımında uyguladığınız talimatları doğrulayın.

GOOGLE_APPLICATION_CREDENTIALS ortam değişkeninin değerini doğrulamak için aşağıdaki komutu kullanın:

echo GOOGLE_APPLICATION_CREDENTIALS

"~/key.json". değerini vermelidir

Görünüyorsa bir hizmet hesabının oluşturulduğundan ve "~/key.json" adresinde bulunduğundan emin olmak için aşağıdakileri kullanın:

cat "~/key.json"

Şuna benzer bir sayfa görmeniz gerekir:

{

"type": "service_account",

"project_id": "PROJECT_ID",

"private_key_id": "ff31939192529e07f42e4535fb20bb029def1276",

"Private_key":...

Yoksa API isteklerinin kimliğini doğrulama adımını yeniden ziyaret edin.

Özet

Bu adımda, Translation API'deki mevcut tüm dilleri listelemeyi başardınız. Desteklenen dillerin tam listesini Dil Desteği sayfasında bulabilirsiniz.

6. Metin çevirme

Bir dildeki metni başka bir dile çevirmek için Translation API'yi kullanabilirsiniz. Metin, Nöral Makine Çevirisi (NMT) modeli kullanılarak çevrilir. İstenen dil çeviri çifti için NMT modeli desteklenmiyorsa Sıralı Tabanlı Makine Çevirisi (PBMT) modeli kullanılır.

Metni çevirmek için TranslationApiDemo klasöründeki Program.cs dosyasına gidin ve kodu aşağıdaki kodla değiştirin:

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);
        }
    }
}

Bir iki dakikanızı ayırarak kodu inceleyin. "Hello World" metnini çevirir İngilizceden Türkçeye*.*

Cloud Shell'e dönüp uygulamayı çalıştırın. Aşağıdaki çıkışı göreceksiniz:

dotnet run

Selam Dünya!

Özet

Bu adımda, Translation API'yi kullanarak bir metni İngilizceden Türkçeye çevirebildiniz. Metin çevirme hakkında daha fazla bilgi edinin.

7. Dili algıla

Bir metin dizesinin dilini algılamak için de Translation API'yi kullanabilirsiniz.

Dili algılamak için TranslationApiDemo klasöründeki Program.cs dosyasına gidin ve kodu aşağıdakiyle değiştirin:

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}");
        }
    }
}

Bir iki dakikanızı ayırarak kodu inceleyin. "Selam Dünya!" metninin dilini algılar Türkçe bir ifadedir*.*

Cloud Shell'e dönüp uygulamayı çalıştırın. Aşağıdaki çıkışı göreceksiniz:

dotnet run

Language: tr        Confidence: 1

Özet

Bu adımda, Translation API'yi kullanarak bir metin parçasının dilini tespit edebildiniz. Dili algılama hakkında daha fazla bilgi edinin.

8. Tebrikler!

Translation API'yi C# kullanarak nasıl kullanacağınızı öğrendiniz.

Temizleme

Bu hızlı başlangıçta kullanılan kaynaklar için Google Cloud Platform hesabınızın ücretlendirmesini önlemek amacıyla:

• Cloud Platform Console'a gidin.
• Kapatmak istediğiniz projeyi seçin, ardından "Sil"i tıklayın üstte üstte yer alır: Bu işlem, projeyi silinmek üzere programlar.

Daha Fazla Bilgi

• Google Cloud Translation API: https://cloud.google.com/translate/docs
• Google Cloud Platform'da C#/.NET: https://cloud.google.com/dotnet/
• Google Cloud .NET istemcisi: https://googlecloudplatform.github.io/google-cloud-dotnet/

Lisans

Bu çalışma, Creative Commons Attribution 2.0 Genel Amaçlı Lisans ile lisans altına alınmıştır.