Gmail API E-Mail senden: Python- und Node.js-Codebeispiele (2026)

Schnellstart

Gmail API E-Mail in 5 Zeilen senden

1
Installieren Sie das SDK
npm unipile-node-sdk installieren
2
Umgebungsvariablen setzen
Hinzufügen UNIPILE_DSN und UNIPILE_TOKEN zu dir .env Datei.
3
Ein Gmail-Konto verknüpfen
OAuth-Flow wird von Unipile behandelt – Token-Aktualisierung erfolgt automatisch, keine manuelle Re-Authentifizierung erforderlich.
4
Rufen client.email.sende()
Pass account_id, zu, Themaund Körper. Erledigt.
5
Überprüfen Sie die Antwort
Die API gibt eine Sendungs-ID Bestätigung der Zustellung über die Gmail API.
Gleicher Code für Outlook und IMAP - Eine einzige, einheitliche API, keine anbieterspezifische Logik erforderlich.
E-Mail senden.mjs
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_...' }
E-Mail gesendet – tracking_id zurückgegeben
Gmail API E-Mail senden - Unipile
E-Mail-API

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.

8 Min Lesezeit
Aktualisiert Juni 2025
Python, Node.js
OAuth 2.0 SMTP Höchstsätze Authentifizierung REST-API
gmail_send.py
# 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()
✓ Nachricht gesendet, ID: 18e3f2a9c4b...
Funktioniert auch mit:
Ausblick IMAP Google Kalender
über die Unipile Unified API
E-Mail-Integration aufbauen?

Lesen Sie unseren Vollständiger Leitfaden zur E-Mail-API – OAuth-Flows, Synchronisation, Senden und Anbietervergleich.

Gmail API E-Mail senden - Unipile
Google Mail Gmail-API

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.

Google Mail michel@company.com
3 Nachrichten
Alle
Gesendet
Inbox
Sarah Lee
Sarah Lee
Empfangen 09:41 Uhr
Betreff: Unterzeichneter Vertrag beigefügt
Danke Michel, ich habe alles überprüft und es sieht gut aus...
Michel Opra
Michel OpraAn Oscar B.
Gesendet Gestern
Q2 Bericht, endgültige Fassung
Hallo Oscar, im Anhang finden Sie den endgültigen Bericht für das zweite Quartal zur Überprüfung...
Oscar Brown
Oscar Brown
Empfangen Mo
Nachfassen zu unserem Telefonat von letzter Woche
Hallo, ich wollte mich kurz nach dem Zeitplan für die API-Integration erkundigen...
Warum die Gmail API zum Senden von E-Mails verwenden – Unipile
Wichtige Vorteile

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.

Stunden pro Woche sparen

Integration

Integrieren Sie den E-Mail-Versand nahtlos in den Workflow Ihrer Anwendung und verbessern Sie das Benutzererlebnis durch einen reibungslosen Ablauf.

Native In-App-UX

Personalisierung

Passen Sie E-Mail-Inhalte dynamisch basierend auf Benutzerdaten oder dem Anwendungszustand für wirklich personalisierte Nachrichten an.

Dynamische Vorlagen

Skalierbarkeit

Effiziente Verwaltung von E-Mail-Versand mit hohem Volumen, ideal für Anwendungen, die eine groß angelegte Kommunikation erfordern.

Bereit für hohe Stückzahlen
Einrichtung der Gmail API, Schritt-für-Schritt-Anleitung - Unipile

Einrichten der Gmail-API für das Versenden von E-Mails

Google OAuth-Dokumentation

Google 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.

1
2
3
4
5
6
7
8
9
10
01

Google Entwicklerkonsole aufrufen

Anmelden bei Google-Entwickler-Konsole Um Ihr Projekt einzurichten, benötigen Sie ein Google-Konto mit Administratorrechten.

02

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.

Neues Projekt in der Google Cloud Console erstellen
03

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}}/api/v1/hosted/google_auth_request_callback
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.

OAuth-Client-ID-Zugangsdaten erstellen
04

Aktivieren Sie die Gmail API-Bibliothek

Geh APIs & Dienste > Bibliothek, suchen nach Gmail-API, und klicken AKTIVIEREN.

Gmail API-Bibliothek aktivieren
05

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.

OAuth-Benutzertyp auswählen
06

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.
OAuth-App-Informationen
07

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.
OAuth-App-Domäne
08

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.
Autorisierte Domains
09

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.

Kontaktinformationen des Entwicklers
10

Erforderliche Bereiche hinzufügen

Klicken GELTENDE BEREICHE HINZUFÜGEN ODER ENTFERNEN und füge Folgendes hinzu (aktualisiere die Seite, falls sie nicht angezeigt werden):

./auth/gmail.send
./auth/gmail.labels
./auth/gmail.readonly
./auth/gmail.ändern

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.

Gmail API-Bereiche hinzufügen
Optional, für Produktions-Apps
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.

Vor der Erstellung des Videos
  • 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".
Authentifizierungssegment
  • 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.
Funktionssegment
  • 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).
Einreichungsschritte
  • 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.

Google-Sicherheitsbewertung

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.

Stufe 2, selbst gescannt
Laborgeprüft, am häufigsten. Kostenlose oder kostenpflichtige Option über einen externen Gutachter.
Stufe 3, Labor gescannt
Laborgeprüft, nur bezahlt. Muss von einem externen Gutachter abgeschlossen werden.
Jährliche Neubewertung

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.

Whitelisting-Option

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 Anwendungsfälle, CRM ATS Outreach iPaaS - Unipile
Anwendungsfälle

Gmail API für CRM, ATS, Outreach & iPaaS

E-Mails automatisieren, Unterhaltungen synchronisieren und die Kundenkommunikation auf jeder Art von B2B-SaaS-Plattform zentralisieren.

CRM-Systeme

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.

Zwei-Wege-Synchronisation zwischen Gmail und Kontaktdaten
Automatische Protokollierung Gesendete und empfangene E-Mails pro Geschäft
Vorlagen & Felder zusammenführen für personalisierte Ansprache
E-Mail-API für CRM
CRM-Pipeline
Gmail synchronisiert
Möglichkeiten
NexaTech
$32.000
2
Orbix
$18.500
Synthex
$24.200
Quark
$9.800
Google Mail Google Mail
LinkedIn
Aufgaben
Ich → Michel Opra
Hallo Michel, Anbei finden Sie den Vertrag. Mit freundlichen Grüßen.
Michel Opra → Ich
Hallo Sarah, danke. Hier finden Sie den unterschriebenen Vertrag. Haben Sie einen schönen Tag.
ATS & Recruiting

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.

Massenansprache zu akquirierten Kandidaten mit Nachverfolgung
Terminierung von Interviews E-Mails mit Kalenderintegration
Threaded conversations pro Kandidat, pro Stelle
E-Mail-API für ATS
Kandidatenpipeline
3 gesendet heute
Bezugsquelle
Alice K.
Ben M.
Kontaktiert
Clara V.
Diego S.
Interview
Emma R.
eingestellt
Felix O.
Google Mail Einladung zum Vorstellungsgespräch, Senior Engineer Stelle GESENDET
Hallo {{candidate.firstName}}, Gerne laden wir Sie nächste Woche zu einem 45-minütigen Gespräch ein...
Vertriebs- und Outreach-Tools

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.

Mehrschrittige Kadenzen mit Gmail, LinkedIn und WhatsApp
Öffnen- & Antwortverfolgung um zu messen, was funktioniert
Automatische Pause bei Antwort um Unterhaltungen menschlich zu gestalten
E-Mail-API für Outreach
Sequenz, SaaS-Gründer Q2
Aktiv
1
Tag 1, Einführungsemail
Gesendet an 124 Interessenten, 42 Öffnungen
Google Mail
2
Tag 3, LinkedIn verbinden
82 Anfragen gesendet, 31 angenommen
LinkedIn
3
Tag 5, Follow-up E-Mail
Sende jetzt, 18 in Warteschlange
Google Mail
124
Gesendet
34%
Öffnungsrate
12
Antworten
iPaaS & Workflow

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.

Endbenutzer-OAuth wird von Unipile gehandhabt, keine Entwicklungsarbeit
Webhook-Auslöser bei neuen E-Mail-Ereignissen
Skalieren auf Tausende von verknüpften Gmail-Konten
E-Mail-API für iPaaS
Workflow-Builder
Laufen
Google Mail
Google Mail
Unipile
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Auslöser, Neue E-Mail erhalten
Automatische Weiterleitung zu LinkedIn-Nachfassaktion
Live
Hauptfunktionen der Gmail API zum Senden von E-Mails - Unipile
Kernendpunkte

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.

GET

Alle E-Mails auflisten

unipile-api
locken. --Anfrage GET \ --url https://api.unipile \ .com/api/v1/emails \ --header 'akzeptieren: json'

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 auflisten
POST

Neue E-Mail senden

unipile-api
locken. --Anfrage POST \ --url https://api.unipile \ .com/api/v1/emails \ --header 'Content-Type: Formular'

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 senden
GET

Beschriftungen auflisten & abrufen

unipile-api
locken. --Anfrage GET \ --url https://api.unipile \ .com/api/v1/ordner \ --header 'akzeptieren: json'

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 abrufen
POST

Webhook-Tracking

unipile-api
locken. --Anfrage POST \ --url https://api.unipile \ .com/api/v1/webhooks \ --header 'akzeptieren: json'

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-Benachrichtigung
Gmail API Endpoints Überblick - Unipile
Google Mail Gmail API-Endpunkte

Alles, 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.

Kontoverbindung
2 Endpunkte
Hosted Auth, White-Label-E-Mail-Authentifizierung
POST
Verwenden Sie Ihren eigenen OAuth-Zustimmungsbildschirm für Apps
POST
Senden & Empfangen
5 Endpunkte
Eine E-Mail mit Anhängen, CC, BCC senden
POST
Antworte auf eine E-Mail und behalte den Thread-Kontext bei
POST
Alle E-Mails auflisten, mit Filtern und Paginierung
GET
Eine bestimmte E-Mail anhand der ID abrufen
GET
Anhänge aus einer E-Mail herunterladen
GET
Organisieren & Beschriftungen
5 Endpunkte
Ordner und Labels auflisten
GET
Ordner- oder Labeldetails abrufen
GET
Eine E-Mail in einen anderen Ordner verschieben
PATCH
E-Mail aktualisieren, als gelesen markieren, ungelesen, markiert
PATCH
Eine E-Mail endgültig löschen oder in den Papierkorb verschieben
DELETE
Webhooks & Tracking
3 Ereignisse
Ereignis: Neue E-Mail empfangen
POST
E-Mail gesendetes Ereignis, Antwortverfolgung
POST
Öffnungs- und Klick-Tracking-Ereignisse
POST

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.

Python Kopieren
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.

Node.js Kopieren
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.

Python Kopieren
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.

Python Kopieren
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()
Vermeiden Sie die OAuth-Komplexität
Eine API für Gmail, Outlook und IMAP

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.

Kostenlos mit dem Erstellen beginnen
Google Mail Ausblick IMAP Google Mail, Outlook, IMAP
Gmail API vs. SMTP Vergleich - Unipile
Vergleich

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
Funktionen im Vergleich
Authentifizierung
Gmail-API OAuth 2.0
Gmail SMTP App-Passwort oder OAuth
Tägliche Versandbeschränkung
Gmail-API 2.000 Arbeitsbereiche, 500 kostenlos
Gmail SMTP 500/Tag kostenloses Gmail
Anhänge
Gmail-API Bis zu 25 MB
Gmail SMTP Bis zu 25 MB
HTML-E-Mails
Gmail-API Ja
Gmail SMTP Ja
Fadenverfolgung
Gmail-API Etiketten & Fäden
Gmail SMTP Nein
Quittungen lesen
Gmail-API Ja
Gmail SMTP Nein
Programmatischer Zugriff
Gmail-API Voll, Suche, Labels, Entwürfe, Webhooks
Gmail SMTP Nur senden
Einrichtungsaufwand
Gmail-API Hoch OAuth + Cloud Console
Gmail SMTP Niedrig App-Passwort nur
Am besten für
Gmail-API SaaS-Anwendungen, CRM, ATS-Integration
Gmail SMTP Einfache Skripte, persönliche Nutzung
Für SaaS-Anwendungen und Entwicklerwerkzeuge, die eine vollständige Postfachintegration benötigen, nicht nur zum Senden, Gmail API-E-Mail-Versand ist die klare Wahl. Wenn Sie mehrere E-Mail-Anbieter (Gmail, Outlook, IMAP) aus einer einzigen Codebasis unterstützen müssen, sollten Sie folgendes in Betracht ziehen Unipiles integrierte E-Mail-API, es abstrahiert die OAuth-Komplexität für alle drei Anbieter hinter einem einzigen Endpunkt.
Quoten

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.

2,000
Nachrichten / Tag
Google Workspace-Konten
500
Nachrichten / Tag
Kostenlose Gmail-Konten (@gmail.com)
10,000
Empfänger / Tag
Über alle gesendeten Nachrichten
25 MB
Maximale Nachrichtengröße
Anbei alle Anhänge
250
Kontingenteinheiten / Sekunde
Pro Projekt, pro Benutzer

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.

Python Kopieren
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")
Fehlerbehebung

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-API
Über Gmail, Microsoft & IMAP-E-Mail-APIs hinaus - Unipile
Jenseits von Gmail

Outlook 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 Outlook
OAuth 2.0

Microsoft Graph-API

Verifiziert
API-Berechtigungen Gewährt
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.

Outlook.com, Microsoft 365 und Exchange Online unterstützt
Gehostete Autorisierung sodass Ihre Nutzer Konten verknüpfen, ohne Ihre App zu verlassen
Volle Unterstützung bei der AAD-Einrichtung von unserem Team bei der Registrierung
Microsoft API
IMAP
Anmeldedaten-Authentifizierung

IMAP-API

imap.example.com, 993
SSL
Verbindungskonfiguration
Gastgeber: imap.provider.com
Port 993
Benutzer: michel@company.com
Konto verknüpft, Synchronisierung aktiv

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.

Jeder IMAP-Provider unterstützt, iCloud, Yahoo, Proton Bridge, benutzerdefinierte Server
App-Passwörter und OAuth-Brücke unterstützt, wo verfügbar
Sichere Speicherung von Anmeldedaten mit vollständiger Verschlüsselung im Ruhezustand
IMAP-API
Eine API, jeder E-Mail-Provider
Gmail, Outlook und IMAP parallel unterstützen, ohne drei separate Integrationen aufrechtzuerhalten.
Entdecken Sie die einheitliche E-Mail-API
Gmail API E-Mail senden FAQ - Unipile
FAQ

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.

01 Wie sende ich eine E-Mail mit der Gmail API?
Gmail API in der Google Cloud Console aktivieren, OAuth 2.0-Anmeldedaten mit 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.
02 Ist die Gmail API kostenlos zu verwenden?
Ja, die Gmail API verursacht keine direkten Kosten. Kostenlose Gmail-Konten können bis zu 500 E-Mails pro Tag senden; Google Workspace-Konten erhalten 2.000 pro Tag. Zusätzliche Quoten können je nach Konfiguration Ihres Google Cloud-Projekts und der Anzahl der API-Aufrufe pro Sekunde gelten.
03 Was ist der Unterschied zwischen der Gmail API und SMTP?
Die Gmail API bietet vollen programmatischen Zugriff auf das Postfach (Threads, Labels, Entwürfe, Webhooks) mit OAuth 2.0-Sicherheit und höheren Tageslimits. SMTP unterstützt nur das Senden. Für SaaS-Anwendungen, die eine vollständige Posteingangsintegration erfordern, ist die Gmail API die richtige Wahl; für einfache persönliche Skripte kann SMTP ausreichen.
04 Kann ich E-Mails mit Anhängen über die Gmail API senden?
Ja. Erstellen Sie eine mehrteilige MIME-Nachricht mit 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.
05 Wie sende ich E-Mails im Namen eines anderen Nutzers mit der Gmail API?
Für die domänenweite Delegation konfigurieren Sie ein Dienstkonto in der Google Cloud Console mit Gmail API-Bereichen und übergeben dann 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.
06 Wie sind die Ratenbegrenzungen der Gmail API?
Kostenloses Gmail: 500 Nachrichten pro Tag. Google Workspace: 2.000 Nachrichten pro Tag. Beide Stufen teilen sich ein Limit von 10.000 Empfängern pro Tag und ein Limit von 25 MB pro Nachrichtengröße. Implementieren Sie exponentielles Backoff zur Verarbeitung von 429 Ratenbegrenzung überschritten Fehler werden elegant behandelt. Ein vollständiges Codebeispiel finden Sie im Abschnitt über die Ratenbegrenzung oben.
07 Unterstützt die Gmail API HTML-E-Mails?
Ja. Verwenden Sie . 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.
08 Wie gehe ich mit Gmail API-Authentifizierungsfehlern um?
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.
Benötigen Sie einen einfacheren Weg zur E-Mail-Integration?
Überspringen Sie anbieterspezifisches OAuth, verbinden Sie Gmail, Outlook und IMAP mit einer einzigen API.
Sprechen Sie mit einem Experten

Das könnte Sie auch interessieren

Der vollständige Leitfaden für Entwickler zur Kalender-API-Integration

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...

mehr lesen
E-Mail-API: Kompletter Leitfaden für Entwickler (2026)

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...

mehr lesen
de_DEDE