Gmail API E-mail Verzenden: Python & Node.js Codevoorbeelden (2026)

Snel aan de slag

Gmail API E-mail Verzenden in 5 Regels

1
Installeer de SDK
npm installeer unipile-node-sdk
2
Omgevingsvariabelen instellen
Toevoegen UNIPILE_DSN en UNIPILE_TOKEN naar jou .env bestand.
3
Koppel een Gmail-account
OAuth-flow afgehandeld door Unipile - tokenvernieuwing is automatisch, geen handmatige herauthenticatie nodig.
4
Roepen client.email.verstuur()
Pass account_id, naar, onderwerpen lichaam. Klaar.
5
Controleer de reactie
De API retourneert een tracking_id bevestiging van levering via de Gmail API.
Hetzelfde code voor Outlook en IMAP - één uniforme API, geen provider-specifieke logica nodig.
e-mail-verzenden.mjs
importeer { UnipileClient } van 'unipile-node-sdk';const klant = nieuw UnipileClientproces.env.UNIPILE_DSN, omgevingsvariabelen.UNIPILE_TOKEN);const resultaat = wachten client.e-mail.verzendenaccount_id: 'acc_xxxxxxxxxxxxxxxx', naar: [{ weergavenaam: 'Alice Martin', identificatie: 'alice@acme.com'}], onderwerp: 'Hallo van de Gmail API', lichaam: '

Verzonden via Unipile!

'
});console.log(resultaat); // { tracking_id: 'msg_...' }
E-mail verzonden - tracking_id geretourneerd
Gmail API E-mail Verzenden - Unipile
E-mail API

Gmail API Verzenden E-mail,
Python & Node.js
Codevoorbeelden

Een complete ontwikkelaarsgids voor het programmatisch verzenden van e-mails met de Gmail API: OAuth 2.0 installatie, codevoorbeelden, snelheidslimieten en SMTP-vergelijking.

8 minuten leestijd
Bijgewerkt juni 2025
Python, Node.js
OAuth 2.0 SMTP Tariefgrenzen Authenticatie REST API
gmail_verzenden.py
# E-mail verzenden met Gmail API
importeer base64
van email.mime.tekst importeer MIMETekst
van googleapiclient.discovery importeer bouwen

def e-mail_verzenden(dienst, naar, onderwerp, inhoud):
    msg = MIMEText(body)
    bericht['naar'] = naar
    bericht['onderwerp'] = onderwerp
    raw = base64.urlsafe_b64encode(
        msg.als_bytes()
    ).decode()
    return service.users().berichten().verzenden(
        gebruikersId="mij,
        lichaam={'rauw': ruw}
    ).uitvoeren()
✓ Bericht verzonden, ID: 18e3f2a9c4b...
Werkt ook met:
Outlook IMAP Google Agenda
via Unipile Unified API
Een e-mailintegratie bouwen?

Lees onze Volledige E-mail API Gids - OAuth-flows, synchronisatie, verzenden en vergelijking van providers.

Wat is de Gmail API Verzend E-mail - Unipile
Gmail Gmail API

Wat is Gmail API E-mail verzenden?

Het versturen van e-mails via de Gmail API omvat het gebruik van HTTP-verzoeken om te interageren met de back-endsystemen van Gmail. In plaats van handmatig e-mails samen te stellen en te verzenden via de Gmail-interface, kunnen ontwikkelaars het proces binnen hun applicaties automatiseren.

De API biedt eindpunten waarmee ontwikkelaars e-mailberichten kunnen aanmaken en verzenden in verschillende formaten, waaronder platte tekst, HTML en e-mails met bijlagen. Het ondersteunt ook meer geavanceerde functies, zoals threading en het beheren van e-maillabels, waardoor het een uitgebreide oplossing is voor programmatische e-mailcommunicatie. Voor verzending via meerdere providers (Gmail, Outlook, IMAP), zie de Unified API-handleiding voor het verzenden van e-mail. Voor een cross-provider aanpak, onderzoek de e-mail Verzenden API.

Gmail michel@company.com
3 berichten
Alle
Verzonden
Inbox
Sarah Lee
Sarah Lee
Ontvangen 09:41
Betreft: Ondertekend contract bijgevoegd
Bedankt Michel, ik heb alles doorgenomen en het ziet er goed uit...
Michel Opra
Michel Opraaan Oscar B.
Verzonden Gisteren
Q2 Rapport, definitieve versie
Hoi Oscar, zie bijgevoegd het definitieve Q2-rapport ter beoordeling...
Oscar Brown
Oscar Brown
Ontvangen Mon
Opvolging van ons telefoongesprek van vorige week
Hé, hoe zit het met de tijdlijn voor de API-integratie...
Waarom de Gmail API gebruiken voor het verzenden van e-mails - Unipile
Belangrijkste voordelen

Waarom Gmail API gebruiken voor het verzenden van e-mails?

Het gebruik van de Gmail API voor het verzenden van e-mails biedt verschillende voordelen die het een krachtige keuze maken voor moderne applicaties.

Automatisering

Automatiseer routinematige e-mailtaken, bespaar tijd en verminder handmatige fouten in uw gehele workflow.

Bespaar wekelijks uren

Integratie

Integreer e-mailverzending rechtstreeks in de workflow van uw app, waardoor de gebruikerservaring wordt verbeterd met een naadloze stroom.

Native in-app UX

Aanpassing

Pas e-mailinhoud dynamisch aan op basis van gebruikersgegevens of toepassingsstatus voor echt gepersonaliseerde berichten.

Dynamische sjablonen

Schaalbaarheid

Efficiënt e-mailverzending met een hoog volume beheren, ideaal voor toepassingen die grootschalige communicatie vereisen.

Klaar voor grote volumes
Gmail API Instellen, Stap-voor-Stap Gids - Unipile

Gmail API instellen voor het verzenden van e-mails

Google OAuth Documentatie

Google verplicht derde partij-applicaties hun app in te dienen voor verificatie van het gebruik van Google-gebruikersgegevens. Volg de 10 stappen hieronder om OAuth te configureren, de Gmail API in te schakelen en uw inloggegevens gereed te maken voor productie. Zie ook: het beveiligen van uw e-mail API-integratie.

1
2
3
4
5
6
7
8
9
10
01

Toegang tot de Google Developers Console

Meld u aan bij de Google Ontwikkelaars Console Om uw project in te stellen, heeft u een Google-account met beheerdersrechten nodig.

02

Maak een nieuw Google Project

Meld je aan op de Google Ontwikkelaars Console en maak een nieuw project aan of gebruik een bestaand Google-project. Klik op NIEUW PROJECT in de projectkiezer om te beginnen.

Nieuw project maken in Google Cloud Console
03

OAuth-client-id-gegevens maken

Navigeer naar API's & Services > Referenties, klik dan CREËER REFERENTIES > OAuth-client-ID.

  • Type toepassing: Webtoepassing
  • Naam: Je interne naam
  • Toevoegen 2 Geautoriseerde omleidings-URI's met uw Unipile DSN (beschikbaar in de 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}}

Eenmaal gecreëerd, voeg de toe Klant-ID en Clientgeheim naar Unipile Dashboard > Instellingen > Google OAuth.

OAuth-client-id-gegevens maken
04

Schakel de Gmail API-bibliotheek in

Ga naar API's en Services > Bibliotheek, zoeken naar Gmail API, en klik INschakelen.

Gmail API-bibliotheek inschakelen
05

Configureer Google-aanmeldingsscherm, Gebruikerstype

Kies uw gebruikerstype op basis van uw testfase:

  • Intern: Beperkt tot Google Workspace-gebruikers binnen uw organisatie.
  • Extern en in testen: Vereist het toevoegen van testgebruikers. Tokens verlopen na 7 dagen.

Raadpleeg voor meer informatie over Gebruikerstypen de Google documentatie.

Selecteer OAuth-gebruikerstype
06

Vul app-informatie in

In het OAuth-scherm met toestemming, geef het volgende op:

  • Applicatienaam: De weergavenaam van je app.
  • Klantenservice E-mail: Een contact-e-mailadres of distributielijst voor gebruikersvragen.
  • App-logo: Upload uw toepassingslogo voor visuele identificatie.
OAuth-appgegevens
07

App-domeingegevens instellen

  • Applicatie Homepage URL: Een echte startpagina, niet zomaar een inlogpagina.
  • Link naar privacybeleid: Zorg ervoor dat het voldoet Google's specifieke vereisten, met name de sectie Beperkt Gebruik.
  • Link naar de Servicevoorwaarden: URL algemene voorwaarden.
OAuth-appdomein
08

Geautoriseerde domeinen toevoegen

  • Voeg uw productie-app-domein toe (niet het dev- of staging-domein).
  • Toevoegen unipile.com als een tweede geautoriseerd domein.
Geautoriseerde domeinen
09

Voer ontwikkelaarscontactgegevens in

Geef een e-mailadres op dat Google kan gebruiken voor verificatieberichten. Gebruik een distributielijst zodat alle relevante teamleden updates ontvangen. Houd dit e-mailadres regelmatig in de gaten, aangezien e-mails van Google soms in de spammap terecht kunnen komen.

Contactgegevens ontwikkelaar
10

Vereiste bereiken toevoegen

Klik VOEG SCOPES TOE OF VERWIJDER ZE en voeg het volgende toe (ververs de pagina als ze niet verschijnen):

./auth/gmail.send
./auth/gmail.labels
./auth/gmail.alleen-lezen
./auth/gmail.wijzigen

Opmerking: gmail-aanpassen is alleen vereist als je e-mails wilt verplaatsen of verwijderen. Als je het niet gebruikt, neem dan contact op met de ondersteuning van Unipile om het handmatig uit je account te verwijderen.

Voeg Gmail API Scopes toe
Optioneel, voor productie-apps
11
Genereer Uw Demonstratievideo
Vereist slechts eenmalig nadat uw integratie volledig live is in productie

Produceer en host een demonstratievideo die voldoet aan de vereisten van Google. Upload deze als een Niet-vermelde YouTube-video, er is slechts één videolink toegestaan.

Voordat je de video maakt
  • Uw app en OAuth-stroom worden gepresenteerd in het Engels, zoals aangegeven in de Google-documentatie.
  • De demonstratie wordt uitgevoerd in een domein op productieniveau.
  • In Google Projectinstellingen, bevestigen Publicatiestatus in productie Gebruikerstype is "Extern".
Authenticatiesegment
  • Toon de startpagina van uw applicatie met de volledige URL.
  • Illustreer hoe een Google-klant hun account kan koppelen via de officiële Google-aanmeldknop.
  • Tijdens de OAuth-stroom, markeer de URL en onthul de KLANT ID.
Functionaliteit segment
  • Toon sequentieel elke gevraagde scope, afgestemd op uw specifieke gebruikssituatie.
  • Demonstreer bi-directionele functionaliteit door synchronisatie tussen uw app en Gmail te tonen (verzenden, ontvangen en updates van de map Verzonden e-mail).
Indieningsstappen
  • Voeg de definitieve video toe aan je Google Project als een niet-vermelde YouTube-videolink.
  • Dien de YouTube URL in bij uw Customer Success Manager ter beoordeling.
  • Na controle, ga verder met het indienen van de app-verificatie.

Tijdlijn: verificatie kan ergens tussen de 2 tot 8 weken afhankelijk van de wachtrij van Google en het aantal herstelrondes.

12
Whitelisting & Beveiligingsbeoordeling voor Beperkte Scopes
Is uitsluitend van toepassing als uw toepassing beperkte bereiken gebruikt

Als uw applicatie gebruikmaakt van beperkte scopes, zijn aanvullende stappen vereist.

Google Beveiligingsbeoordeling

Apps die toegang vragen tot beperkte Google gebruikersgegevens moeten een beveiligingsbeoordeling ondergaan via de CASA (Cloud Application Security Assessment) programma. Google categoriseert je app als Tier 2 of Tier 3.

Tier 2, zelf gescand
Lab Geverifieerd, meest voorkomend. Gratis of betaalde optie via een externe beoordelaar.
Tier 3, Lab gescand
Laboratoriumgeverifieerd, alleen betalen. Moet worden voltooid door een externe beoordelaar.
Jaarlijkse herbeoordeling

Apps die toegang hebben tot beperkte scopes moeten een veiligheidsbeoordeling afronden elke 12 maanden om toegang te behouden. Als u een nieuwe beperkte scope introduceert die niet eerder is goedgekeurd, kan uw app opnieuw beoordeeld moeten worden.

Het reviewteam van Google zal via e-mail contact opnemen. Houd je Projecteigenaar en Projectredacteur informatie actueel houden in de Cloud Console zodat de juiste teamleden deze meldingen ontvangen.

Whitelisting-optie

Als alternatief voor de standaard beveiligingsreview kunt u uw applicatie op een witte lijst laten zetten. Dit omzeilt de gebruikelijke procedures, maar is alleen van toepassing als uw applicatie aan zeer specifieke criteria voldoet:

  • De meeste klanten gebruiken Google Workspace: de meeste klanten zouden e-mails moeten hebben in het formaat @bedrijf.com.
  • Door de beheerder geïnitieerd witlist-beheer: uw eindgebruikers 'beheerders toestaan toegang te krijgen via hun beheerdersconsole met uw Google Client-ID.
  • Beperkt Persoonlijk Gmail Gebruik: minder dan 100 persoonlijke Gmail-accounts (@gmail.com) moeten authenticeren.
  • Niet-geverifieerde projecten hebben een levenslange gebruikerslimiet van 100. Werkruimtetegoeden tellen niet mee voor deze limiet, maar persoonlijke Gmail-accounts wel altijd.
  • Gratis proefgebruikers moeten hun Workspace e-mailadres gebruiken en de applicatie whitelisten.

Whitelisting is een tijdelijke oplossing en past mogelijk niet bij alle toepassingen. Evalueer de criteria zorgvuldig voordat u voor deze weg kiest.

Gmail API Gebruiksscenario's, CRM ATS Outreach iPaaS - Unipile
Gebruikscases

Gmail API voor CRM, ATS, Outreach & iPaaS

Automatiseer e-mailverzending, synchroniseer gesprekken en centraliseer klantcommunicatie op elk type B2B SaaS-platform.

CRM-systemen

Log en verzend e-mails zonder uw CRM te verlaten

Automatiseer e-mailcommunicatie, houd interacties bij en verbeter klantbetrokkenheid. Log e-mails van klanten, verstuur gepersonaliseerde berichten en centraliseer alle gesprekken binnen uw pijplijn.

Bidirectionele synchronisatie tussen Gmail en contactgegevens
Automatische logging van verzonden en ontvangen e-mails per deal
Sjablonen & samenvoegvelden voor gepersonaliseerde benadering
E-mail-API voor CRM
CRM-pijplijn
Gmail gesynchroniseerd
Kansen
NexaTech
$32.000
2
Orbix
$18.500
Synthex
$24.200
Quark
$9.800
Gmail Gmail
LinkedIn
Taken
Ik → Michel Opra
Hallo Michel, Hierbij de bijlage met het contract. Met vriendelijke groet.
Michel Opra → Ik
Hallo Sarah, Bedankt. Hierbij vindt u het getekende contract. Fijne dag.
ATS & Recruitment

E-mails naar kandidaten versturen vanuit één centrale inbox

Gestroomlijnd kandidaatcommunicatie, interviews plannen en aanbiedingsbrieven rechtstreeks vanuit uw wervingsplatform verzenden. Elk antwoord wordt automatisch gekoppeld aan het juiste kandidaatprofiel.

Groepsuitbreiding aan geworven kandidaten met tracking
Planning sollicitatiegesprek e-mails met agenda-integratie
Gedialoogde gesprekken per kandidaat, per rol
E-mail-API voor ATS
Kandidaatpijplijn
3 verzonden vandaag
Herkomst
Alice K.
Ben M.
Contact opgenomen met
Clara V.
Diego S.
Interview
Emma R.
Inhuren
Felix O.
Gmail Uitnodiging voor een gesprek, rol van Senior Engineer VERZONDEN
Hallo {{candidate.firstName}}, Graag nodigen we je uit voor een videogesprek van 45 minuten volgende week...
Outreach & Verkooptools

Krachtige e-mailreeksen met meerdere stappen op schaal

Bouw multi-channel sequenties op met Gmail als de kern e-mail engine. Verstuur gepersonaliseerde berichten, volg opens en antwoorden op en activeer opvolgingen op basis van prospectgedrag.

Meerstapskadensen met Gmail, LinkedIn en WhatsApp
Open & antwoord tracking om te meten wat werkt
Automatisch pauzeren bij antwoord om gesprekken menselijk te houden
E-mail-API voor bereik
Sequentie, SaaS Oprichters Q2
Actief
1
Dag 1, Introductie-e-mail
Verstuurd naar 124 prospects, 42 opens
Gmail
2
Dag 3, LinkedIn connect
82 verzoeken verzonden, 31 geaccepteerd
LinkedIn
3
Dag 5, Opvolgmail
Wordt nu verzonden, 18 in wachtrij
Gmail
124
Verzonden
34%
Openingspercentage
12
Antwoorden
iPaaS & Workflow

Gmail-acties activeren binnen elke workflow

Integreer de verzendmogelijkheden van Gmail in automatiseringsbouwers. Laat eindgebruikers hun Gmail-account koppelen en e-mails als onderdeel van workflows met meerdere stappen activeren, zonder de OAuth-stroom vanaf nul te hoeven bouwen.

OAuth voor eindgebruikers afgehandeld door Unipile, geen ontwikkelingswerk
Webhook-triggers bij nieuwe e-mailgebeurtenissen
Schaal naar duizenden van gekoppelde Gmail-accounts
E-mail-API voor iPaaS
Workflow Builder
Hardlopen
Gmail
Gmail
Eenpaal
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Trigger, Nieuwe e-mail ontvangen
Automatische route naar LinkedIn-opvolgingsactie
Live
Belangrijkste kenmerken Gmail API E-mail verzenden - Unipile
Kern Eindpunten

Belangrijkste kenmerken van de Gmail API voor het Verzenden van E-mails

E-mails ophalen, nieuwe berichten opstellen en verzenden, labels beheren en realtime webhookmeldingen ontvangen. Vier kernmogelijkheden die elke e-mailworkflow in je applicatie dekken.

GET

Alle e-mails weergeven

unipile-api
krul --verzoek KRIJGEN --url https://api.unipile \ .com/api/v1/emails \ -kop 'accepteer: json'

E-mails uit het Gmail-account van een gebruiker ophalen en weergeven. Filteren op map, datum, afzender of leesstatus voor krachtig zoeken en beheren.

E-mailfunctie weergeven
POST

Nieuwe e-mail verzenden

unipile-api
krul --verzoek POST --url https://api.unipile \ .com/api/v1/emails \ -kop 'content-type: formulier'

Programmatisch e-mails opstellen en versturen, rechtstreeks vanuit uw app. Ondersteuning voor HTML, platte tekst, bijlagen, CC, BCC en thread-antwoorden.

Stuur e-mail functie
GET

Labels weergeven & ophalen

unipile-api
krul --verzoek KRIJGEN --url https://api.unipile \ .com/api/v1/mappen \ -kop 'accepteer: json'

Beheer Gmail-labels en mappen door individuele labeldetails te vermelden of op te halen. Organiseer en categoriseer e-mails voor slimmere workflowroutering.

Label weergeven en ophalen
POST

Webhook Tracking

unipile-api
krul --verzoek POST --url https://api.unipile \ .com/api/v1/webhooks \ -kop 'accepteer: json'

Stel webhooks in om realtime updates te ontvangen over e-mailactiviteit. Activeer directe acties bij nieuwe berichten, opens, antwoorden of bounces.

Webhookmelding
Gmail API-eindpunten Overzicht - Unipile
Gmail Gmail API-eindpunten

Alles wat je kunt doen met de Gmail API

Een compleet overzicht van de Gmail-eindpunten die beschikbaar zijn via Unipile, van accountverbinding tot webhook-tracking.

Account verbinding
2 eindpunten
Hosted Auth, white label e-mailauthenticatie
POST
Gebruik uw eigen OAuth-instelscherm van de app
POST
Verzenden & Ontvangen
5 eindpunten
E-mail verzenden, met bijlagen, CC, BCC
POST
Re: [Origineel onderwerp]
POST
Alle e-mails weergeven, met filters en paginering
GET
Haal een specifieke e-mail op met ID
GET
Bijlagen van een e-mail downloaden
GET
Organiseren & Labels
5 eindpunten
Mappen en labels weergeven
GET
Ophalen van map- of labeldetails
GET
Verplaats een e-mail naar een andere map
PATCH
E-mail bijwerken, als gelezen markeren, ongelezen, ster
PATCH
Een e-mail permanent verwijderen of naar de prullenbak verplaatsen
DELETE
Webhooks & Tracking
3 evenementen
Nieuw e-mailbericht ontvangen gebeurtenis
POST
E-mail verzonden gebeurtenis, antwoord tracking
POST
Open- en kliktracking gebeurtenissen
POST

Hoe een e-mail te verzenden met de Gmail API

Complete Python en Node.js voorbeelden voor het verzenden van platte tekst, HTML en e-mails met bijlagen via de Gmail API. Direct te kopiëren met OAuth 2.0 authenticatie inbegrepen.

1 Stuur een platte tekst e-mail (Python)

Gebruik de officiële google-api-python-client en google-authenticatie bibliotheken. De functie construeert een MIME-bericht, codeert het naar base64url en plaatst het naar het Gmail API verzendpunt.

Python Kopie
importeer base64
van email.mime.tekst importeer MIMETekst
van google.oauth2.credentials importeer Geloofsbrieven
van googleapiclient.discovery importeer bouwen

def e-mail_verzenden(naar, onderwerp, body, credentials_dict):
    creds = Geloofsbrieven(**credentials_dict)
    service = bouwen('Gmail', 'v1', credentials=creds)

    bericht = MIMETekst(lichaam)
    bericht['naar'] = naar
    bericht['onderwerp'] = onderwerp

    ruw = base64.urlsafe_b64encode(bericht.als_bytes()).ontcijfer()

    resultaat = service.gebruikers().berichten().verzenden(
        gebruikersId="mij,
        lichaam={'rauw': ruw}
    ).uitvoeren()

    print(f"Bericht verzonden. ID: {result['id']}")
    return resultaat

# Gebruik
e-mail_verzendenAan='recipient@example.com',
    onderwerp='Hallo van de Gmail API',
    lichaam='Deze e-mail is verzonden via Gmail API e-mail verzenden.',
    credentials_dict={
        'token': 'UW_TOEGANGSTOKEN',
        'vernieuwingstoken': 'JOUW_VERVERSINGSTOKEN',
        'client_id': 'UW_KLANT_ID',
        'client_geheim': 'JE_CLIENT_GEHEIM',
        'token_uri': 'https://oauth2.googleapis.com/token'
    }
)

2 Eenvoudige Tekst E-mail Verzenden (Node.js)

Gebruik de googleapis npm-pakket. Het bericht is opgebouwd als een ruwe RFC 2822-string, gecodeerd in base64url en verzonden via de Gmail API.

Node.js Kopie
const { Google } = require('googleapis');

async function e-mail verzenden(auth, naar, onderwerp, bericht) {
  const gmail = google.gmail({ versie: 'v1', auth });

  const bericht = [
    Aan: ${to},
    Onderwerp: ${subject},
    '',
    lichaam
  ].meedoen('\n');

  const encodedBericht = Buffer.van(bericht) .toString("base64)
    .vervang(/\+/g, '-')
    .vervang(/\//g, '_')
    .vervang(/=+$/, '');

  const resultaat = wacht op gmail.users.messages.verzendengebruikersId: "mij,
    requestBody: { raw: encodedMessage }
  });

  console.log(Bericht verzonden. ID: ${result.data.id});
  return result.data;
}

// OAuth2-configuratie
const oauth2Client = nieuw google.auth.OAuth2(
  'UW_KLANT_ID',
  'JE_CLIENT_GEHEIM',
  'JOUW_REDIRECT_URI'
);

oauth2Client.stuurAanmeldgegevenstoegangstoken: 'UW_TOEGANGSTOKEN',
  vernieuwingstoken: 'JOUW_VERVERSINGSTOKEN'
});

e-mail verzendenoauth2Client, 'recipient@example.com', 'Hallo', 'Verzonden via Gmail API e-mail verzenden!');

3 Verzend een HTML-e-mail (Python)

Gebruik MIMEMultipart('alternatief') met beide een tekst/plat reserve en een tekst/html onderdeel. Gmail-clients zullen de HTML-versie weergeven; andere clients vallen terug op platte tekst.

Python Kopie
van email.mime.multipart importeer MIMEMultipart
van email.mime.tekst importeer MIMETekst
importeer base64

def stuur_html_email(service, aan, onderwerp, html_body):
    bericht = MIMEMultipart('alternatief')
    boodschap['naar'] = naar
    bericht['onderwerp'] = onderwerp

    # Gewone tekst fallback
    tekst_deel = MIMETekst('Bekijk deze e-mail in een HTML-compatibele client.', 'gewoon')
    # HTML-versie
    html_deel = MIMETekst(html_lichaam, 'html')

    bericht.bijlagebericht.bijlageraw = base64.urlsafe_b64encode(bericht.als_bytes()).ontcijfer()

    return service.gebruikers().berichten().verzenden(
        gebruikersId="mij,
        lichaam={'rauw': ruw}
    ).uitvoeren()

# Gebruik
html_content = """

  
    

Hallo!

Deze e-mail werd verzonden met Gmail API e-mail verzenden.

"""
stuur_html_email(dienst, 'to@example.com', 'HTML E-mail via Gmail API', html_inhoud)

4 E-mail verzenden met bijlagen (Python)

Plak elk bestandstype door de bestandsbytes te lezen, het MIME-type te raden en het toe te voegen aan een MIMEMultipart Maximale bijlagegrootte is 25 MB per bericht.

Python Kopie
importeer base64
importeer mimetypen
van email.mime.multipart importeer MIMEMultipart
van email.mime.tekst importeer MIMETekst
van email.mime.basis importeer MIMEBasis
van e-mail importeer encoders

def e-mail_met_bijlage_verzenden(service, naar, onderwerp, bericht, bestand_pad):
    bericht = MIMEMultipart()
    bericht['naar'] = naar
    bericht['onderwerp'] = onderwerp
    bericht.bijlage(MIMETekst(lichaam, 'gewoon'))

    # MIME-type detecteren en bestand bijvoegen
    content_type, encoding = mimetypes.type_raden(locatie_bestand)
    hoofd_type, sub_type = inhoud_type.deel('/', 1)

    met openbestandspad, 'rb') als f:
        bijlage = MIMEBasis(hoofd_type, sub_type)
        bijlage.laden_instellen(v.lezenencoders.encode_base64bijlage.koptekst toevoegen(
            'Content-Disposition',
            f'bijlage; bestandsnaam="{file_path.split("/")[-1]}"
        )
        bericht.bijlageGrond = base64.urlsafe_b64encode(bericht.als_bytes()).ontcijfer()

    return service.gebruikers().berichten().verzenden(
        gebruikersId="mij,
        lichaam={'rauw': ruw}
    ).uitvoeren()
Sla de OAuth-complexiteit over
Eén API voor Gmail, Outlook en IMAP

De E-mail API van Unipile laat je e-mails verzenden vanuit Gmail, Outlook en IMAP-accounts met één uniforme endpoint – geen provider-specifieke OAuth-setup vereist. Koppel accounts in minuten, niet in dagen.

Begin gratis met bouwen
Gmail Outlook IMAP Gmail, Outlook, IMAP
Gmail API vs SMTP Vergelijking - Unipile
Vergelijking

Gmail API versus SMTP, welke moet je gebruiken?

Zowel de Gmail API als Gmail SMTP laten je e-mails programmatisch versturen, maar ze dienen heel verschillende doelen. Hier is een directe vergelijking om je te helpen kiezen.

Functie Gmail API Gmail SMTP
Authenticatie OAuth 2.0 App-wachtwoord of OAuth
Dagelijks verzendlimiet 2,000 Werkruimte, 500 gratis 500/dag gratis Gmail
Bijlagen Tot 25 MB Tot 25 MB
HTML-e-mails Ja Ja
Draad volgen Labels & threads Geen
Ontvangsten lezen Ja Geen
Programmatische toegang Volledig, zoeken, labels, concepten, webhooks Alleen verzenden
Installatiecomplexiteit Hoog OAuth + Cloud Console Laag App-wachtwoord alleen
Het beste voor SaaS-apps, CRM-, ATS-integraties Eenvoudige scripts, persoonlijk gebruik
Functies vergeleken
Authenticatie
Gmail API OAuth 2.0
Gmail SMTP App-wachtwoord of OAuth
Dagelijks verzendlimiet
Gmail API 2.000 Werkruimte, 500 gratis
Gmail SMTP 500/dag gratis Gmail
Bijlagen
Gmail API Tot 25 MB
Gmail SMTP Tot 25 MB
HTML-e-mails
Gmail API Ja
Gmail SMTP Ja
Draad volgen
Gmail API Labels & threads
Gmail SMTP Geen
Ontvangsten lezen
Gmail API Ja
Gmail SMTP Geen
Programmatische toegang
Gmail API Volledig, zoeken, labels, concepten, webhooks
Gmail SMTP Alleen verzenden
Installatiecomplexiteit
Gmail API Hoog OAuth + Cloud Console
Gmail SMTP Laag App-wachtwoord alleen
Het beste voor
Gmail API SaaS-apps, CRM-, ATS-integraties
Gmail SMTP Eenvoudige scripts, persoonlijk gebruik
Voor SaaS-applicaties en ontwikkelaarstools die volledige mailboxintegratie nodig hebben, niet alleen verzenden, Gmail API e-mail verzenden is de duidelijke keuze. Als je meerdere e-mailproviders (Gmail, Outlook, IMAP) vanuit een enkele codebase moet ondersteunen, overweeg dan De unificerede e-mail-API van Unipile, het abstraheert de OAuth-complexiteit voor alle drie de providers achter één eindpunt.
Quota's

Gmail API Limieten en Quota's

Het begrijpen van de snelheidslimieten van de Gmail API is essentieel voordat je naar productie gaat. Het overschrijden van deze quota's resulteert in een 429 teVeelVerzoeken fout - implementeer altijd exponentiële backoff.

2,000
Berichten / dag
Google Workspace accounts
500
Berichten / dag
Gratis Gmail accounts (@gmail.com)
10,000
Ontvangers / dag
Over alle verzonden berichten
25 MB
Maximale berichtgrootte
Inclusief alle bijlagen
250
Quota eenheden / seconde
Per project, per gebruiker

Omgaan met fouten voor snelheidslimieten met exponentiële backoff

Wanneer de Gmail API een 429 status, wacht alvorens opnieuw te proberen. Gebruik exponentiële backoff om de API niet te overbelasten en langere blokkades te voorkomen.

Python Kopie
importeer tijd
van googleapiclient.fouten importeer HttpFout

def versturen_met_herhaalpoging(service, gebruiker_id, bericht, max_pogingen=3):
    voor poging in bereikmax_herpogingen:
        proberen:
            return service.gebruikers().berichten().verzendenuserId=user_id,
                body=message
            ).uitvoeren()
        uitzondering HttpFout als fout:
            als fout.resp.status == 429:  # Limiet bereikt
                wachttijd = (2 Poging) * 1  # exponentiële backoff: 1s, 2s, 4s
                print(f"Rate limited. Wacht {wait_time}s voor opnieuw proberen {attempt + 1}/{max_retries}...")
                tijd.slaap(wachttijd)
            anders:
                verhogen  # Niet-rate-limit fouten onmiddellijk opnieuw verhogen
    verhogen Uitzondering(f"Gmail API e-mail verzenden mislukt na {max_retries} pogingen")
Probleemoplossing

Veelvoorkomende Gmail API-fouten en hoe u ze kunt oplossen

De meeste fouten bij het verzenden van e-mails via de Gmail API vallen in drie categorieën: authenticatiefouten (401), permissieproblemen (403) en ongeldige verzoekfouten (400). Hier is een referentietabel met oorzaken en oplossingen.

HTTP-code Foutmelding Oorzaak Oplossing
401 Ongeautoriseerd Toegangstoken verlopen
Gebruik je vernieuwingstoken om een nieuwe toegangstoken te verkrijgen via oauth2.googleapis.com/token
403 Verboden Onvoldoende OAuth-scopes
Toevoegen https://www.googleapis.com/auth/gmail.send bereik en autoriseer opnieuw de gebruiker
403 rateLimitExceeded Dagelijkse limiet overschreden
Implementeer exponentiële backoff - wacht 1s, 2s, 4s tussen pogingen. Zie sectie over snelheidslimieten hierboven.
400 ongeldige_verlening Vernieuwingstoken ingetrokken of verlopen
Gebruiker moet opnieuw authenticeren en uw app opnieuw autoriseren. Start een nieuwe OAuth-autorisatiestroom.
400 Slechte aanvraag Onjuist opgemaakte MIME-bericht
Verifieer dat het bericht is gecodeerd met base64.urlsafe_b64encode() - geen standaard base64
403 onvoldoendeRechten Servicerekening mist delegatie
Schakel domeinwijde delegatie in in Google Workspace Admin en verleen Gmail API-bereiken aan het serviceaccount

Op zoek naar een uniforme oplossing? De Unipile E-mail API Gids Ondersteunt Gmail, Outlook, IMAP en meer vanuit één integratie - één eindpunt, één authenticatiestroom, drie providers.

Lees de Email API-gids
Naast Gmail, Microsoft en IMAP e-mail API's - Unipile
Voorbij Gmail

Koppel Outlook en IMAP met dezelfde API

Unipile gaat verder dan Gmail. Koppel Microsoft 365, Outlook.com en elke IMAP-mailbox via één uniforme API, met OAuth die voor u wordt afgehandeld op Microsoft en flexibele authenticatie op basis van inloggegevens voor IMAP.

Microsoft Outlook
OAuth 2.0

Microsoft Graph API

Geverifieerd
API-machtigingen Toegekend
Mail.lezen
Mail.verzenden
offline_access

Koppel Microsoft-accounts aan Unipile met OAuth. Registreer uw toepassing in Azure Active Directory, configureer Unipile met uw AAD-applicatie-ID en begin met het verzenden van e-mails via Outlook.com, Microsoft 365 en Exchange Online.

Outlook.com, Microsoft 365 en Exchange Online ondersteund
Gehoste autorisatie zodat uw gebruikers accounts koppelen zonder uw app te verlaten
Volledige ondersteuning voor AAD-configuratie van ons team tijdens de registratie
Microsoft API
IMAP
Inloggegevens Authenticatie

IMAP API

imap.example.com, 993
SSL
Verbindingsconfiguratie
gastheer: imap.provider.com
haven 993
gebruiker: michel@company.com
Account gekoppeld, synchronisatie actief

Configureer voor elke IMAP-compatibele mailbox de serverinstellingen en kies de juiste verificatiemethode binnen Unipile. Voer host, poort en inloggegevens in om een veilige verbinding tot stand te brengen., geen OAuth-stroom vereist.

Elke IMAP-provider ondersteund, iCloud, Yahoo, Proton Bridge, aangepaste servers
App-wachtwoorden en OAuth-bridge ondersteund waar beschikbaar
Veilige opslag van inloggegevens met volledige encryptie at rest
IMAP API
Eén API, elke e-mailprovider
Ondersteun Gmail, Outlook en IMAP naast elkaar zonder drie aparte integraties te hoeven onderhouden.
Ontdek de uniforme E-mail API
Gmail API E-mail Verzenden FAQ - Unipile
FAQ

Gmail API E-mail Verzenden, Veelgestelde Vragen

Antwoorden op de meestgestelde vragen over het programmatisch versturen van e-mails met de Gmail API.

01 Hoe stuur ik een e-mail met de Gmail API?
Schakel de Gmail API in de Google Cloud Console in, maak OAuth 2.0-certificeringen aan met gmail.verzenden scope, construeer een MIME-bericht, codeer het in base64url-formaat, stuur vervolgens naar gebruikers.berichten.verstuur eindpunt. Zie de Python voorbeeld en Node.js codevoorbeelden hierboven voor een complete, direct te kopiëren en te plakken implementatie.
02 Is de Gmail API gratis te gebruiken?
Ja, de Gmail API brengt geen directe kosten met zich mee. Gratis Gmail-accounts kunnen tot 500 e-mails per dag verzenden; Google Workspace-accounts krijgen er 2.000 per dag. Aanvullende quota kunnen van toepassing zijn op basis van de configuratie van uw Google Cloud-project en het aantal API-aanroepen per seconde.
03 Wat is het verschil tussen de Gmail API en SMTP?
Gmail API e-mail verzenden biedt volledige programmatische toegang tot de mailbox (threads, labels, concepten, webhooks) met OAuth 2.0-beveiliging en hogere dagelijkse limieten. SMTP ondersteunt alleen het verzenden. Voor SaaS-toepassingen die volledige inbox-integratie vereisen, is de Gmail API de juiste keuze; voor eenvoudige persoonlijke scripts kan SMTP volstaan.
04 Kan ik e-mails met bijlagen verzenden met de Gmail API?
Ja. Maak een meerdelig MIME-bericht met MIMEMultipart, bestanden bijvoegen met behulp van MIMEBasis, codeer het volledige bericht in base64url en verzend het via het Gmail API send email-eindpunt. De maximale bijlagengrootte is 25 MB per bericht. Zie het bijlagencodesvoorbeeld in de sectie hierboven.
05 Hoe kan ik e-mail verzenden namens een andere gebruiker met de Gmail API?
Voor domeinwijde delegatie configureert u een serviceaccount in de Google Cloud Console met Gmail API-bereiken, pas vervolgens userId='target@domain.com' naar gebruikers().berichten().versturen(). Voor delegatie per individuele gebruiker, zie onze volledige e-mail versturen namens gebruiker - handleiding.
06 Wat zijn de snelheidslimieten van de Gmail API?
Gratis Gmail: 500 berichten per dag. Google Workspace: 2.000 berichten per dag. Beide niveaus delen een limiet van 10.000 ontvangers per dag en een limiet van 25 MB per bericht. Implementeer exponentiële backoff om af te handelen 429 teVeelVerzoeken fouten netjes af, zie de sectie over snelheidslimieten hierboven voor een compleet codevoorbeeld.
07 Ondersteunt de Gmail API HTML-e-mails?
Ja. Gebruik MIMEMultipart('alternatief') met beide een tekst/plat reserve en een tekst/html deel. Codeer het volledige MIME-bericht in base64url-indeling voordat u het verzendt via het Gmail API send email-eindpunt. Gmail-clients geven de HTML-versie weer; andere clients vallen automatisch terug op platte tekst.
08 Hoe ga ik om met Gmail API authenticatiefouten?
401 Niet toegestaan, uw toegangstoken is verlopen: gebruik de vernieuwingstoken om een nieuwe te verkrijgen via oauth2.googleapis.com/token. 403 Verboden, ontbrekend gmail.verzenden scope: opnieuw autoriseren met de juiste scopes. 400 ongeldige_grant, vernieuwingstoken ingetrokken: de gebruiker moet uw app opnieuw authenticeren.
Een eenvoudigere weg naar e-mailintegratie nodig?
Sla provider-specifieke OAuth over, verbind Gmail, Outlook en IMAP met één API.
Praat met een expert

Dit vind je misschien ook leuk

Agenda Sync API voor SaaS: Real-Time Google & Outlook Integratie

Agenda Sync API voor SaaS: Real-Time Google & Outlook Integratie

Voor CRM, ATS, outreach-platforms en AI-gestuurde software is een betrouwbare agenda-API niet langer een nice-to-have. Het is nu een essentiële bouwsteen voor productiviteit, het boeken van workflows, follow-ups, geautomatiseerde sequenties en teamcoördinatie. Toch is het implementeren van agendasynchronisatie een...

Lees meer
De complete gids voor ontwikkelaars van agenda-API-integratie

De complete gids voor ontwikkelaars van agenda-API-integratie

Moderne software draait op verbindingen, tussen mensen, systemen en de tijd zelf. In het hart van deze connectiviteit ligt de Calendar API, een essentieel onderdeel waarmee apps naadloos kalendergebeurtenissen kunnen lezen, creëren en synchroniseren. Of je nu een CRM, rekruteringsplatform of productiviteits...

Lees meer
E-mail API: Complete Gids voor Ontwikkelaars (2026)

E-mail API: Complete Gids voor Ontwikkelaars (2026)

Het E-mail API-Landschap Drie providers dekken ruw geschat 95% van professionele e-mail wereldwijd: Gmail (en Google Workspace), Microsoft Outlook / Microsoft 365, en de universele IMAP / SMTP-protocollen voor al het andere. Begrijpen wat elk van hen biedt, en hoe ze verschillen, is de eerste...

Lees meer
nl_NLNL