Kurzanleitung: Die Natural Language API einrichten

Dieser Leitfaden enthält alle erforderlichen Einrichtungsschritte für die Verwendung von Natural Language.

Über die Google Cloud Console

Die Google Cloud Console, ist eine Web-UI zur Bereitstellung, Konfiguration, Verwaltung, und Überwachung von Systemen, die Google Cloud Produkte verwenden. Sie dient dazu, die Google Cloud Konsole zum Einrichten und Verwalten von Natural Language-Ressourcen zu verwenden.

Projekt erstellen

Wenn Sie Dienste von Google Cloudnutzen möchten, müssen Sie ein Projekt erstellen.

In Projekten sind alle Ihre Ressourcen von Google Cloud organisiert. Ein Projekt besteht aus den folgenden Komponenten:

  • einer Gruppe von Mitarbeitern
  • aktivierten APIs und anderen Ressourcen
  • Monitoring-Tools
  • Abrechnungsinformationen
  • Authentifizierungs- und Zugriffssteuerungen

Sie können wahlweise ein Projekt erstellen oder Ihre Google Cloud Ressourcen durch Erstellen mehrerer Projekte in einer Ressourcenhierarchie organisieren. Weitere Informationen zu Projekten finden Sie in der Dokumentation zu Resource Manager.

Wählen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Projekt vonaus oder erstellen Sie eines Google Cloud .

Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

  • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können ein beliebiges Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
  • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Projektersteller“ (roles/resourcemanager.projectCreator), die die resourcemanager.projects.create Berechtigung enthält. Rollen zuweisen.

Zur Projektauswahl

Abrechnung aktivieren

In Rechnungskonten ist festgelegt, wer die Nutzungsgebühren für Ressourcen bezahlt. Es kann mit einem oder mehreren Projekten verknüpft sein. Die Gebühren für die Projektnutzung werden dem verknüpften Rechnungskonto belastet. In den meisten Fällen konfigurieren Sie die Abrechnung beim Erstellen eines Projekts. Weitere Informationen finden Sie in der Dokumentation zur Abrechnung.

Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

API aktivieren

Sie müssen die Cloud Natural Language API für Ihr Projekt aktivieren. Weitere Informationen zur Aktivierung von APIs finden Sie in der Dokumentation zu Service Usage.

Aktivieren Sie die Cloud Natural Language API.

Erforderliche Rollen zum Aktivieren von APIs

Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Rollen zuweisen.

API aktivieren

gcloud CLI installieren und initialisieren

Wenn Sie die Natural Language API verwenden möchten, müssen Sie die gcloud CLI installieren und initialisieren. Die gcloud CLI ist eine Reihe von Tools, mit denen Sie auf gehostete Ressourcen und Anwendungen verwalten können Google Cloud. Dazu gehört auch die gcloud CLI. Unter folgendem Link finden Sie eine Anleitung:

Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

gcloud init

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Authentifizierung einrichten

Jede Clientanwendung, die die API verwendet, muss authentifiziert sein und Zugriff auf die angeforderten Ressourcen haben. Wie Sie die Authentifizierung einrichten, hängt davon ab, ob Sie in einer lokalen Entwicklungsumgebung arbeiten oder eine Produktionsumgebung einrichten. Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.

Wählen Sie die Tabs für die Art des Zugriffs auf die API aus:

gcloud

Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

gcloud init

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Clientbibliotheken

Wenn Sie Clientbibliotheken in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten Sie dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzer anmeldedaten ein.

  1. Installieren Sie die Google Cloud CLI.

  2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto: 

    gcloud auth application-default login

    Wenn Sie Cloud Shell verwenden, ist dies nicht erforderlich.

    Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Weitere Informationen finden Sie in der Dokumentation zur-Authentifizierung unter ADC für eine lokale Entwicklungsumgebung einrichten Google Cloud .

REST

Wenn Sie die REST API in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

    Installieren Sie die Google Cloud CLI.

    Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Weitere Informationen finden Sie in der Google Cloud Authentifizierungsdokumentation unter Für die Verwendung von REST authentifizieren.

Informationen zum Einrichten der Authentifizierung für eine Produktionsumgebung finden Sie in der Google Cloud Authentifizierungsdokumentation unter Standardanmeldedaten für Anwendungen für Code einrichten, der auf Google Cloud ausgeführt wird.

Natural Language API-Clientbibliothek installieren

Zum Aufrufen der Natural Language API haben Sie drei Möglichkeiten:

Die Clientbibliotheken sind für verschiedene gängige Sprachen verfügbar. Informationen zum Installieren der Clientbibliotheken finden Sie unter Cloud Natural Language-Clientbibliotheken.

IAM-Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)“ für Ihr Kontingentprojekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie für den Zugriff auf die Cloud Natural Language API benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.