API konsolunda özel terim listeleriyle orta

Azure Content Moderator'daki varsayılan genel terim listesi, içerik moderasyonu ihtiyaçlarının büyük bölümü için yeterlidir. Bununla birlikte, kuruluşunuza özgü terimleri elemek gerekebilir. Örneğin, daha fazla incelemek üzere rakiplerin adlarını etiketlemek isteyebilirsiniz.

Metin Denetimi API'siyle kullanılacak özel terim listeleri oluşturmak için Liste Yönetimi API'sini kullanın. Metin - Ekran işlemi, metninizi küfür açısından tarar ve ayrıca metni özel ve paylaşılan blok listeleriyle karşılaştırır.

Dekont

Üst sınır, her biri 10.000 terimi aşmamak kaydıyla 5 listedir.

Liste Yönetimi API'sini kullanarak aşağıdaki görevleri gerçekleştirebilirsiniz:

• Liste oluşturma.
• Listeye terimleri ekleme.
• Terimleri listedeki terimlere göre eleme.
• Listeden terim silme.
• Listeyi silme.
• Liste bilgileri düzenleme.
• Listede yapılan değişikliklerin yeni taramaya eklenmesi için dizini yenileyin.

API konsolunu kullanma

API'yi çevrimiçi konsolda test sürüşü için önce abonelik anahtarınıza ihtiyacınız vardır. Bu anahtar, Ayarlar sekmesinde, Ocp-Apim-Subscription-Key kutusunda bulunur. Daha fazla bilgi için bkz. Genel Bakış.

Arama dizinini yenile

Terim listesinde değişiklik yaptıktan sonra, değişikliklerin gelecekteki taramalara dahil edilmesi için dizinini yenilemeniz gerekir. Bu adım, masaüstünüzdeki bir arama altyapısının (etkinleştirildiyse) veya bir web arama motorunun dizini sürekli yeni dosya veya sayfa içerecek şekilde yenilemesine benzer.

1. Terim Listesi Yönetimi API başvurusunun sol menüsünde Terim Listeleri'ni ve ardından Arama Dizinini Yenile'yi seçin.

   Terim Listeleri - Arama Dizinini Yenile sayfası açılır.

2. Open API test konsolu için konumunuzu en yakından açıklayan bölgeyi seçin.

   

   Terim Listeleri - Arama Dizini Api'sini Yenile konsolu açılır.

3. listId kutusuna liste kimliğini girin. Abonelik anahtarınızı girin ve Gönder'i seçin.

   

Terim listesi oluşturma

1. Terim Listesi Yönetimi API başvurusuna gidin.

   Terim Listeleri - Oluştur sayfası açılır.

2. Open API test konsolu için konumunuzu en yakından açıklayan bölgeyi seçin.

   

   Terim Listeleri - API oluştur konsolu açılır.

3. Ocp-Apim-Subscription-Key kutusuna abonelik anahtarınızı girin.

4. İstek gövdesi kutusuna Ad (örneğin, Listem) ve Açıklama değerlerini girin.

   

5. Listenize daha açıklayıcı meta veriler atamak için anahtar-değer çifti yer tutucularını kullanın.

   {
       "Name": "MyExclusionList",
       "Description": "MyListDescription",
       "Metadata": 
       {
           "Category": "Competitors",
           "Type": "Exclude"
       }
   }
   

   Liste meta verilerini gerçek terimler olarak değil anahtar-değer çiftleri olarak ekleyin.

6. Gönder'i seçin. Listeniz oluşturulur. Yeni listeyle ilişkili kimlik değerini not edin. Diğer terim listesi yönetim işlevleri için bu kimlik gereklidir.

   

7. MyList'e terimler ekleyin. Soldaki menüde, Terim'in altında Terim Ekle'yi seçin.

   Terim - Terim Ekle sayfası açılır.

8. Open API test konsolu için konumunuzu en yakından açıklayan bölgeyi seçin.

   

   Terim - Terim Ekle API'si konsolu açılır.

9. listId kutusuna, oluşturduğunuz liste kimliğini girin ve dil için bir değer seçin. Abonelik anahtarınızı girin ve Gönder'i seçin.

   

10. Terimin listeye eklendiğini doğrulamak için soldaki menüde Terim'i ve ardından Tüm Koşulları Al'ı seçin.

    Terim - Tüm Terimleri Al API konsolu açılır.

11. listId kutusuna liste kimliğini girin ve abonelik anahtarınızı girin. Gönder'i seçin.

12. Yanıt içeriği kutusunda, girdiğiniz terimleri doğrulayın.

    

13. Birkaç terim daha ekleyin. Artık özel bir terim listesi oluşturduğunuza göre, özel terim listesini kullanarak bazı metinleri taramayı deneyin.

Terimleri ve listeleri silme

Terim veya listeyi silmek basit bir işlemdir. Aşağıdaki görevleri gerçekleştirmek için API'yi kullanırsınız:

• Terim silme. (Terim - Sil)
• Listeyi silmeden listedeki tüm terimleri silme. (Terim - Tüm Koşulları Sil)
• Listeyi ve tüm içeriğini silme. (Terim Listeleri - Sil)

Bu örnek tek bir terimi siler.

1. Terim Listesi Yönetimi API başvurusunun sol menüsünde Terim'i ve ardından Sil'i seçin.

   Terim - Sil açılır.

2. Open API test konsolu için konumunuzu en yakından açıklayan bölgeyi seçin.

   

   Terim - Silme API'si konsolu açılır.

3. listId kutusuna, terim silmek istediğiniz listenin kimliğini girin. Bu kimlik, Listem için Terim Listeleri - Ayrıntıları Al konsolunda döndürülen sayıdır (örneğimizde 122). Terimi girin ve bir dil seçin.

   

4. Abonelik anahtarınızı girin ve Gönder'i seçin.

5. Terimin silindiğini doğrulamak için Terim Listeleri - Tümünü Al konsolunu kullanın.

   

Liste bilgilerini değiştirme

Bir listenin adını ve açıklamasını düzenleyebilir ve meta veri öğeleri ekleyebilirsiniz.

1. Terim Listesi Yönetimi API başvurusunun sol menüsünde Terim Listeleri'ni ve ardından Ayrıntıları Güncelleştir'i seçin.

   Terim Listeleri - Güncelleştirme Ayrıntıları sayfası açılır.

2. Open API test konsolu için konumunuzu en yakından açıklayan bölgeyi seçin.

   

   Terim Listeleri - Güncelleştirme Ayrıntıları API'si konsolu açılır.

3. listId kutusuna liste kimliğini girin ve abonelik anahtarınızı girin.

4. İstek gövdesi kutusunda düzenlemelerinizi yapın ve gönder'i seçin.

   

Sonraki adımlar

Uygulamanızla tümleştirmek için kodunuzda REST API'yi kullanın veya Terim listeleri .NET hızlı başlangıcıyla başlayın.