Perspective API'yi kullanmaya başlayın

Perspective API'yi kullanmaya başlayın

Bu codelab hakkında

Son güncelleme Mar 10, 2022

Yazan: Jigsaw

1. Başlamadan önce

Perspective API, internette daha iyi görüşmeler barındırmanıza yardımcı olan ücretsiz bir API'dir. API, bir metin dizesini analiz etmek ve bir ileti dizisi üzerinde yaratabileceği etkiyi tahmin etmek için makine öğrenimini (ML) kullanır.

Bu codelab'de, Perspective API'yi ayarlarsınız.

Not: Perspective API'nin içerik denetleme işlemini kolaylaştırması amaçlanmıştır. Amaç, karar mercilerinin çalışmalarının tamamen yerini alması değildir.

Neler öğreneceksiniz?

• İçeriği oluşturulduğu anda işaret eden, yapay zeka destekli bir moderasyon yaklaşımı.

Gerekenler

• Google Cloud erişimi için bir Google Hesabı
• Makul internet hızı

2. Başlarken

Başlamak için API isteklerinizin kimliğini doğrulamak üzere bir Google Cloud projesine ihtiyacınız vardır.

1. Google Cloud Console'da mevcut bir projeyi kullanın.
2. Gerekirse yeni proje oluşturmak için aşağıdaki adımları uygulayın:

• Google Hesabınızla oturum açın.
• Cloud Console'u açın.
• Proje Oluştur'u tıklayın veya Proje Seçin menüsünü açın ve ardından iletişim kutusunda Yeni Proje'yi tıklayın.
• Projenize bir ad verin ve Oluştur'u tıklayın.

Proje artık açılır menüde görünür.

API erişimi isteyin

• API erişimi isteğinde bulunmak için bu formu doldurun.

Bir saat içinde, API'yi Google Cloud'da görüntüleyip etkinleştirebileceğinizi onaylayan bir e-posta alırsınız.

Not: Bir iş günü içinde e-posta almazsanız formu tekrar doldurun veya destek ekibiyle iletişime geçin.

3. API'yi etkinleştirme

• Cloud Console'da Perspective API'ye genel bakış sayfasına gidip Etkinleştir'i tıklayın.

4. API anahtarını oluşturma

1. Gezinme menüsünde, API'ler & Hizmetler > Kimlik Bilgileri > Kimlik bilgileri oluştur > API Anahtarı'nı tıklayın.

Not: JavaScript gibi bir istemci tarafı dilinden istekte bulunursanız API anahtarınız tüm ziyaretçilere gösterilir. İsteği bir sunucu üzerinden proxy olarak ayarlamanız ve anahtarın tarayıcılardan gizlenmesi ve yalnızca sunucunuzun bu anahtarı kullanabilmesi için anahtar kısıtlamaları uygulamanız önemle tavsiye edilir. Daha fazla bilgi edinmek için istekte bir sunucu aracılığıyla nasıl proxy tutulacağına dair bir örneğe ve daha fazla API anahtarı güvenlik önerisine bakın.

API anahtarınız birkaç dakika içinde çalışır, ancak bu da bir saate kadar sürebilir. O zamana kadar bir hata mesajı alabilirsiniz.

2. API anahtarını kopyalayın.

5. Örnek Talepler

Google API İstemci Kitaplıklarıyla API istemci kitaplıkları oluşturabilirsiniz. Bu örneklerde, API kitaplığınızın en yaygın dillerden bazılarıyla nasıl ayarlanacağı gösterilmektedir.

1. AnalyzeComment isteğinde bulunun.
2. Doğrudan Perspective API'den puan almak için bu örnek API çağrılarından birini çalıştırın.

AnalyzeComment yöntemi, requestedAttributes için comment.text alanını analiz etmek üzere bir API isteği yayınlar. Bu örnekte, TOXICITY modeli kullanılmıştır.

3. API anahtarınızı API_KEY alanına yapıştırın.

Tercih ederseniz, puanlar iade edildikten sonra gönderilen tüm yorumların otomatik olarak silinmesini sağlamak için doNotStore işaretinden yararlanabilirsiniz.

4. Tüm istek ve yanıt alanlarının yanı sıra requestedAttributes için kullanılabilen değerler hakkında ayrıntılı bilgi edinmek için API referans dokümanlarını okuyun.

Kullanabileceğiniz OBSCENE, ATTACK_ON_gcloud ve SPAM gibi deneysel özellikler de vardır.

Python

Bu örnek istek ve yanıt, Google API İstemci Kitaplıklarının Python sürümünü kullanır.

1. Python istemci kitaplığını yükleyin.
2. Şu komutları çalıştırın:

Aşağıdakine benzer bir sonuç göreceksiniz:

Samimi karşılama mesajınız düşük bir zehirlilik puanı aldı.

Node.js

Bu örnek istek ve yanıt, Google API İstemci Kitaplıklarının Node.js sürümünü kullanır.

1. Node.js istemci kitaplığını veya npm paketini googleapis yükleyin.
2. Şu komutları çalıştırın:

Aşağıdakine benzer bir sonuç göreceksiniz:

cURL

Bu örnek istek ve yanıtta cURL komutu kullanılır. Bu komut, çoğu MacOS ve Linux kullanıcısı için işe yarayacaktır. Bu komutu çalıştırmak için cURL yüklemeniz gerekebilir.

• YOUR_KEY_HERE yerine API anahtarınızı yazın.

Bu yanıtta, attributeScores.TOXICITY.summaryScore.value alanı yorum için kötülük modeli puanı verir. Yorum 1,0 üzerinden 0,9 puan aldı.

6. Tebrikler

Perspective API'yi kullanmaya başladınız!

Daha fazla bilgi

• Perspective API web sitesi, örnek olaylar dahil olmak üzere API hakkında daha fazla bilgi içerir.
• Perspective API geliştiricileri web sitesinde özellikler, diller ve yöntemler hakkında daha fazla bilgi bulabilirsiniz. Hızlı bir şekilde başlamak istiyorsanız Yöntemler sayfasında AnalyzeComment ve SuggestCommentScore yöntemlerinin nasıl kullanılacağı açıklanmaktadır.