Erste Schritte mit der Perspective API

Erste Schritte mit der Perspective API

Informationen zu diesem Codelab

Zuletzt aktualisiert: März 10, 2022

Verfasst von Jigsaw

1. Hinweis

Die Perspective API ist eine kostenlose API, mit der Sie bessere Unterhaltungen online führen können. Die API verwendet Machine Learning (ML), um einen String zu analysieren und die wahrgenommenen Auswirkungen auf eine Unterhaltung vorherzusagen.

In diesem Codelab richten Sie Perspective API ein.

Hinweis:Die Perspective API soll die Moderation von Inhalten vereinfachen. Sie ersetzt nicht die Arbeit menschlicher Entscheidungsträger.

Lerninhalte

• KI-gestützte Moderation: Inhalte werden sofort nach ihrer Erstellung gemeldet.

Voraussetzungen

• Ein Google-Konto für den Zugriff auf Google Cloud
• Gute Internetgeschwindigkeit

2. Erste Schritte

Als Erstes brauchen Sie ein Google Cloud-Projekt, um Ihre API-Anfragen zu authentifizieren.

1. Verwenden Sie in der Google Cloud Console ein vorhandenes Projekt.
2. So erstellen Sie ein neues Projekt:

• Melden Sie sich mit Ihrem Google-Konto an.
• Öffnen Sie die Cloud Console.
• Klicken Sie auf Projekt erstellen oder öffnen Sie das Menü Projekt auswählen und klicken Sie dann im Dialogfeld auf Neues Projekt.
• Geben Sie einen Namen für Ihr Projekt ein und klicken Sie auf Erstellen.

Das Projekt wird jetzt im Drop-down-Menü angezeigt.

API-Zugriff anfordern

• Wenn Sie den API-Zugriff anfordern möchten, füllen Sie dieses Formular aus.

Sie sollten innerhalb einer Stunde eine E-Mail erhalten, in der bestätigt wird, dass Sie die API in Google Cloud aufrufen und aktivieren können.

Hinweis:Wenn Sie innerhalb eines Werktags keine E-Mail erhalten, füllen Sie das Formular bitte noch einmal aus oder wenden Sie sich an das Supportteam.

3. API aktivieren

• Rufen Sie in der Cloud Console die Seite Perspective API-Übersicht auf und klicken Sie auf Aktivieren.

4. API-Schlüssel generieren

1. Klicken Sie im Navigationsmenü auf APIs & Services > Anmeldedaten > Anmeldedaten erstellen &API; API-Schlüssel.

Hinweis: Wenn Sie Anfragen von einer clientseitigen Sprache wie JavaScript senden, wird Ihr API-Schlüssel allen Besuchern angezeigt. Es wird dringend empfohlen, die Anfrage über einen Server zu weiterleiten und Schlüsseleinschränkungen anzuwenden, damit der Schlüssel in Browsern ausgeblendet wird und nur Ihr Server ihn verwenden kann. Weitere Informationen finden Sie unter Beispiel für die Proxyfunktion über einen Server und Sicherheitstipps für API-Schlüssel.

Ihr API-Schlüssel sollte in wenigen Minuten funktionieren, es kann jedoch auch bis zu eine Stunde dauern. Bis dahin wird eine Fehlermeldung angezeigt.

2. Kopieren Sie den API-Schlüssel.

5. Beispielanfragen

Sie können API-Clientbibliotheken mit den Google API-Clientbibliotheken generieren. Diese Beispiele zeigen, wie du deine API-Bibliothek mit einigen der gängigsten Sprachen einrichtest.

1. Führen Sie eine AnalyzeComment-Anfrage aus.
2. Führen Sie einen dieser Beispiel-API-Aufrufe aus, um Ergebnisse direkt von der Perspective API abzurufen.

Die Methode AnalyzeComment gibt eine API-Anfrage zur Analyse des Felds comment.text für requestedAttributes aus, in diesem Fall das Modell TOXICITY.

3. Füge deinen API-Schlüssel in das Feld API_KEY ein.

Sie können das Flag doNotStore auch verwenden, damit alle eingereichten Kommentare nach der Bewertung automatisch gelöscht werden.

4. Details zu allen Anfrage- und Antwortfeldern sowie den verfügbaren Werten für requestedAttributes finden Sie in der API-Referenzdokumentation.

Es gibt experimentelle Attribute, z. B. OBSCENE, ATTACK_ON_COMMENTSER und SPAM.

Python

In dieser Beispielanfrage und -antwort wird die Python-Version der Google API-Clientbibliotheken verwendet.

1. Installieren Sie die Python-Clientbibliothek.
2. Führen Sie folgende Befehle aus:

Die Ausgabe sollte ungefähr so aussehen:

Deine freundliche Begrüßung hat einen niedrigen Toxizitätswert erzielt.

Node.js

In dieser Beispielanfrage und -antwort wird die Node.js-Version der Google API-Clientbibliotheken verwendet.

1. Installieren Sie die Node.js-Clientbibliothek oder das npm-Paket googleapis.
2. Führen Sie folgende Befehle aus:

Die Ausgabe sollte ungefähr so aussehen:

cURL

In dieser Beispielanfrage und -antwort wird der Befehl cURL verwendet. Dieser Befehl sollte für die meisten macOS- und Linux-Nutzer funktionieren. Möglicherweise müssen Sie cURL installieren, um diesen Befehl auszuführen.

• Ersetzen Sie hierbei YOUR_KEY_HERE durch Ihren eigenen API-Schlüssel.

In dieser Antwort gibt das Feld attributeScores.TOXICITY.summaryScore.value die Toxizitätsstufe des Kommentars an. Der Kommentar wurde mit 0,9 von 1,0 Punkten bewertet.

6. Glückwunsch

Sie haben die Perspective API eingerichtet und ausgeführt.

Weitere Informationen

• Weitere Informationen zur API finden Sie auf der Website der Perspective API, einschließlich Fallstudien.
• Weitere Informationen zu Attributen, Sprachen und Methoden finden Sie auf der Website für die Perspective API-Entwickler. Wenn Sie schnell starten möchten, finden Sie auf der Seite Methoden Informationen zur Verwendung der Methoden AnalyzeComment und SuggestCommentScore.