View a markdown version of this page

Google Drive-Aktionskonnektor - Amazon Quick
Bevor Sie beginnenGoogle Cloud konfigurierenDen Connector in Amazon Quick einrichtenVerfügbare AktionenVerwaltung und Problembehandlung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Google Drive-Aktionskonnektor

Mit dem Google Drive-Action-Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf Google Drive zugreifen. Sie können Dateien hoch- und herunterladen, Ordner verwalten, Inhalte durchsuchen und Änderungen verfolgen, ohne Amazon Quick verlassen zu müssen.

Amazon Quick unterstützt mehrere Authentifizierungsmethoden für den Google Drive-Action-Connector. Wählen Sie die Methode, die den Sicherheitsanforderungen Ihres Unternehmens am besten entspricht.

  • Standard-OAuth-Anwendung — Verwendet eine AWS-verwaltete OAuth-Anwendung. Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Sie authentifizieren sich direkt mit Ihrem Google-Konto.

  • Benutzerdefinierte OAuth-App — Verwendet einen vom Kunden verwalteten OAuth-Client, der in der Google Cloud Console erstellt wurde. Diese Option gibt Ihrer Organisation die volle Kontrolle über die OAuth-Konfiguration.

Weitere Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unterAuthentifizierungsmethoden.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.

  • Ein Google-Konto mit Zugriff auf Google Drive.

  • Für die benutzerdefinierte OAuth-App: Zugriff auf die Google Cloud Console auf der Google-Website mit Berechtigungen zum Erstellen von OAuth-Clients.

  • Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unterIntegrationen in der Konsole einrichten.

Google Cloud konfigurieren

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden, überspringen Sie diesen Abschnitt und lesen Sie weiter. Den Connector in Amazon Quick einrichten

Führen Sie für die benutzerdefinierte OAuth-App-Authentifizierung die folgenden Schritte in der Google Cloud Console aus, bevor Sie Amazon Quick konfigurieren. Wenn Sie die API in Schritt 3 aktivieren, suchen Sie nach der Google Drive-API und aktivieren Sie sie.

Erstellen Sie einen OAuth-Client in der Google Cloud Console

Erstellen Sie einen OAuth-Client in der Google Cloud Console, um die Client-Anmeldeinformationen zu erhalten, die Sie für Amazon Quick benötigen. Weitere Informationen finden Sie unter Verwenden von OAuth 2.0 für den Zugriff auf Google-APIs auf der Google-Website.

  1. Melden Sie sich auf der Google-Website bei der Google Cloud Console an.

  2. Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes Projekt aus.

  3. Wählen Sie im linken Navigationsbereich APIs & Services und dann Library aus. Suchen Sie nach der API, die für Ihre Integration erforderlich ist, und wählen Sie Aktivieren aus.

  4. Wählen Sie den OAuth-Zustimmungsbildschirm und wählen Sie Get Started.

  5. Konfigurieren Sie den Zustimmungsbildschirm:

    • Geben Sie einen App-Namen ein und wählen Sie eine E-Mail-Adresse für den Benutzersupport aus.

    • Wählen Sie für Zielgruppe die Option Intern (nur Ihre Organisation) oder Extern (jeder Google-Nutzer) aus.

    • Fügen Sie die Kontaktdaten des Entwicklers hinzu und wählen Sie Erstellen aus.

  6. Wählen Sie „OAuth-Client erstellen“.

  7. Konfigurieren Sie den Client:

    • Wählen Sie als Anwendungstyp die Option Webanwendung aus.

    • Geben Sie einen Namen für Ihren Client ein.

    • Fügen Sie unter Autorisierte Weiterleitungs-URIs die Amazon Quick Callback-URL hinzu: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  8. Wählen Sie Erstellen aus.

  9. Notieren Sie sich die folgenden Werte. Sie benötigen sie, wenn Sie Amazon Quick konfigurieren.

    • Kunden-ID

    • Clientschlüssel

Empfohlene Bereiche

Die folgenden Bereiche werden abgefragt, wenn Sie eine Verbindung zu Google Drive herstellen.

Von Google Drive empfohlene Bereiche
Scope Description
https://www.googleapis.com/auth/drive Liest und schreibt Dateien in Google Drive.
https://www.googleapis.com/auth/drive.readonly Liest Dateien in Google Drive.
https://www.googleapis.com/auth/drive.metadata.readonly Liest Dateimetadaten in Google Drive.
openid Authentifiziert die Identität des Benutzers.
email Liest die E-Mail-Adresse des Benutzers.
Anmerkung

Die email Bereiche openid und werden automatisch in den OAuth-Zustimmungsablauf für die Benutzerauthentifizierung aufgenommen. Sie sind für OAuth nicht erforderlich. Service-to-Service

Den Connector in Amazon Quick einrichten

Über die Registerkarte „Verfügbar“ eine Connect

Wenn Sie die standardmäßige OAuth-App-Authentifizierung verwenden möchten, können Sie ohne zusätzliche Konfiguration direkt über die Registerkarte Verfügbar eine Verbindung herstellen.

  1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

  2. Suchen Sie auf der Registerkarte Verfügbar nach Google Drive und wählen Sie Connect aus.

  3. Schließen Sie den Google-Anmeldevorgang ab und erteilen Sie die angeforderten Berechtigungen.

Um stattdessen einen Connector mit der benutzerdefinierten OAuth-App zu konfigurieren, verwenden Sie den Tab „Für Ihr Team erstellen“ wie unten beschrieben.

Erstellen Sie auf der Registerkarte „Für Ihr Team erstellen“

Nachdem Sie alle erforderlichen Google Cloud-Konfigurationen abgeschlossen haben, erstellen Sie den Connector in Amazon Quick.

  1. Wählen Sie in der Amazon Quick-Konsole Connectors aus.

  2. Wählen Sie den Tab „Für Ihr Team erstellen“.

  3. Suchen Sie nach Google Drive und wählen Sie es aus.

    Anmerkung

    Wenn bereits ein Google Drive-Connector vorhanden ist, wird ein Dialogfeld mit Ihren vorhandenen Connectoren angezeigt. Um einen vorhandenen Connector zu verwenden, wählen Sie ihn aus. Um einen neuen zu erstellen, wählen Sie Nein, neu erstellen.

  4. Geben Sie einen Namen für Ihren Connector ein. Wählen Sie optional + Beschreibung hinzufügen, um eine Beschreibung hinzuzufügen.

  5. Wählen Sie als Verbindungstyp die Option Öffentliches Netzwerk aus.

  6. Wählen Sie für die OAuth-Konfiguration eine der folgenden Authentifizierungsmethoden und konfigurieren Sie die erforderlichen Felder.

    1. Für die Standard-OAuth-App:

      Es sind keine zusätzlichen Anmeldeinformationen erforderlich. Wählen Sie Next (Weiter), um fortzufahren.

    2. Konfigurieren Sie für die benutzerdefinierte OAuth-App die folgenden Felder:

      • Basis-URL (optional) — Die Google Drive-API-Basis-URL. Beispiel: https://www.googleapis.com/drive

      • Client-ID — Die Client-ID Ihres Google Cloud OAuth-Clients.

      • Geheimer Client-Schlüssel — Der geheime Client-Schlüssel Ihres Google Cloud OAuth-Clients.

      • Token-URL — Der Token-Endpunkt. Beispiel: https://oauth2.googleapis.com/token

      • Autorisierungs-URL — Der Autorisierungsendpunkt. Beispiel: https://accounts.google.com/o/oauth2/v2/auth

      • Weiterleitungs-URL — Pre-filled mit der Amazon Quick Callback-URL.

  7. Wählen Sie Weiter aus.

  8. Wenn Sie die Standard-OAuth-App oder die benutzerdefinierte OAuth-App ausgewählt haben, wird ein Google-Autorisierungsfenster geöffnet. Überprüfen Sie die angeforderten Berechtigungen und wählen Sie Zulassen.

  9. Überprüfen Sie auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie Weiter aus.

  10. Wählen Sie auf der Seite „Veröffentlichen“ aus, wer auf den Connector zugreifen kann. Sie können den Zugriff für alle in Ihrer Organisation aktivieren oder nach bestimmten Teams oder Gruppen suchen.

  11. Wählen Sie Publish.

Verfügbare Aktionen

Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.

Verfügbare Aktionen in Google Drive
Kategorie Action Description
Dateien Datei abrufen Lädt eine Datei von Google Drive herunter.
Dateien Suchen Sie nach Dateien Sucht nach Dateien nach Namen oder Inhalt.
Dateien Datei-Metadaten abrufen Ruft Metadaten für eine Datei ab.
Dateien Datei importieren Lädt eine Datei auf Google Drive hoch.
Dateien Datei von der URL hochladen Lädt eine Datei von einer URL hoch.
Dateien Datei erstellen Erzeugt eine neue Datei.
Dateien Datei aus Text erstellen Erzeugt eine Datei aus Textinhalt.
Dateien Datei einfügen Ersetzt den Inhalt einer vorhandenen Datei.
Dateien Dateiinhalt aktualisieren Bearbeitet den Inhalt einer vorhandenen Datei.
Dateien Dateispeicherort aktualisieren Verschiebt eine Datei in einen anderen Ordner.
Dateien Datei kopieren Erstellt eine Kopie einer Datei.
Dateien Datei exportieren Exportiert eine Google Workspace-Datei in ein anderes Format.
Dateien Datei löschen Verschiebt eine Datei in den Papierkorb.
Ordner Ordner erstellen Erstellt einen neuen Ordner.
Ordner Ordner durchsuchen Sucht nach Ordnern anhand des Namens.
Berechtigungen Berechtigungen auflisten Listet die Berechtigungen für eine Datei oder einen Ordner auf.
Kommentare Kommentare auflisten Listet Kommentare zu einer Datei auf.
Änderungen Änderungen auflisten Listet die letzten Änderungen an Dateien auf.
Änderungen Startseiten-Token abrufen Ruft ein Startseiten-Token zur Nachverfolgung von Änderungen ab.
Fahren Drive-Informationen abrufen Ruft Informationen über das Laufwerk des Benutzers ab.
Anmerkung

Die Aktionen, die Sie verwenden können, hängen von den Dateien und Ordnern ab, auf die der authentifizierte Benutzer zugreifen kann.

Verwaltung und Problembehandlung

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.

Häufige Probleme mit der Google-Authentifizierung

  • Sign-in schlägt fehl (Standard-OAuth-App oder benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass Ihr Google-Konto aktiv ist und Sie sich direkt auf der Google-Website anmelden können. Stellen Sie für die benutzerdefinierte OAuth-App sicher, dass die Weiterleitungs-URI in Ihrem Google Cloud OAuth-Client mit der Amazon Quick Callback-URL übereinstimmt.

  • App vom Administrator blockiert — Wenn Ihr Google Workspace-Administrator den Zugriff auf Drittanbieter-Apps einschränkt, wird möglicherweise ein Fehler angezeigt, wenn Sie versuchen, sich anzumelden. Wenden Sie sich an Ihren Google Workspace-Administrator, um die Amazon Quick-App zuzulassen.

  • Ungültige Kundenanmeldedaten (benutzerdefinierte OAuth-App) — Stellen Sie sicher, dass die Client-ID und der geheime Client-Schlüssel mit den Werten in Ihrem Google Cloud OAuth-Client übereinstimmen.

  • Authentifizierungs-Popup schlägt fehl — Stellen Sie sicher, dass Ihr Browser Popups von der Amazon Quick Console-Domain zulässt. Versuchen Sie, einen anderen Browser zu verwenden oder Ihren Browser-Cache zu leeren.

  • Berechtigungen widerrufen — Wenn Sie Amazon Quick Access zuvor in den Berechtigungseinstellungen Ihres Google-Kontos gesperrt haben, müssen Sie sich erneut authentifizieren, indem Sie den Connector bearbeiten und sich erneut anmelden.

  • Google API-Ratenbegrenzung — Google kann Anfragen in Zeiten hoher Nutzung einschränken. Wenn Aktionen fehlschlagen, versuchen Sie es nach einigen Minuten erneut.

Probleme mit Google Drive-specific

  • Google Drive-API nicht aktiviert — Vergewissern Sie sich, dass die Google Drive-API in Ihrem Google Cloud-Projekt unter APIs und Dienste, Bibliothek aktiviert ist.