Gemiddeld met aangepaste termen lijsten in de API-console

Artikel
05/13/2021
4 minuten om te lezen

De standaardlijst met algemene termen van Azure Content Moderator is voldoende voor de meeste moderatietaken voor inhoudsbeheer. Het is echter mogelijk dat u inhoud moet controleren op termen die specifiek zijn voor uw organisatie. Zo is het bijvoorbeeld mogelijk dat u namen van concurrenten wilt taggen voor nader onderzoek.

Gebruik de lijst beheer-API om aangepaste lijsten met termen te maken voor gebruik met de API voor tekst toezicht. De tekst scherm bewerking scant uw tekst voor scheld woorden en vergelijkt ook tekst met aangepaste en gedeelde ip's.

Notitie

Er is een maximumlimiet van 5 terminologielijsten waarbij elke lijst niet meer dan 10.000 termen mag bevatten.

U kunt de lijst beheer-API gebruiken om de volgende taken uit te voeren:

Een lijst maken.
Termen toevoegen aan een lijst.
Termen vergelijken met de termen in een lijst.
Termen verwijderen uit een lijst.
Een lijst verwijderen.
Lijstgegevens bewerken.
De index vernieuwen zodat wijzigingen in de lijst worden gebruikt in een nieuwe scan.

De API-console gebruiken

Voordat u de API in de online console kunt testen, moet u uw abonnements sleutel hebben. Deze sleutel bevindt zich op het tabblad instellingen in het vak OCP-APIM-Subscription-Key . Zie Overzicht voor meer informatie.

Zoek index vernieuwen

Nadat u wijzigingen in een lijst met termen hebt aangebracht, moet u de index vernieuwen zodat wijzigingen worden opgenomen in toekomstige scans. Deze stap is vergelijkbaar met de manier waarop een zoek machine op het bureau blad (indien ingeschakeld) of een zoek machine op Internet de index doorlopend vernieuwt om nieuwe bestanden of pagina's te bevatten.

Selecteer in de termen lijst beheer API-verwijzingin het menu links de optie termen lijsten en selecteer vervolgens zoek index vernieuwen.

De lijst met termen-pagina zoek index vernieuwen wordt geopend.
Voor open API-test console selecteert u de regio die uw locatie het meest beschrijft.

De lijst met termen-de API-console zoek index vernieuwen wordt geopend.
Voer in het vak listId de lijst-ID in. Voer uw abonnements sleutel in en selecteer vervolgens verzenden.

Een termenlijst maken

Ga naar de API-verwijzing voor het beheer van de termen lijst.

De pagina termen lijst-maken wordt geopend.
Voor open API-test console selecteert u de regio die uw locatie het meest beschrijft.

De lijst met termen-API-console maken wordt geopend.
Voer in het vak OCP-APIM-Subscription-Key uw abonnements sleutel in.
Voer in het vak hoofd tekst van aanvraag waarden in voor naam (bijvoorbeeld myList) en Beschrijving.
Gebruik tijdelijke aanduidingen voor sleutel waarden paar om beschrijvende meta gegevens aan uw lijst toe te wijzen.
```
{
    "Name": "MyExclusionList",
    "Description": "MyListDescription",
    "Metadata": 
    {
        "Category": "Competitors",
        "Type": "Exclude"
    }
}
```
Voeg Meta gegevens van lijsten toe als sleutel-waardeparen en niet de werkelijke voor waarden.
Selecteer Verzenden. De lijst wordt gemaakt. Noteer de id- waarde die is gekoppeld aan de nieuwe lijst. U hebt deze ID nodig voor andere beheer functies voor termen lijsten.
Termen toevoegen aan MyList. Selecteer in het linkermenu onder term de optie term toevoegen.

De pagina term -toevoegen wordt geopend.
Voor open API-test console selecteert u de regio die uw locatie het meest beschrijft.

De term-API- console voor toevoegen wordt geopend.
Voer in het vak listId de lijst-ID in die u hebt gegenereerd en selecteer een waarde voor de taal. Voer uw abonnements sleutel in en selecteer vervolgens verzenden.
Als u wilt controleren of de term is toegevoegd aan de lijst, selecteert u in het linkermenu term en selecteert u alle voor waarden ophalen.

De term-API-console alle termen ophalen wordt geopend.
Voer in het vak listId de lijst-ID in en voer vervolgens uw abonnements sleutel in. Selecteer Verzenden.
Controleer in het vak reactie inhoud de voor waarden die u hebt ingevoerd.
Voeg nog een aantal voor waarden toe. Nu u een aangepaste lijst met voor waarden hebt gemaakt, kunt u tekst scannen met behulp van de lijst met aangepaste termen.

Termen en lijsten verwijderen

U kunt eenvoudig term of lijsten verwijderen. U gebruikt de API om de volgende taken uit te voeren:

Een term verwijderen. (Term-verwijderen)
Alle termen in een lijst verwijderen zonder de lijst te verwijderen. (Term-alle voor waarden verwijderen)
Een lijst en alle inhoud verwijderen. (Termen lijsten-verwijderen)

In dit voor beeld wordt één term verwijderd.

Selecteer in de termen lijst beheer-API-verwijzingin het linkermenu term en selecteer vervolgens verwijderen.

De term-verwijderen wordt geopend.
Voor open API-test console selecteert u de regio die uw locatie het meest beschrijft.

De term-delete API- console wordt geopend.
Voer in het vak listId de id in van de lijst waaruit u een term wilt verwijderen. Deze ID is het aantal (in het voor beeld 122) dat wordt geretourneerd in de lijst met termen-Details van de console ophalen voor myList. Voer de term in en selecteer een taal.
Voer uw abonnements sleutel in en selecteer vervolgens verzenden.
Als u wilt controleren of de term is verwijderd, gebruikt u de lijst met termen-alle console ophalen .

Lijst gegevens wijzigen

U kunt de naam en beschrijving van een lijst bewerken en meta gegevens items toevoegen.

Selecteer in de termen lijst beheer API-verwijzingin het menu links de optie termen lijsten en selecteer vervolgens Details bijwerken.

De lijst met termen-pagina Details bijwerken wordt geopend.
Voor open API-test console selecteert u de regio die uw locatie het meest beschrijft.

De lijst met termen-update Details API-console wordt geopend.
Voer in het vak listId de lijst-ID in en voer vervolgens uw abonnements sleutel in.
Breng in het vak hoofd tekst van aanvraag de gewenste wijzigingen aan en selecteer vervolgens verzenden.

Volgende stappen

Gebruik de REST API in uw code of begin met de term lijsten .net Quick start om te integreren met uw toepassing.