Střední s vlastními seznamy podmínek v konzole API

Výchozí globální seznam výrazů v Azure Content Moderatoru je dostačující pro většinu potřeb z hlediska moderování obsahu. Možná ale budete potřebovat vyhledat výrazy, které jsou specifické pro vaši organizaci. Například můžete chtít označit názvy konkurentů k další kontrole.

Pomocí rozhraní API pro správu seznamu můžete vytvořit vlastní seznamy podmínek, které se použijí v rozhraní API pro moderování textu. Operace text-Screen vyhledá text na základě vulgárních výrazů a také porovná text s vlastním a sdíleným adres.

Pomocí rozhraní API pro správu seznamu můžete provádět následující úlohy:

• Vytvoření seznamu
• Přidání výrazů do seznamu
• Porovnání výrazů s výrazy v seznamu
• Odstranění výrazů ze seznamu
• Odstranění seznamu
• Úprava informací o seznamu
• Aktualizace indexu tak, aby změny provedené v seznamu byly součástí nového porovnávání

Použití konzoly API

Než budete moct otestovat rozhraní API v online konzole, budete potřebovat svůj klíč předplatného. Tento klíč je umístěný na kartě Nastavení v poli OCP-APIM-Subscription-Key . Další informace najdete v tématu Přehled.

Aktualizovat index vyhledávání

Až provedete změny v seznamu termínů, je nutné aktualizovat index, aby se změny projevily v budoucích kontrolách. Tento krok je podobný tomu, jak vyhledávací modul na ploše (Pokud je povolen) nebo webový vyhledávací modul průběžně aktualizuje svůj index, aby zahrnoval nové soubory nebo stránky.

1. V referenčních informacích k rozhraní API pro správu seznamu termínův nabídce vlevo vyberte seznamy termínů a pak vyberte Aktualizovat index vyhledávání.

   Otevře se stránka termín seznamy-obnovit index vyhledávání .

2. V případě konzoly Open API Testing vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se modul seznam termínů – aktualizuje se konzola rozhraní API indexu vyhledávání.

3. Do pole listId zadejte ID seznamu. Zadejte svůj klíč předplatného a pak vyberte Odeslat.

   

Vytvoření seznamu výrazů

1. Přejít na Reference k rozhraní API pro správu seznamu termínů.

   Otevře se stránka termíny seznamy – vytvořit .

2. V případě konzoly Open API Testing vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se seznam termínů-vytvořit konzolu rozhraní API.

3. Do pole OCP-APIM-Subscription-Key zadejte svůj klíč předplatného.

4. Do pole Text žádosti zadejte hodnoty pro Name (například myList) a Description (popis).

   

5. Použijte zástupné symboly dvojice klíč-hodnota k přiřazení dalších popisných metadat k seznamu.

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

   Přidejte metadata seznamu jako páry klíč-hodnota, nikoli skutečné výrazy.

6. Vyberte Odeslat. Vytvoří se Váš seznam. Poznamenejte si hodnotu ID , která je přidružená k novému seznamu. Toto ID budete potřebovat pro jiné funkce správy seznamu termínů.

   

7. Přidejte do MyList výrazy. V nabídce vlevo v části termín vyberte Přidat termín.

   Otevře se stránka s termínem Přidat termín .

8. V případě konzoly Open API Testing vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola rozhraní API termínu Přidat .

9. Do pole listId zadejte ID seznamu, které jste vygenerovali, a vyberte hodnotu jazyk. Zadejte svůj klíč předplatného a pak vyberte Odeslat.

   

10. Chcete-li ověřit, zda byl termín přidán do seznamu, vyberte v nabídce vlevo možnost termín a pak vyberte možnost získat všechny podmínky.

    Otevře se konzola rozhraní API Term-get all terms .

11. Do pole listId zadejte ID seznamu a potom zadejte svůj klíč předplatného. Vyberte Odeslat.

12. V poli obsah odpovědi Ověřte zadané výrazy.

    

13. Přidejte několik dalších podmínek. Teď, když jste vytvořili vlastní seznam podmínek, zkuste zkontrolovat text pomocí vlastního seznamu termínů.

Odstranění výrazů a seznamů

Odstranění výrazu nebo seznamu je jednoduché. Pomocí tohoto rozhraní API provedete následující úlohy:

• Odstranění výrazu. (Doba odstranění)
• Odstranění všech výrazů v seznamu bez odstranění seznamu. (Podmínka – odstranění všech podmínek)
• Odstranění seznamu a veškerého jeho obsahu. (Seznamy termínů-odstranit)

Tento příklad odstraní jeden výraz.

1. V referenčních informacích k rozhraní API pro správu seznamu termínův nabídce vlevo vyberte termín a pak vyberte Odstranit.

   Otevře se výraz – odstranění .

2. V případě konzoly Open API Testing vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola rozhraní API pro odstranění termínů .

3. Do pole listId zadejte ID seznamu, ze kterého chcete odstranit termín. Toto ID je číslo (v našem příkladu, 122), které se vrátí do konzoly seznam termínů – získat podrobnosti pro myList. Zadejte termín a vyberte jazyk.

   

4. Zadejte svůj klíč předplatného a pak vyberte Odeslat.

5. Chcete-li ověřit, zda byl termín odstraněn, použijte seznam termínů – získat veškerou konzolu.

   

Změnit informace o seznamu

Můžete upravit název a popis seznamu a přidat položky metadat.

1. V referenčních informacích k rozhraní API pro správu seznamu termínův nabídce vlevo vyberte seznamy termínů a pak vyberte aktualizovat podrobnosti.

   Otevře se stránka termín seznamy – podrobnosti aktualizace .

2. V případě konzoly Open API Testing vyberte oblast, která nejlépe popisuje vaše umístění.

   

   Otevře se konzola seznam termínů – podrobnosti o aktualizaci rozhraní API.

3. Do pole listId zadejte ID seznamu a potom zadejte svůj klíč předplatného.

4. V poli Text žádosti proveďte úpravy a potom vyberte Odeslat.

   

Další kroky

Použijte REST API ve svém kódu nebo začněte s termínem Seznamte se s rychlým startem .NET pro integraci s vaší aplikací.