Moderieren von Bildern mit benutzerdefinierten Bildlisten in der API-Konsole

Verwenden Sie die Listenverwaltungs-API in Azure Content Moderator zum Erstellen von benutzerdefinierter Bildlisten. Verwenden Sie die benutzerdefinierten Bildlisten mit der Bildmoderations-API. Beim Vorgang der Bildmoderation wird Ihr Bild ausgewertet. Wenn Sie benutzerdefinierte Listen erstellen, vergleicht der Vorgang diese zudem mit den Bildern in Ihren benutzerdefinierten Listen. Mithilfe von benutzerdefinierten Listen können Sie das Bild blockieren oder zulassen.

Hinweis

Die Obergrenze liegt bei fünf Bildlisten, wobei jede Liste max. 10.000 Bilder enthalten kann.

Mit der Listenverwaltungs-API können Sie folgende Aufgaben durchführen:

  • Erstellt eine Liste.
  • Hinzufügen von Bildern zu einer Liste
  • Abgleichen von Bildern mit Bildern in einer Liste
  • Löschen von Bildern aus einer Liste
  • Löschen einer Liste
  • Bearbeiten von Listeninformationen
  • Aktualisieren des Index, damit Änderungen an der Liste in einer neuen Überprüfung berücksichtigt werden

Verwenden der API-Konsole

Bevor Sie die API in der Onlinekonsole testen können, benötigen Sie Ihren Abonnementschlüssel. Dieser befindet sich auf der Registerkarte Einstellungen im Feld Ocp-Apim-Subscription-Key. Weitere Informationen finden Sie in der Übersicht.

Aktualisieren des Suchindex

Nachdem Sie eine Bildliste geändert haben, müssen Sie den zugehörigen Index aktualisieren, damit er bei zukünftigen Überprüfungen berücksichtigt wird. Dieser Schritt entspricht der Vorgehensweise einer Suchmaschine auf Ihrem Desktop (sofern aktiviert) oder einer Internetsuchmaschine, die kontinuierlich ihren Index zur Einbeziehung neuer Dateien oder Seiten aktualisiert.

  1. Wählen Sie in der API-Referenz zur Verwaltung von Bildlisten im linken Menü Bildlisten und dann Suchindex aktualisieren aus.

    Die Seite Bildlisten – Suchindex aktualisieren wird geöffnet.

  2. Wählen Sie für API-Testkonsole öffnen die Region aus, die Ihrem Standort am ehesten nahekommt.

    Image Lists - Refresh Search Index page region selection

    Die API-Konsole Bildlisten – Suchindex aktualisieren wird geöffnet.

  3. Geben Sie im Feld listId die Listen-ID ein. Geben Sie Ihren Abonnementschlüssel ein, und wählen Sie dann Senden aus.

    Image Lists - Refresh Search Index console Response content box

Erstellen einer Bildliste

  1. Navigieren Sie zur API-Referenz zur Verwaltung von Bildlisten.

    Die Seite Bildlisten – Erstellen wird geöffnet.

  2. Wählen Sie für API-Testkonsole öffnen die Region aus, die Ihrem Standort am ehesten nahekommt.

    Image Lists - Create page region selection

    Die API-Konsole Bildlisten – Erstellen wird geöffnet.

  3. Geben Sie in das Feld Ocp-Apim-Subscription-Key Ihren Abonnementschlüssel ein.

  4. Geben Sie in das Feld Anforderungstext Werte für Name (z.B. MyList) und Description ein.

    Image Lists - Create console Request body name and description

  5. Verwenden Sie Platzhalter für Schlüssel-Wert-Paare, um Ihrer Liste aussagekräftigere Metadaten zuzuweisen.

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

    Fügen Sie Metadaten als Schlüssel-Wert-Paare und nicht als tatsächliche Bilder hinzu.

  6. Wählen Sie Send (Senden) aus. Ihre Liste wird erstellt. Beachten Sie den ID-Wert, der der neuen Liste zugeordnet ist. Sie benötigen diese ID für andere Funktionen zur Verwaltung von Bildlisten.

    Image Lists - Create console Response content box shows the list ID

  7. Fügen Sie als Nächstes Bilder zu MyList hinzu. Wählen Sie im Menü auf der linken Seite Bild und dann Bild hinzufügen aus.

    Die Seite Bild – Bild hinzufügen wird geöffnet.

  8. Wählen Sie für API-Testkonsole öffnen die Region aus, die Ihrem Standort am ehesten nahekommt.

    Image - Add Image page region selection

    Die API-Konsole Bild – Bild hinzufügen wird geöffnet.

  9. Geben Sie in das Feld listId die ID der von Ihnen generierten Liste und dann die URL des Bilds ein, die hinzugefügt werden soll. Geben Sie Ihren Abonnementschlüssel ein, und wählen Sie dann Senden aus.

  10. Um sicherzustellen, dass das Bild der Liste hinzugefügt wurde, wählen Sie im Menü auf der linken Seite Bild und dann Alle Bild-IDs abrufen aus.

    Die API-Konsole Bild – Alle Bild-IDs abrufen wird geöffnet.

  11. Geben Sie in das Feld listId die Listen-ID und dann Ihren Abonnementschlüssel ein. Wählen Sie Send (Senden) aus.

    Image - Get All Image Ids console Response content box lists the images that you entered

  12. Fügen Sie noch ein paar Bilder hinzu. Nachdem Sie nun eine benutzerdefinierte Liste von Bildern erstellt haben, können Sie Bilder mithilfe der Liste der benutzerdefinierten Bilder auswerten.

Löschen von Bildern und Listen

Das Löschen eines Bilds oder einer Liste ist einfach. Mit der API können Sie folgende Aufgaben durchführen:

  • Löschen eines Images. (Bild – Löschen)
  • Löschen aller Bilder in einer Liste, jedoch nicht der Liste selbst (Bild – Alle Bilder löschen)
  • Löschen einer Liste und aller zugehörigen Inhalte (Bildlisten – Löschen)

Dieses Beispiel löscht ein einzelnes Bild:

  1. Wählen Sie in der API-Referenz zur Verwaltung von Bildlisten im linken Menü Bild und dann Löschen aus.

    Die Seite Bild – Löschen wird geöffnet.

  2. Wählen Sie für API-Testkonsole öffnen die Region aus, die Ihrem Standort am ehesten nahekommt.

    Image - Delete page region selection

    Die API-Konsole Bild – Löschen wird geöffnet.

  3. Geben Sie in das Feld listId die ID der Liste ein, aus der ein Bild gelöscht werden soll. Dies ist die Nummer, die in der Konsole Bild – Alle Bild-IDs abrufen für MyList-zurückgegeben wird. Geben Sie dann die ImageId des zu löschenden Bilds ein.

In unserem Beispiel ist die Listen-ID 58953. Dies ist der Wert für ContentSource. Die Bild-ID ist 59021. Dies ist der Wert für ContentIds.

  1. Geben Sie Ihren Abonnementschlüssel ein, und wählen Sie dann Senden aus.

  2. Um sicherzustellen, dass das Bild gelöscht wurde, verwenden Sie die Konsole Bild – Alle Bild-IDs abrufen.

Ändern von Listeninformationen

Sie können Name und Beschreibung einer Liste bearbeiten und Metadatenelemente hinzufügen.

  1. Wählen Sie in der API-Referenz zur Verwaltung von Bildlisten im linken Menü Bildlisten und dann Details aktualisieren aus.

    Die Seite Bildlisten – Details aktualisieren wird geöffnet.

  2. Wählen Sie für API-Testkonsole öffnen die Region aus, die Ihrem Standort am ehesten nahekommt.

    Image Lists - Update Details page region selection

    Die API-Konsole Bildlisten – Details aktualisieren wird geöffnet.

  3. Geben Sie in das Feld listId die Listen-ID und dann Ihren Abonnementschlüssel ein.

  4. Nehmen Sie im Feld Anforderungstext die jeweiligen Änderungen vor, und klicken Sie auf der Seite dann auf die Schaltfläche Senden.

    Image Lists - Update Details console Request body edits

Nächste Schritte

Verwenden Sie die REST-API in Ihrem Code, oder beginnen Sie mit dem .NET-Schnellstart zu Bildlisten, die in Ihre Anwendung integriert werden sollen.