Cloud Vision einrichten und bereinigen

Diese Anleitung enthält alle erforderlichen Einrichtungsschritte für Cloud Vision. Außerdem finden Sie hier auch Schritte zur Bereinigung, nachdem Sie Cloud Vision ausprobiert oder getestet haben.

Google Cloud Console

Die Google Cloud Console (Dokumentation aufrufen, Console öffnen) ist eine Web-UI zur Bereitstellung, Konfiguration, Verwaltung und Überwachung von Systemen, in denen Google Cloud -Produkte genutzt werden. Sie verwenden die Google Cloud Console, um Vision-Ressourcen einzurichten und zu verwalten.

Projekt erstellen

Wenn Sie Dienste von Google Cloudnutzen möchten, müssen Sie ein Projekt erstellen. In Projekten können Sie alle Ihre Google Cloud -Ressourcen organisieren. Ein Projekt umfasst Mitbearbeiter, aktivierte APIs (und andere Ressourcen), Monitoring-Tools, Zahlungsinformationen sowie Authentifizierungs- und Zugriffssteuerungen. Sie können wahlweise ein Projekt erstellen oder Ihre Google Cloud -Ressourcen durch Erstellen mehrerer Projekte in einer Ressourcenhierarchie organisieren. Notieren Sie sich beim Erstellen eines Projekts die Projekt-ID. Diese ID benötigen Sie für API-Aufrufe. Weitere Informationen zu Projekten finden Sie in der Dokumentation zu Resource Manager.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Abrechnung aktivieren

In Rechnungskonten ist festgelegt, wer die Nutzungsgebühren für Ressourcen bezahlt. Ein Rechnungskonto 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.

Verify that billing is enabled for your Google Cloud project.

API aktivieren

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

Enable the Vision API.

Enable the API

Installieren und initialisieren Sie die Google Cloud CLI.

Wenn Sie die Vision API verwenden möchten, müssen Sie die Google Cloud CLI installieren und initialisieren. Die gcloud CLI umfasst mehrere Tools, mit denen Sie auf Google Cloudgehostete Ressourcen und Anwendungen verwalten können.

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 und Zugriffssteuerung einrichten

Wenn Sie die Vision API verwenden möchten, müssen Sie die Authentifizierung einrichten. Jede Clientanwendung, die die API verwendet, muss authentifiziert sein und Zugriff auf die angeforderten Ressourcen haben. In diesem Abschnitt werden wichtige Konzepte der Authentifizierung erklärt und Schritte für die Einrichtung beschrieben. Weitere Informationen finden Sie in der Google Cloud -Authentifizierungsübersicht.

Mit Nutzerkonten authentifizieren

Nutzerkonten sind die beste Authentifizierungsoptionen für die Vision API oder die lokale Entwicklung. Sie können Ihr Nutzerkonto verwenden, um sich entweder bei REST-Befehlszeilenausführungen oder bei Aufrufen über die Clientbibliothek zu authentifizieren.

Authentifizierung von Nutzerkonten über die REST-Befehlszeile

Zur Authentifizierung für REST-Befehlszeilenaufrufe verwenden Sie die gcloud CLI. Mit dem Befehl gcloud auth login werden Sie mit Ihrem Nutzerkonto in gcloud angemeldet. Dies sollte vor dem Aufrufen der API erfolgen. Der Befehl gcloud auth print-access-token wird in dieser Dokumentation in den Beispielen zur REST-Befehlszeile verwendet, um REST-Aufrufe zu authentifizieren.

So erstellen Sie Nutzeranmeldedaten für Ihre lokale Umgebung: 

gcloud auth login

Authentifizierung des Nutzerkontos in der Clientbibliothek

Zur Authentifizierung bei Aufrufen der Clientbibliothek verwenden Sie die gcloud CLI. Mit dem Befehl gcloud auth application-default login melden Sie sich mit Ihrem Benutzerkonto bei gcloud an, um die Standardanmeldedaten für Anwendungen einzurichten. Dies sollten Sie tun, bevor Sie die API aufrufen. Mit dem Befehl gcloud auth application-default set-quota-project können Sie Ihr Projekt für die Abrechnung und die Kontingente im Zusammenhang mit API-Aufrufen festlegen. Normalerweise ist dies dasselbe Projekt, das von Ihrem Agenten verwendet wird. Sie geben die Projekt-ID des Projekts an, das Sie in den Schritten oben erstellt haben.

Die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS darf nicht festgelegt werden, damit die Standardanmeldedaten für Anwendungen von Clientbibliotheken verwendet werden können.

So erstellen Sie Standardanmeldedaten für Anwendungen für Ihre lokale Umgebung: 

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Authentifizierung bei Dienstkonten

Dienstkonten stellen Anmeldedaten für Anwendungen bereit, nicht für Endnutzer. Dienstkonten gehören zu Projekten. Sie können mehrere Dienstkonten für ein Projekt erstellen. Weitere Informationen finden Sie unter:

Zugriffssteuerung mit Rollen

Wenn ein Hauptkonto (Nutzerkonto, Dienstkonto usw.) eine API aufruft, erfordert Google Cloud , dass das Hauptkonto die entsprechenden Berechtigungen hat. Sie können Berechtigungen gewähren, indem Sie einem Hauptkonto Rollen zuweisen. Weitere Informationen finden Sie in der Rollenübersicht.

Wenn Sie Ihr Projekt mit Ihrem Nutzerkonto erstellt haben, hat Ihr Nutzerkonto die einfache Rolle „Inhaber“ für das Projekt. Diese Rolle ermöglicht das Aufrufen einer beliebigen API für das Projekt. Wenn das Projekt jedoch von einem anderen Konto erstellt wurde, müssen Ihrem Nutzerkonto möglicherweise Rollen zugewiesen werden, bevor Sie die API aufrufen können.

Vision API-Clientbibliothek installieren

Zum Aufrufen der Vision 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 Vision API-Clientbibliotheken.

Bereinigen

Nach der Einrichtung und dem Testen von Vision können Sie die von Ihnen erstellten Ressourcen löschen:

  • Sie können Ihr Projekt herunterfahren.
  • Wenn Sie gcloud auth login aufgerufen haben, werden die Anmeldedaten in Ihrem Nutzerverzeichnis auf dem Computer gespeichert. Sie können diese Anmeldedaten mit dem folgenden Befehl löschen: 
    gcloud auth revoke
  • Wenn Sie gcloud auth application-default login aufgerufen haben, werden die Anmeldedaten in Ihrem Nutzerverzeichnis auf dem Computer gespeichert. Sie können diese Anmeldedaten mit dem folgenden Befehl löschen: 
    gcloud auth application-default revoke