Gmail API E-Mail in 5 Zeilen senden
npm unipile-node-sdk installierenUNIPILE_DSN und UNIPILE_TOKEN zu dir .env Datei.client.email.sende()account_id, zu, Themaund Körper. Erledigt.Sendungs-ID Bestätigung der Zustellung über die Gmail API.import { UnipileClient } from 'unipile-node-sdk';const client = neu UnipileClient(
process.env.UNIPILE_DSN,
process.env.UNIPILE_TOKEN);const Ergebnis = await client.email.senden.Konto-ID: 'acc_xxxxxxxxxxxxxxxx',
an: [{
display_name: 'Alice Martin',
kennung: 'alice@acme.com'}],
Betreff: 'Hallo von der Gmail API',
Körper: 'Gesendet über Unipile!
'});Konsole.log(Ergebnis); // { tracking_id: 'msg_...' }
Gmail API E-Mail senden,
Python & Node.js
Code-Beispiele
Ein vollständiger Entwicklerleitfaden zum programmatischen Senden von E-Mails mit der Gmail API: OAuth 2.0-Einrichtung, Codebeispiele, Ratenbegrenzungen und SMTP-Vergleich.
# E-Mail mit der Gmail API senden
import Base64
from email.mime.text import MIMEText
from googleapiclient.discovery import bauen
def E-Mail senden(Dienstleistung, zu, Betreff, Nachricht):
msg = MIMEText(body)
Nachricht['zu'] = zu
Nachricht['Betreff'] = Betreff
roh = base64.urlsafe_b64encode(
msg.as_bytes()
).decode()
return service.users().nachrichten().senden.(
userId=ich,
Körper={'roh': roh}
).ausführen()
Was ist Gmail API E-Mail senden?
Das Versenden von E-Mails über die Gmail API beinhaltet die Verwendung von HTTP-Anfragen zur Interaktion mit den Backend-Systemen von Gmail. Anstatt E-Mails manuell über die Gmail-Oberfläche zu verfassen und zu versenden, können Entwickler diesen Prozess innerhalb ihrer Anwendungen automatisieren.
Die API stellt Endpunkte bereit, die es Entwicklern ermöglichen, E-Mail-Nachrichten in verschiedenen Formaten zu erstellen und zu versenden, darunter Nur-Text, HTML und E-Mails mit Anhängen. Sie unterstützt auch erweiterte Funktionen wie Threading und die Verwaltung von E-Mail-Labels und ist somit eine umfassende Lösung für die programmatische E-Mail-Kommunikation. Für den Versand über mehrere Anbieter (Gmail, Outlook, IMAP) siehe Leitfaden zur Unified Send Email API. Für einen Cross-Provider-Ansatz, erkunden Sie die E-Mail senden API.
Warum Gmail API für das Senden von E-Mails verwenden?
Die Nutzung der Gmail API zum Versenden von E-Mails bietet mehrere Vorteile, die sie zu einer leistungsstarken Wahl für moderne Anwendungen machen.
Automatisierung
Automatisieren Sie routinemäßige E-Mail-Aufgaben, sparen Sie Zeit und reduzieren Sie manuelle Fehler in Ihrem gesamten Workflow.
Integration
Integrieren Sie den E-Mail-Versand nahtlos in den Workflow Ihrer Anwendung und verbessern Sie das Benutzererlebnis durch einen reibungslosen Ablauf.
Personalisierung
Passen Sie E-Mail-Inhalte dynamisch basierend auf Benutzerdaten oder dem Anwendungszustand für wirklich personalisierte Nachrichten an.
Skalierbarkeit
Effiziente Verwaltung von E-Mail-Versand mit hohem Volumen, ideal für Anwendungen, die eine groß angelegte Kommunikation erfordern.
Einrichten der Gmail-API für das Versenden von E-Mails
Google OAuth-DokumentationGoogle schreibt vor, dass Drittanbieteranwendungen ihre Apps zur Überprüfung der Nutzung von Google-Benutzerdaten einreichen müssen. Folgen Sie der 10 Schritte unten um OAuth zu konfigurieren, die Gmail API zu aktivieren und Ihre Anmeldeinformationen für die Produktion vorzubereiten. Siehe auch: Sichere deine E-Mail-API-Integration.
Google Entwicklerkonsole aufrufen
Anmelden bei Google-Entwickler-Konsole Um Ihr Projekt einzurichten, benötigen Sie ein Google-Konto mit Administratorrechten.
Neues Google-Projekt erstellen
Registrieren Sie sich auf der Google-Entwickler-Konsole und entweder ein neues Projekt erstellen oder ein bestehendes Google-Projekt verwenden. Klicken Sie auf NEUES PROJEKT im Projektselektor, um zu beginnen.
OAuth-Client-ID-Zugangsdaten erstellen
Navigieren zu APIs & Services > Anmeldedaten, dann klicken ERSTELLEN VON ANMELDEINFORMATIONEN > OAuth-Client-ID.
- Art der Anwendung: Webanwendung
- Name: Ihr interner Name
- Hinzufügen 2 autorisierte Weiterleitungs-URIs mit Ihrer Unipile DSN (verfügbar in der Unipile Dashboard):
https://{{YOUR_DSN_less_port}}/api/v1/hosted/google_auth_request_callback/port{{YOUR_PORT}}
Sobald erstellt, fügen Sie die Client-ID und Client-Geheimnis zu Unipile Dashboard > Einstellungen > Google OAuth.
Aktivieren Sie die Gmail API-Bibliothek
Geh APIs & Dienste > Bibliothek, suchen nach Gmail-API, und klicken AKTIVIEREN.
OAuth-Zustimmungsbildschirm konfigurieren, Nutzertyp
Wählen Sie Ihren Benutzertyp basierend auf Ihrer Testphase:
- Intern Beschränkt auf Google Workspace-Nutzer in Ihrer Organisation.
- Extern & im Test Erfordert das Hinzufügen von Testbenutzern. Token laufen nach 7 Tagen ab.
Einzelheiten zu Benutzerarten finden Sie unter Google Dokumentation.
App-Informationen eingeben
Auf dem OAuth-Einwilligungsbildschirm gib Folgendes an:
- Anwendungsname: Der Anzeigename Ihrer App.
- Benutzerunterstützungs-E-Mail: Eine Kontakt-E-Mail oder eine Verteilerliste für Benutzerfragen.
- App-Logo Laden Sie Ihr Anwendungslogo zur visuellen Identifikation hoch.
App-Domäneninformationen festlegen
- Anwendungs-Homepage-URL: Eine echte Homepage, nicht nur eine Anmeldeseite.
- Link zur Datenschutzrichtlinie Stellen Sie sicher, dass es erfüllt Googles spezifische Anforderungen, insbesondere der Abschnitt „Eingeschränkte Nutzung“.
- Link zu den Nutzungsbedingungen: Öffentliche Nutzungsbedingungen-URL.
Autorisierte Domains hinzufügen
- Fügen Sie Ihre Produktions-App-Domain hinzu (nicht die Entwicklungs- oder Staging-Domain).
- Hinzufügen unipile.de als eine zweite autorisierte Domain.
Entwicklerkontaktdaten eingeben
Stellen Sie eine E-Mail-Adresse bereit, die Google für Verifizierungsbenachrichtigungen verwenden kann. Verwenden Sie eine Verteilerliste, damit alle relevanten Teammitglieder Updates erhalten. Überwachen Sie diese regelmäßig, da E-Mails von Google im Spam-Ordner landen können.
Erforderliche Bereiche hinzufügen
Klicken GELTENDE BEREICHE HINZUFÜGEN ODER ENTFERNEN und füge Folgendes hinzu (aktualisiere die Seite, falls sie nicht angezeigt werden):
Anmerkung: Gmail ändern ist nur erforderlich, wenn Sie E-Mails verschieben oder löschen müssen. Wenn Sie es nicht verwenden, wenden Sie sich an den Unipile-Support, um es manuell aus Ihrem Konto zu entfernen.
11
Erstellen Sie Ihr Demovideo
Nur einmal erforderlich, wenn Ihre Integration vollständig in der Produktion live ist
Erstelle und hoste ein Demovideo, das Googles Vorgaben erfüllt. Lade es als Nicht gelistetes YouTube-Video, es ist nur ein Videolink zulässig.
- Ihre App und Ihr OAuth-Flow werden, wie in der Google-Dokumentation beschrieben, auf Englisch dargestellt.
- Die Demonstration wird in einer Domäne auf Produktionsebene durchgeführt.
- In den Google Projekt-Einstellungen, bestätigen Veröffentlichungsstatus in Produktion Benutzertyp ist "Extern".
- Zeigen Sie die Homepage Ihrer Anwendung mit der vollständigen URL an.
- Illustrieren Sie, wie ein Google-Kunde sein Konto über die offizielle Google-Anmeldeschaltfläche verbinden kann.
- Hervorheben Sie während des OAuth-Flows die URL und decken Sie die auf Kunden-ID.
- Zeigen Sie sequenziell jeden angeforderten Geltungsbereich an, zugeschnitten auf Ihren spezifischen Anwendungsfall.
- Demonstrieren Sie die bidirektionale Funktionalität, indem Sie die Synchronisierung zwischen Ihrer App und Gmail zeigen (Senden, Empfangen und Aktualisierungen der Gesendet-E-Mail-Liste).
- Fügen Sie das endgültige Video als nicht gelisteten YouTube-Link zu Ihrem Google-Projekt hinzu.
- Reichen Sie die YouTube-URL zur Überprüfung bei Ihrem Customer Success Manager ein.
- Nach der Überprüfung fahren Sie mit der Einreichung der App-Verifizierung fort.
Zeitleiste: Die Verifizierung kann von ... bis zu 2 bis 8 Wochen abhängig von Googles Warteschlange und der Anzahl der Korrekturrunden.
12
Whitelisting & Sicherheitsprüfung für eingeschränkte Bereiche
Gilt nur, wenn Ihre Anwendung eingeschränkte Bereiche verwendet
Wenn Ihre Anwendung eingeschränkte Geltungsbereiche verwendet, sind zusätzliche Schritte erforderlich.
Apps, die Zugriff auf eingeschränkte Google-Nutzerdaten anfordern, müssen eine Sicherheitsprüfung durchlaufen über die CASA (Cloud Application Security Assessment) Programm. Google stuft Ihre App entweder als Stufe 2 oder als Stufe 3 ein.
Apps, die auf eingeschränkte Bereiche zugreifen, müssen eine Sicherheitsbewertung durchlaufen alle 12 Monate um den Zugriff aufrechtzuerhalten. Wenn Sie einen neuen eingeschränkten Geltungsbereich einführen, der zuvor nicht genehmigt wurde, muss Ihre App möglicherweise erneut bewertet werden.
Das Review-Team von Google wird per E-Mail Kontakt aufnehmen. Behalten Sie Ihre Projektleiter und Projektredakteur Informationen in der Cloud Console aktuell halten, damit die richtigen Teammitglieder diese Benachrichtigungen erhalten.
Als Alternative zur standardmäßigen Sicherheitsüberprüfung können Sie Ihre Anwendung auf eine Whitelist setzen lassen. Dies umgeht die üblichen Verfahren, gilt aber nur, wenn Ihre Anwendung sehr spezifische Kriterien erfüllt:
- Die Mehrheit der Kunden nutzt Google Workspace: Die meisten Kunden sollten E-Mails im Format @company.com haben.
- Vom Administrator initiierte Whitelisting: Ihre Endbenutzeradministratoren erlauben den Zugriff über ihre Admin-Konsole mit Ihrer Google Client ID.
- Begrenzte private Nutzung von Gmail: Weniger als 100 private Gmail-Konten (@gmail.com) sollten authentifiziert werden.
- Nicht verifizierte Projekte haben ein lebenslanges Nutzerlimit von 100. Workspace-Konten werden nicht auf dieses Limit angerechnet, persönliche Gmail-Konten jedoch immer.
- Benutzer der kostenlosen Testversion müssen ihre Workspace-E-Mail-Adresse verwenden und die Anwendung auf die Whitelist setzen.
Whitelist ist ein Workaround und ist möglicherweise nicht für alle Anwendungsfälle geeignet. Bewerten Sie die Kriterien sorgfältig, bevor Sie diesen Weg wählen.
Gmail API für CRM, ATS, Outreach & iPaaS
E-Mails automatisieren, Unterhaltungen synchronisieren und die Kundenkommunikation auf jeder Art von B2B-SaaS-Plattform zentralisieren.
E-Mails protokollieren und senden, ohne Ihr CRM zu verlassen
Automatisieren Sie die E-Mail-Kommunikation, verfolgen Sie Interaktionen und verbessern Sie das Kundenengagement. Protokollieren Sie Kunden-E-Mails, versenden Sie personalisierte Nachrichten und zentralisieren Sie alle Konversationen in Ihrer Pipeline.
E-Mails an Kandidaten aus einem einheitlichen Posteingang senden
Optimieren Sie die Kommunikation mit Kandidaten, planen Sie Vorstellungsgespräche und versenden Sie Stellengebote direkt von Ihrer Recruiting-Plattform aus. Jede Antwort wird automatisch dem richtigen Kandidatenprofil zugeordnet.
Mehrstufige E-Mail-Sequenzen im großen Stil ermöglichen
Erstellen Sie Multi-Channel-Sequenzen mit Gmail als zentraler E-Mail-Engine. Senden Sie personalisierte Nachrichten, verfolgen Sie Öffnungen und Antworten und lösen Sie Follow-ups basierend auf dem Verhalten Ihrer potenziellen Kunden aus.
Gmail-Aktionen in jedem Workflow auslösen
In Automatisierungs-Builder Gmail-Sendefunktionen integrieren. Ermöglichen Sie Endbenutzern, ihr Gmail-Konto zu verbinden und E-Mails als Teil von mehrstufigen Workflows auszulösen, ohne den OAuth-Flow von Grund auf neu erstellen zu müssen.
Hauptfunktionen der Gmail API zum Senden von E-Mails
E-Mails abrufen, neue Nachrichten verfassen und senden, Labels verwalten und Echtzeit-Webhook-Benachrichtigungen empfangen. Vier Kernfunktionen, die jeden E-Mail-Workflow in Ihrer Anwendung abdecken.
Alle E-Mails auflisten
E-Mails aus dem Gmail-Konto eines Benutzers abrufen und anzeigen. Filtern nach Ordner, Datum, Absender oder Lesestatus für leistungsstarke Suche und Verwaltung.
E-Mail-Funktion auflistenNeue E-Mail senden
Erstellen und versenden Sie E-Mails programmatisch direkt aus Ihrer App. Unterstützt HTML, Nur-Text, Anhänge, CC, BCC und Antworten auf Konversationen.
Funktion E-Mail sendenBeschriftungen auflisten & abrufen
Gmail-Labels und -Ordner verwalten, indem einzelne Label-Details aufgelistet oder abgerufen werden. E-Mails organisieren und kategorisieren für eine intelligentere Workflow-Weiterleitung.
Etikett auflisten und abrufenWebhook-Tracking
Richten Sie Webhooks ein, um Echtzeit-Updates zu E-Mail-Aktivitäten zu erhalten. Lösen Sie sofortige Aktionen bei neuen Nachrichten, Öffnungen, Antworten oder Bounces aus.
Webhook-BenachrichtigungAlles, was Sie mit der Gmail API tun können
Eine vollständige Übersicht über die Gmail-Endpunkte, die über Unipile verfügbar sind, von der Kontoanbindung bis zur Webhook-Nachverfolgung.
Wie man eine E-Mail mit der Gmail API sendet
Vollständige Python- und Node.js-Beispiele zum Senden von reinem Text, HTML und E-Mails mit Anhängen über die Gmail API. Direkt kopierbar mit OAuth 2.0-Authentifizierung.
1 Eine reine Text-E-Mail senden (Python)
Benutzen Sie die offizielle google-api-python-client und google-auth Bibliotheken. Die Funktion konstruiert eine MIME-Nachricht, kodiert sie in base64url und sendet sie an den Gmail API-Sendendpunkt.
import Base64 from email.mime.text import MIMEText from google.oauth2.anmeldeinformationen import Berechtigungsnachweise from googleapiclient.discovery import bauen def E-Mail senden(to, subject, body, credentials_dict): creds = Berechtigungsnachweise(**credentials_dict) service = bauen('Gmail', 'v1', credentials=creds) Nachricht = MIMEText(body) Nachricht['zu'] = nach Nachricht['Betreff'] = Betreff raw = Base64.urlsafe_b64encode(Nachricht.as_bytes()).dekodieren() ergebnis = service.Benutzer().messages().senden.( userId=ich, körper={'roh': roh} ).ausführen() print(f"Nachricht gesendet. ID: {result['id']}") return Ergebnis # Verwendung E-Mail senden( an='recipient@example.com', Betreff='Hallo von der Gmail API', Körper='Diese E-Mail wurde über die Gmail API gesendet.', credentials_dict={ 'Token': 'IHR_ZUGANGSTOKEN', 'Aktualisierungstoken': 'IHRE_REFRESH_TOKEN', 'client_id': 'IHRE_CLIENT_ID', 'client_secret': 'DEIN_CLIENT_SECRET', 'Token-URI': 'https://oauth2.googleapis.com/token' } )
2 Eine einfache Text-E-Mail senden (Node.js)
Verwenden Sie die googleapis npm-Paket. Die Nachricht wird als roher RFC 2822-String konstruiert, in base64url kodiert und über die Gmail API gesendet.
const { google } = require('googleapis'); async function E_Mail senden(authentifizierung, an, betreff, inhalt) { const gmail = google.gmail({ Version: 'v1', auth }); const Nachricht = [ An: ${to}, Betreff: ${subject}, '', Rumpf ].beitreten('\n'); const verschlüsselteNachricht = Puffer.from(Nachricht) .toString('base64') .ersetzen(/\+/g, '-') .ersetzen(/\/\, '_') .ersetzen(/=+$/, ''); const Ergebnis = await gmail.users.messages.senden.{ userId: ich, requestBody: { raw: encodedMessage } }); console.log(Nachricht gesendet. ID: ${result.data.id}); return result.daten; } // OAuth2-Einrichtung const oauth2Client = new google.auth.OAuth2( 'IHRE_CLIENT_ID', 'DEIN_CLIENT_SECRET', 'IHRE_UMLEITUNGS_URI' ); oauth2Client.Anmeldedaten festlegenaccess_token: 'IHR_ZUGANGSTOKEN', aktualisierungs_token: 'IHRE_REFRESH_TOKEN' }); E_Mail senden(oauth2Client, 'recipient@example.com', 'Hallo', 'Per Gmail API E-Mail senden!');
3 HTML-E-Mail senden (Python)
Verwenden Sie MIMEMultipart('alternative') mit beiden Text/Klartext Fallback und eine text/html Teil. Gmail-Clients rendern die HTML-Version; andere Clients greifen auf Klartext zurück.
from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText import Base64 def HTML-E-Mail senden(service, zu, thema, html_körper): nachricht = MIMEMultipart('alternativ') Nachricht['zu'] = nach Nachricht['Betreff'] = Betreff # Klartext-Fallback text_teil = MIMEText('Bitte zeigen Sie diese E-Mail in einem HTML-kompatiblen Client an.', 'einfach') # HTML-Version html_teil = MIMEText(html_rumpf, 'HTML'Nachricht.anhängenNachricht.anhängenroher = base64.urlsafe_b64encode(Nachricht.as_bytes()).dekodieren() return Service.Benutzer().messages().senden.( userId=ich, körper={'roh': roh} ).ausführen() # Verwendung html_inhalt = """Hallo!
Diese E-Mail wurde gesendet mit Gmail API E-Mail senden.
""" HTML-E-Mail sendenDienstleistung, 'to@example.com', 'HTML-E-Mail über die Gmail API', html_content)
4 E-Mail mit Anhängen senden (Python)
Beliebige Dateitypen anhängen, indem die Dateibytes gelesen, der MIME-Typ erraten und an ein angehängt werden MIMEMultipart Nachricht. Die maximale Anhanggröße beträgt 25 MB pro Nachricht.
import Base64 import MIME-Typen from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText from email.mime.base import MIMEBasis from E-Mail import Encoder def E-Mail mit Anhang senden(service, zu, betreff, inhalt, dateipfad): nachricht = MIMEMultipart() nachricht['zu'] = nach Nachricht['Betreff'] = Betreff Nachricht.anhängen(MIMETextKörper, 'einfach')) # MIME-Typ erkennen und Datei anhängen Inhaltstyp, Kodierung = mimetypes.guess_type(Dateipfad) haupt_typ, unter_typ = inhaltstyp.trennen('/', 1) mit öffnen(Dateipfad, 'RB') als f: anhang = MIMEBasis(Haupttyp, Untertyp) Anhang.Nutzlast_festlegen(f.lesen()()) Encoder.encode_base64Anhang.Kopfzeile hinzufügen( 'Inhaltsausgabe', f'Anhang; Dateiname="{file_path.split("/")[-1]}"' Nachricht.anhängenroh = base64.urlsafe_b64encode(Nachricht.as_bytes()).dekodieren() return Service.Benutzer().messages().senden.( userId=ich, körper={'roh': roh} ).ausführen()
Die E-Mail-API von Unipile ermöglicht es Ihnen, E-Mails von Gmail-, Outlook- und IMAP-Konten mit einem einzigen, vereinheitlichten Endpunkt zu versenden – ohne anbieterspezifische OAuth-Einrichtung. Verknüpfen Sie Konten in Minuten, nicht in Tagen.
Gmail API vs. SMTP, was sollten Sie verwenden?
Sowohl die Gmail API als auch Gmail SMTP ermöglichen es Ihnen, E-Mails programmgesteuert zu versenden, aber sie dienen sehr unterschiedlichen Anwendungsfällen. Hier ist ein direkter Vergleich, der Ihnen bei der Auswahl helfen soll.
| Merkmal | Gmail-API | Gmail SMTP |
|---|---|---|
| Authentifizierung | OAuth 2.0 | App-Passwort oder OAuth |
| Tägliche Versandbeschränkung | 2,000 Arbeitsbereich, 500 kostenlos | 500/Tag kostenloses Gmail |
| Anhänge | Bis zu 25 MB | Bis zu 25 MB |
| HTML-E-Mails | Ja | Ja |
| Fadenverfolgung | Etiketten & Fäden | Nein |
| Quittungen lesen | Ja | Nein |
| Programmatischer Zugriff | Voll, Suche, Labels, Entwürfe, Webhooks | Nur senden |
| Einrichtungsaufwand | Hoch OAuth + Cloud Console | Niedrig App-Passwort nur |
| Am besten für | SaaS-Anwendungen, CRM, ATS-Integration | Einfache Skripte, persönliche Nutzung |
Gmail API Ratenbegrenzungen und Kontingente
Das Verständnis der Gmail API-Ratenbegrenzungen ist unerlässlich, bevor Sie in die Produktion gehen. Das Überschreiten dieser Kontingente gibt einen 429 Ratenbegrenzung überschritten Fehler - Implementieren Sie immer exponentielles Backoff.
Fehlerbehandlung bei Ratenbegrenzungen mit exponentiellem Backoff
Wenn die Gmail API zurückgibt 429 Status, warten Sie, bevor Sie es erneut versuchen. Verwenden Sie exponentielles Backoff, um die API nicht zu überlasten und längere Sperren auszulösen.
import Zeit from googleapiclient.Fehler import HttpFehler def mit_wiederholung_senden(Dienst, benutzer_id, Nachricht, max_versuche=3): für Versuch in Reichweite(max_wiederholungen): versuchen: return Service.Benutzer().messages().senden.( userId=user_id, body=message ).ausführen() außer HttpFehler als Fehler: wenn Fehler.Antwort.Status == 429: # Ratenbegrenzt wartezeit = (2 Versuch) * 1 # exponentielle Rückschaltung: 1s, 2s, 4s print(f"Rate-begrenzt. Warte {wait_time}s vor erneutem Versuch {attempt + 1}/{max_retries}..."Zeit.Schlaf(wartezeit) sonst: erhöhen # Nicht-Rate-Limit-Fehler sofort erneut auslösen erhöhen Ausnahme(f"Gmail API E-Mail-Sendung fehlgeschlagen nach {max_retries} Wiederholungsversuchen")
Gängige Gmail API-Fehler und wie man sie behebt
Die meisten Fehler beim Senden von E-Mails über die Gmail API fallen in drei Kategorien: Authentifizierungsfehler (401), Berechtigungsprobleme (403) und fehlerhafte Anfragen (400). Hier ist eine Referenztabelle mit Ursachen und Lösungen.
| HTTP-Code | Fehlermeldung | Ursache | Lösung |
|---|---|---|---|
| 401 | Nicht autorisiert | Zugriffstoken abgelaufen |
Benutzen Sie Ihre
Aktualisierungsschlüssel um ein neues Zugriffstoken zu erhalten über oauth2.googleapis.com/token
|
| 403 | Verboten | Unzureichende OAuth-Bereiche |
Hinzufügen
https://www.googleapis.com/auth/gmail.send Umfang und Autorisierung des Benutzers erneut autorisieren
|
| 403 | RateLimitUeberschritten | Tägliche Quote überschritten |
Implementieren Sie exponentielles Backoff – warten Sie 1s, 2s, 4s zwischen Wiederholungsversuchen. Siehe Abschnitt „Ratenbegrenzungen“ oben.
|
| 400 | ungültiger_grant | Aktualisierungstoken widerrufen oder abgelaufen |
Der Benutzer muss sich erneut authentifizieren und Ihre App autorisieren. Leiten Sie einen neuen OAuth-Zustimmungsfluss ein.
|
| 400 | Fehlerhafte Anfrage | Ungültige MIME-Nachricht |
Überprüfen Sie, ob die Nachricht mit ... kodiert ist
base64.urlsafe_b64encode() - kein Standard-Base64
|
| 403 | unzureichende Berechtigungen | Dienstkonto fehlende Delegation |
Aktivieren Sie die domänenweite Delegierung in Google Workspace Admin und gewähren Sie dem Dienstkonto Gmail API-Bereiche
|
Sie suchen eine einheitliche Lösung? Die Unipile E-Mail-API-Leitfaden deckt Gmail, Outlook, IMAP und mehr mit einer einzigen Integration ab – ein Endpunkt, ein Authentifizierungsablauf, drei Anbieter.
Lesen Sie den Leitfaden zur E-Mail-APIOutlook und IMAP mit derselben API verbinden
Unipile geht über Gmail hinaus. Verknüpfen Sie Microsoft 365, Outlook.com und beliebige IMAP-Postfächer über eine einzige, einheitliche API, wobei OAuth für Sie bei Microsoft und eine flexible, kennwortbasierte Authentifizierung für IMAP übernommen wird.
Microsoft Graph-API
Mail.Lesen
Mail.Senden
Offline-Zugriff
Verknüpfe Microsoft-Konten mit Unipile mithilfe von OAuth. Registriere deine Anwendung in Azure Active Directory, konfigurieren Sie Unipile mit Ihrer AAD-Anwendungs-ID und beginnen Sie mit dem Versand von E-Mails über Outlook.com, Microsoft 365 und Exchange Online.
IMAP-API
Für jedes IMAP-kompatible Postfach, konfigurieren Sie die Servereinstellungen und wählen Sie die entsprechende Authentifizierungsmethode in Unipile aus. Geben Sie Host, Port und Anmeldedaten ein, um eine sichere Verbindung herzustellen., kein OAuth-Flow erforderlich.
Gmail API-E-Mail senden, Häufig gestellte Fragen
Antworten auf die häufigsten Fragen zum programmgesteuerten Versenden von E-Mails mit der Gmail API.
Gmail senden Umfang, eine MIME-Nachricht erstellen, sie im Base64url-Format kodieren und dann an die Benutzer.Nachrichten.Senden Endpunkt. Siehe die Python Beispiel und Node.js-Codebeispiele oben für eine vollständige, kopier-einfach-bereite Implementierung.
MIMEMultipart, Dateien anhängen mit MIMEBasis, die vollständige Nachricht in Base64URL kodieren und über den Gmail API-Endpunkt zum Senden von E-Mails senden. Die maximale Anhanggröße beträgt 25 MB pro Nachricht. Siehe das Beispiel für Anlagen im obigen Abschnitt.
userId='target@domain.com' zu users().messages().send(). Für die individuelle Benutzerdelegation siehe unser vollständiges E-Mail im Namen des Benutzers senden - Anleitung.
429 Ratenbegrenzung überschritten Fehler werden elegant behandelt. Ein vollständiges Codebeispiel finden Sie im Abschnitt über die Ratenbegrenzung oben.
MIMEMultipart('alternative') mit beiden Text/Klartext Fallback und eine text/html Teil. Kodieren Sie die vollständige MIME-Nachricht im Base64url-Format, bevor Sie sie über den Gmail API Send Email-Endpunkt senden. Gmail-Clients rendern die HTML-Version; andere Clients greifen automatisch auf einfachen Text zurück.
401 Unerlaubt, Ihr Zugriffstoken ist abgelaufen: Verwenden Sie den Aktualisierungsschlüssel ein neues zu erhalten über oauth2.googleapis.com/token. 403 Verboten, fehlt Gmail senden Bereich: mit richtigen Geltungsbereichen neu autorisieren. 400 ungültiger_Zugriff, Refresh-Token widerrufen: Der Benutzer muss Ihre App von Grund auf neu authentifizieren.
Das könnte Sie auch interessieren
Kalender-Synchronisierungs-API für SaaS: Google- und Outlook-Integration in Echtzeit
Für CRM, ATS, Outreach-Plattformen und KI-gesteuerte Software ist eine zuverlässige Kalender-API nicht mehr nur ein Nice-to-have. Sie ist jetzt ein wesentlicher Baustein, der die Produktivität, Buchungsworkflows, Wiedervorlagen, automatisierte Abläufe und die Teamkoordination fördert. Doch die Implementierung der Kalendersynchronisation ist eine...
Der vollständige Leitfaden für Entwickler zur Kalender-API-Integration
Moderne Software basiert auf Verbindungen, zwischen Menschen, Systemen und der Zeit selbst. Das Herzstück dieser Konnektivität ist die Kalender-API, eine wichtige Komponente, die es Anwendungen ermöglicht, Kalenderereignisse nahtlos zu lesen, zu erstellen und zu synchronisieren. Egal, ob Sie ein CRM, eine Rekrutierungsplattform oder eine...
E-Mail-API: Kompletter Leitfaden für Entwickler (2026)
Die Landschaft der E-Mail-API-Anbieter Drei Anbieter decken weltweit etwa 95% des professionellen E-Mail-Verkehrs ab: Gmail (und Google Workspace), Microsoft Outlook / Microsoft 365 und die universellen IMAP / SMTP-Protokolle für alles andere. Zu verstehen, was jeder Einzelne bietet und wie sie sich unterscheiden, ist der erste Schritt...


