API konsolundaki Ö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 denetleme API 'siyle birlikte kullanmak üzere özel terim listeleri oluşturmak için liste YÖNETIMI API 'sini kullanın. Metin -ekran işlemi metninizi küfür için tarar ve ayrıca metni özel ve paylaşılan blok listeleriyle karşılaştırır.

Not

En çok 5 terim listeniz olabilir ve her listedeki terimlerin sayısı 10.000'i aşmamalıdır.

Aşağıdaki görevleri yapmak için liste yönetimi API 'sini kullanabilirsiniz:

  • 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

Çevrimiçi konsolda API 'YI test etmeden önce, abonelik anahtarınız olmalıdır. Bu anahtar, OCP-apim-Subscription-Key kutusundaki Ayarlar sekmesinde bulunur. Daha fazla bilgi için bkz. Genel Bakış.

Arama dizinini Yenile

Bir terim listesinde değişiklik yaptıktan sonra, gelecekteki taramalara dahil edilecek değişikliklerin dizinini yenilemeniz gerekir. Bu adım, masaüstünüzdeki bir arama altyapısının (etkinse) veya bir Web araması altyapısının, yeni dosya veya sayfaları içerecek şekilde dizinini sürekli olarak yenilediğine benzer.

  1. Liste yönetimi API 'si başvurusunda, sol menüsünde, terim listeleri' ni seçin ve ardından Arama dizinini Yenile' yi seçin.

    Liste ara dizini Yenile sayfası açılır.

  2. Open API test konsolu için, konumunuzu en iyi şekilde açıklayan bölgeyi seçin.

    Terim listeleri-arama dizini sayfa bölgesi seçimini Yenile

    Liste terimi-arama dizinini Yenile API konsolu açılır.

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

    Terim listeleri API 'SI-arama dizini konsol yanıtı içerik kutusunu Yenile

Terim listesi oluşturma

  1. Liste YÖNETIMI API başvurusu' na gidin.

    Listeler-oluştur sayfası açılır.

  2. Open API test konsolu için, konumunuzu en iyi şekilde açıklayan bölgeyi seçin.

    Terim listeleri-sayfa bölgesi seçimi oluşturma

    Listeler-API konsolu oluşturma terimi açılır.

  3. OCP-apim-Subscription-Key kutusuna abonelik anahtarınızı girin.

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

    Terim listeleri-konsol Isteği gövdesi adı ve açıklaması oluşturma

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

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

    Anahtar-değer çiftleri olarak liste meta verileri ekleyin ve gerçek koşullar değildir.

  6. Gönder’i seçin. Listeniz oluşturulur. Yeni liste ile ilişkili olan kimlik değerini unutmayın. Diğer terim listesi yönetim işlevleri için bu KIMLIĞE ihtiyacınız vardır.

    Terim listeleri-konsol yanıt içeriği oluştur kutusu liste KIMLIĞINI gösterir

  7. Koşulları MyList öğesine ekleyin. Sol taraftaki menüde terim' ın altında Terim Ekle' yi seçin.

    Terim ekleme terimi sayfası açılır.

  8. Open API test konsolu için, konumunuzu en iyi şekilde açıklayan bölgeyi seçin.

    Terim-terim Ekle sayfa bölge seçimi

    Terim ekleme API 'si konsolu açılır.

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

    Terim-terim konsolu sorgu parametreleri Ekle

  10. Terimin listeye eklendiğini doğrulamak için, sol taraftaki menüden terim' i seçin ve ardından tüm terimleri al' ı seçin.

    Terim al tüm terimleri al API konsolu açılır.

  11. ListId kutusuna liste kimliği ' ni girin ve ardından abonelik anahtarınızı girin. Gönder’i seçin.

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

    Terim-tüm terimleri al konsol yanıtı içerik kutusu, girdiğiniz terimleri listeler

  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. API 'YI kullanarak aşağıdaki görevleri gerçekleştirebilirsiniz:

  • Terim silme. (Terim silme)
  • Listeyi silmeden listedeki tüm terimleri silme. (Dönem-tüm terimleri Sil)
  • Listeyi ve tüm içeriğini silme. (Terim listeleri-silme)

Bu örnek tek bir terimi siler.

  1. Liste yönetimi API 'si başvurusunda, sol menüsünde terim' i seçin ve ardından Sil' i seçin.

    -Delete terimi açılır.

  2. Open API test konsolu için, konumunuzu en iyi şekilde açıklayan bölgeyi seçin.

    Terim-sayfa bölgesi seçimini silme

    Terim silme API 'si konsolu açılır.

  3. ListId kutusuna bir terim silmek ISTEDIĞINIZ listenin kimliğini girin. Bu KIMLIK, MyList için liste ayrıntıları konsolundan döndürülen sayıdır (bizim örneğimizde, 122). Terimi girin ve bir dil seçin.

    Terim-konsol sorgu parametrelerini Sil

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

  5. Terimin silindiğini doğrulamak için, liste koşulları-tüm Konsolu al ' ı kullanın.

    Terim listeleri-tüm konsol yanıtı içerik kutusunu al, terimin silindiğini gösterir

Liste bilgilerini değiştir

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

  1. Liste yönetimi API 'si başvurusunda, sol menüsünde, terim listeleri' ni seçin ve ardından Güncelleştirme ayrıntıları' nı seçin.

    Liste terimi-Güncelleştirme ayrıntıları sayfası açılır.

  2. Open API test konsolu için, konumunuzu en iyi şekilde açıklayan bölgeyi seçin.

    Terim listeleri-Güncelleştirme ayrıntıları sayfası bölge seçimi

    Liste terimi-Güncelleştirme ayrıntıları API konsolu açılır.

  3. ListId kutusuna liste kimliği ' ni girin ve ardından abonelik anahtarınızı girin.

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

    Terim listeleri-Güncelleştirme ayrıntıları konsolu Istek gövdesi düzenlemeleri

Sonraki adımlar

Uygulamanızla birleştirmek için kodunuzda REST API kullanın veya .net hızlı başlangıcı ile başlayın.