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.
# Gmail-Integration
Mit dem Gmail-Action-Connector können Sie in natürlicher Sprache direkt in Amazon Quick auf Gmail zugreifen. Sie können E-Mails lesen und versenden, Labels und Entwürfe verwalten, Threads organisieren und Kontakte suchen, ohne Amazon Quick verlassen zu müssen.
Amazon Quick unterstützt mehrere Authentifizierungsmethoden für Gmail. 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 unter[Authentifizierungsmethoden](quick-action-auth.md).
## Bevor Sie beginnen
Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie die Integration einrichten.
+ Ein Google-Konto mit Zugriff auf Gmail.
+ Für die **benutzerdefinierte OAuth-App**: Zugriff auf die [Google Cloud Console](https://console.cloud.google.com/) auf der Google-Website mit Berechtigungen zum Erstellen von OAuth-Clients.
+ Informationen zu den Amazon Quick-Abonnementanforderungen finden Sie unter[Integrationen in der Konsole einrichten](integration-console-setup-process.md).
## 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](#gmail-quicksuite-setup)
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 **Gmail-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](https://developers.google.com/identity/protocols/oauth2).
1. Melden Sie sich auf der [Google-Website bei der Google Cloud Console](https://console.cloud.google.com/) an.
1. Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes Projekt aus.
1. 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.
1. Wählen Sie den **OAuth-Zustimmungsbildschirm** und wählen Sie **Get** Started.
1. 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.
1. Wählen Sie „**OAuth-Client erstellen**“.
1. 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`
1. Wählen Sie **Erstellen** aus.
1. Notieren Sie 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 Gmail herstellen.
**Von Gmail empfohlene Bereiche**
| Scope | Description |
| --- | --- |
| https://www.googleapis.com/auth/gmail.modify | Liest, sendet und verwaltet E-Mails und Labels. |
| https://www.googleapis.com/auth/gmail.send | Sendet E-Mails im Namen des Benutzers. |
| https://www.googleapis.com/auth/contacts.readonly | Liest Kontaktinformationen. |
| 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.
1. Suchen Sie auf dem Tab **Verfügbar** nach **Gmail** und wählen Sie **Connect** aus.
1. 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.
1. Wählen Sie den Tab „**Für Ihr Team erstellen**“.
1. Suchen Sie nach **Gmail** und wählen Sie es aus.
**Anmerkung**
Wenn bereits ein Gmail-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**.
1. Geben Sie einen **Namen** für Ihren Connector ein. Wählen Sie optional **\+ Beschreibung hinzufügen**, um eine Beschreibung hinzuzufügen.
1. Wählen Sie als **Verbindungstyp** die Option **Öffentliches Netzwerk** aus.
1. 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.
1. Konfigurieren **Sie für die benutzerdefinierte OAuth-App** die folgenden Felder:
+ **Basis-URL** (optional) — Die Gmail-API-Basis-URL. Beispiel: `https://gmail.googleapis.com`
+ **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.
1. Wählen Sie **Weiter** aus.
1. 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.**
1. **Überprüfen Sie** auf der Seite Überprüfen die verfügbaren Aktionen für den Connector. Wählen Sie **Weiter** aus.
1. 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.
1. Wählen Sie **Publish**.
## Verfügbare Aktionen
Nachdem Sie den Connector eingerichtet haben, sind die folgenden Aktionen verfügbar.
**Verfügbare Aktionen in Gmail**
| Kategorie | Action | Description |
| --- | --- | --- |
| Nachrichten | E-Mails abrufen | Ruft E-Mails aus dem Postfach ab. |
| Nachrichten | Nachricht nach Thread-ID abrufen | Ruft eine Nachricht anhand ihrer Thread-ID ab. |
| Nachrichten | Nachricht anhand der Nachrichten-ID abrufen | Ruft eine Nachricht anhand ihrer Nachrichten-ID ab. |
| Nachrichten | Versenden von E-Mails | Sendet eine neue E-Mail-Nachricht. |
| Nachrichten | Thread-Antwort senden | Antwortet auf einen bestehenden E-Mail-Thread. |
| Nachrichten | Nachricht weiterleiten | Leitet eine E-Mail an andere Empfänger weiter. |
| Nachrichten | Anlage abrufen | Ruft einen E-Mail-Anhang ab. |
| Nachrichten | Batch-Aktualisierungsnachricht | Ändert die Beschriftungen mehrerer Nachrichten in einem einzigen Vorgang. |
| Threads | Threads auflisten | Listet E-Mail-Threads im Postfach auf. |
| Threads | Thread-Bezeichnungen aktualisieren | Ändert Beschriftungen auf einem Thread. |
| Papierkorb | E-Mail löschen | Verschiebt eine E-Mail in den Papierkorb. |
| Papierkorb | Thread löschen | Verschiebt einen Thread in den Papierkorb. |
| Papierkorb | Nachricht wiederherstellen | Stellt eine E-Mail aus dem Papierkorb wieder her. |
| Papierkorb | Thread wiederherstellen | Stellt einen Thread aus dem Papierkorb wieder her. |
| Labels | Beschriftungen auflisten | Listet alle Labels im Postfach auf. |
| Labels | Label abrufen | Ruft Details für ein bestimmtes Etikett ab. |
| Labels | Etikett erstellen | Erzeugt ein neues Label. |
| Labels | Etikett aktualisieren | Aktualisiert die Eigenschaften eines Labels. |
| Labels | E-Mail kennzeichnen | Fügt einer E-Mail ein Label hinzu. |
| Entwürfe | Entwürfe auflisten | Listet E-Mail-Entwürfe auf. |
| Entwürfe | Entwurf abrufen | Ruft einen bestimmten Entwurf ab. |
| Entwürfe | Entwurf erstellen | Erstellt einen neuen E-Mail-Entwurf. |
| Entwürfe | Entwurf aktualisieren | Aktualisiert einen vorhandenen Entwurf. |
| Entwürfe | Entwurf senden | Sendet einen vorhandenen Entwurf. |
| Kontakte | Kontakte suchen | Sucht nach Kontakten nach Namen oder E-Mail. |
| Kontakte | Kontakte abrufen | Ruft Kontaktinformationen ab. |
| Verlauf | Verlauf auflisten | Listet den Verlauf der Postfachänderungen auf. |
| Einstellungen | Profil abrufen | Ruft das Gmail-Profil des authentifizierten Nutzers ab. |
| Einstellungen | Als Alias senden lassen | Ruft eine bestimmte Konfiguration für „Als Alias senden“ ab. |
| Einstellungen | Liste „Als Aliase senden“ | Listet alle Sende-Aliase für das Konto auf. |
**Anmerkung**
Die Aktionen, die Sie verwenden können, hängen von den Daten ab, auf die der authentifizierte Benutzer zugreifen kann.
## Verwaltung und Fehlerbehebung
Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unter[Verwaltung vorhandener Integrationen](integration-workflows.md#managing-existing-integrations).
### 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](https://accounts.google.com) 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.
### Gmail-specific Probleme
+ **Gmail-API nicht aktiviert** — Vergewissern Sie sich, dass die Gmail-API in Ihrem Google Cloud-Projekt unter **APIs und Dienste**, **Bibliothek** aktiviert ist.