Gmail API Wysyłanie wiadomości e-mail: Przykłady kodu w Pythonie i Node.js (2026)

Szybki start

Wysłanie e-maila przez Gmail API w 5 linijkach

1
Zainstaluj SDK
npm install unipile-node-sdk
2
Ustaw zmienne środowiskowe
Dodaj UNIPILE_DSN oraz UNIPILE_TOKEN do twojego .env plik.
3
Połącz konto Gmail
Przepływ OAuth obsługiwany przez Unipile - odświeżanie tokena jest automatyczne, nie jest wymagane ponowne uwierzytelnianie ręczne.
4
Zadzwoń client.email.send()
Podanie account_id, do, podmiotoraz ciało. Zrobione.
5
Sprawdź odpowiedź
API zwraca identyfikator_śledzenia potwierdzenie dostarczenia przez API Gmail.
Ten sam kod dla Outlook i IMAP - jedno ujednolicone API, nie jest potrzebna logika specyficzna dla dostawcy.
prześlij-e-mail.mjs
import { UnipileClient } z 'unipile-node-sdk';const klient = nowy UnipileClient( process.env.UNIPILE_DSN, process.env.UNIPILE_TOKEN);const wynik = await client.email.wysyłaćIdentyfikator konta: 'acc_xxxxxxxxxxxxxxxx', do: [{ nazwa_wyswietlana: 'Alicja Martin', identyfikator: 'alice@acme.com'}], temat: 'Cześć z Gmail API', ciało: 'Przesłano przez Unipile!'});konsola.log(wynik); // { tracking_id: 'msg_...' }
Email wysłany - zwrócono identyfikator śledzenia
Wysyłanie wiadomości e-mail przez API Gmail - Unipile
Email API

Gmail API Wyślij e-mail,
Python i Node.js
Przykłady kodu

Kompletny przewodnik dla programistów dotyczący wysyłania wiadomości e-mail programowo za pomocą Gmail API: konfiguracja OAuth 2.0, przykłady kodu, limity przesyłu i porównanie z SMTP.

8 min czytania
Zaktualizowano czerwiec 2025
Python, Node.js
OAuth 2.0 SMTP Limity stawek Uwierzytelnianie REST API
gmail_wyslij.py
# Wyślij e-mail za pomocą Gmail API
import base64
z email.mime.text import MIMEText
z googleapiclient.discovery import budować

def wyślij_e-mail(usługa, do, temat, treść):
    msg = MIMEText(body)
    wiadomość['do']= do
    wiadomość['temat'= temat
    surowe = base64.urlsafe_b64encode(
        msg.as_bytes()
    ).decode()
    return usługi.użytkownicy().wiadomości().wysyłać(
        identyfikatorUżytkownika='ja',
        ciało={'surowy': surowy
    .execute()
✓ Wiadomość wysłana, ID: 18e3f2a9c4b...
Działa również z:
Perspektywy IMAP Kalendarz Google
przez Unipile Unified API
Tworzysz integrację poczty e-mail?

Czytaj nasze Kompletny przewodnik po API E-mail Przepływy OAuth, synchronizacja, wysyłanie i porównanie dostawców.

Czym jest Gmail API Send Email - Unipile
Gmail Gmail API

Czym jest wysyłanie wiadomości e-mail przez interfejs API Gmaila?

Wysyłanie wiadomości e-mail za pośrednictwem interfejsu API Gmail obejmuje korzystanie z żądań HTTP do interakcji z systemami zaplecza Gmail. Zamiast ręcznie komponować i wysyłać wiadomości e-mail za pośrednictwem interfejsu Gmail, programiści mogą zautomatyzować ten proces w swoich aplikacjach.

API udostępnia punkty końcowe umożliwiające deweloperom tworzenie i wysyłanie wiadomości e-mail w różnych formatach, takich jak zwykły tekst, HTML oraz wiadomości e-mail z załącznikami. Obsługuje również bardziej zaawansowane funkcje, takie jak wątkowanie i zarządzanie etykietami wiadomości e-mail, co czyni go kompleksowym rozwiązaniem do programowej komunikacji e-mailowej. W przypadku wysyłki za pośrednictwem wielu dostawców (Gmail, Outlook, IMAP) zobacz Przewodnik po ujednoliconym interfejsie API do wysyłania wiadomości e-mail. W przypadku podejścia między dostawcami przeanalizuj API do wysyłania e-maili.

Gmail michel@company.com
3 wiadomości
Wszystkie
Wysłany
Inbox
Sarah Lee
Sarah Lee
Otrzymano 9:41
Re: Załączony podpisany kontrakt
Dzięki Michel, przejrzałem wszystko i wygląda dobrze...
Michel Opra
Michel Oprado Oscara B.
Wysłany Wczoraj
Raport Q2, wersja ostateczna
Cześć Oscar, w załączeniu przesyłam finalny raport z drugiego kwartału do wglądu...
Oscar Brown
Oscar Brown
Otrzymano Mon
Nawiązanie do naszej rozmowy z zeszłego tygodnia
Cześć, chciałem zapytać o harmonogram integracji API….
Dlaczego warto używać Gmail API do wysyłania e-maili - Unipile
Kluczowe korzyści

Dlaczego warto używać Gmail API do wysyłania wiadomości e-mail?

Korzystanie z interfejsu API Gmail do wysyłania wiadomości e-mail oferuje wiele zalet, które czynią go potężnym wyborem dla nowoczesnych aplikacji.

Automatyzacja

Zautomatyzuj rutynowe zadania e-mailowe, oszczędzaj czas i zmniejsz liczbę błędów ręcznych w całym procesie pracy.

Oszczędź godziny tygodniowo

Integracja

Zintegruj wysyłanie wiadomości e-mail bezpośrednio z przepływem pracy Twojej aplikacji, usprawniając doświadczenie użytkownika dzięki płynnemu procesowi.

Rodzime UX w aplikacji

Personalizacja

Dostosuj zawartość wiadomości e-mail dynamicznie, w oparciu o dane użytkownika lub stan aplikacji, aby zapewnić prawdziwie spersonalizowane komunikaty.

Szablony dynamiczne

Skalowalność

Efektywnie zarządzaj masową wysyłką e-maili, idealną dla aplikacji wymagających komunikacji na dużą skalę.

Gotowy do masowej produkcji
Konfiguracja Gmail API, Przewodnik krok po kroku - Unipile

Konfiguracja interfejsu API Gmaila do wysyłania wiadomości e-mail

Dokumentacja Google OAuth

Google nakłada na aplikacje zewnętrzne obowiązek poddania się weryfikacji pod kątem wykorzystania danych użytkowników Google. Postępuj zgodnie z 10 kroków poniżej aby skonfigurować OAuth, włączyć interfejs Gmail API i przygotować swoje dane uwierzytelniające do produkcji. Zobacz również: zabezpieczanie integracji interfejsu API poczty e-mail.

1
2
3
4
5
6
7
8
9
10
01

Dostęp do Google Developers Console

Zaloguj się do Google Developers Console Aby rozpocząć konfigurację projektu, potrzebne będzie konto Google z uprawnieniami administratora.

02

Utwórz nowy projekt Google

Zarejestruj się na stronie Google Developers Console i albo utwórz nowy projekt, albo użyj istniejącego projektu Google. Kliknij na NOWY PROJEKT w selektorze projektu, aby rozpocząć.

Utwórz nowy projekt w Google Cloud Console
03

Utwórz dane uwierzytelniające klienta OAuth

Przejdź do Interfejsy API i usługi > Poświadczenia, a następnie kliknij UTWÓRZ POŚWIADCZENIA > Identyfikator klienta OAuth.

  • Typ aplikacji: Aplikacja internetowa
  • Imię i nazwisko: Wewnętrzna nazwa użytkownika
  • Dodaj 2 autoryzowane URI przekierowania za pomocą Twojego DSN Unipile (dostępnego w 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}}

Po utworzeniu dodaj Identyfikator klienta oraz Klucz tajny klienta do Panel Unipile > Ustawienia > Google OAuth.

Utwórz dane uwierzytelniające klienta OAuth
04

Włącz bibliotekę Gmail API

Idź do API i usługi > Biblioteka, szukaj Gmail API, i kliknij WŁĄCZ.

Włącz bibliotekę Gmail API
05

Skonfiguruj ekran zgody OAuth, typ użytkownika

Wybierz swój typ użytkownika na podstawie fazy testowania:

  • Wewnętrzne: Dostępne dla użytkowników Google Workspace w Twojej organizacji.
  • Zewnętrzne i w testach: Wymaga dodania użytkowników testowych. Tokeny wygasają po 7 dniach.

Szczegółowe informacje na temat typów użytkowników znajdziesz w Dokumentacja Google.

Wybierz typ użytkownika OAuth
06

Wypełnij informacje o aplikacji

Na ekranie zgody OAuth, podaj następujące informacje:

  • Nazwa aplikacji: Nazwa widoczna Twojej aplikacji.
  • E-mail do wsparcia technicznego: Adres e-mail kontaktowy lub lista dystrybucyjna do pytań użytkowników.
  • Logo aplikacji: Prześlij logo swojej aplikacji do identyfikacji wizualnej.
Informacje o aplikacji OAuth
07

Ustaw informacje o domenie aplikacji

  • URL strony głównej aplikacji: Prawdziwa strona główna, nie tylko strona logowania.
  • Link do Polityki Prywatności: Upewnić się, że spełnia Szczególne wymagania Google, zwłaszcza sekcję „Ograniczone Użycie”.
  • Link do Warunków Usługi: URL publicznego regulaminu.
Dziedzina aplikacji OAuth
08

Dodaj autoryzowane domeny

  • Dodaj domenę swojej aplikacji produkcyjnej (nie domenę deweloperską ani stagingową).
  • Dodaj unipile.com jako druga autoryzowana domena.
Autoryzowane Domeny
09

Podaj dane kontaktowe dewelopera

Podaj adres e-mail, którego Google może użyć do powiadomień weryfikacyjnych. Użyj listy dystrybucyjnej, aby wszyscy odpowiedni członkowie zespołu otrzymywali aktualizacje. Monitoruj ją regularnie, ponieważ wiadomości e-mail od Google mogą trafiać do folderów ze spamem.

Dane kontaktowe programisty
10

Dodaj wymagane zakresy

Kliknij DODAJ LUB USUŃ ZAKRESY i dodaj następujące elementy (odśwież stronę, jeśli się nie pojawią):

./auth/gmail.send
./auth/gmail.labels
./auth/gmail.readonly
./auth/gmail.modify

Uwaga: gmail.zmodyfikuj jest wymagane tylko wtedy, gdy musisz przenosić lub usuwać wiadomości e-mail. Jeśli go nie używasz, skontaktuj się z pomocą techniczną Unipile, aby usunąć go ręcznie z konta.

Dodaj zakresy interfejsu API Gmail
Opcjonalnie, dla aplikacji produkcyjnych
11
Wygeneruj film demonstracyjny
Wymagane tylko raz po pełnym uruchomieniu integracji w środowisku produkcyjnym

Wyprodukuj i udostępnij wideo demonstracyjne zgodne z wytycznymi Google. Prześlij je jako Film YouTube niepubliczny, dozwolone jest tylko jedno łącze do filmu.

Przed przygotowaniem wideo
  • Twoja aplikacja i przepływ OAuth są przedstawione w języku angielskim, zgodnie ze wskazówkami w dokumentacji Google.
  • Demonstracja jest przeprowadzana w domenie produkcyjnej.
  • W ustawieniach projektu Google, potwierdź Status publikacji jest "W produkcji" i Typ użytkownika zewnętrzny.
Segment uwierzytelniania
  • Wyświetl stronę główną Twojej aplikacji z pełnym adresem URL.
  • Wyjaśnij, w jaki sposób klient Google może połączyć swoje konto za pomocą oficjalnego przycisku logowania Google.
  • Podczas przepływu OAuth, zaznacz adres URL i ujawnij IDENTYFIKATOR KLIENTA.
Segment funkcjonalności
  • Sekwencyjnie wyświetlaj każde żądane uprawnienie, dostosowane do Twojego konkretnego przypadku użycia.
  • Zaprezentuj funkcję dwukierunkową, pokazując synchronizację między Twoją aplikacją a Gmail (wysyłanie, odbieranie i aktualizacje listy wysłanych wiadomości).
Kroki składania wniosku
  • Dodaj końcowe wideo do swojego Projektu Google jako niepubliczny link do filmu na YouTube.
  • Prześlij adres URL filmu na YouTube do swojego Customer Success Managera w celu weryfikacji.
  • Po ocenie, przejdź z przesłaniem weryfikacji aplikacji.

Oś czasu: weryfikacja może potrwać od 2 do 8 tygodni w zależności od kolejki Google i liczby rund naprawczych.

12
Biała lista i przegląd zabezpieczeń dla ograniczonych zakresów
Dotyczy tylko, jeśli twoja aplikacja używa ograniczonych zakresów

Jeśli Twoja aplikacja korzysta z ograniczonych zakresów, wymagane są dodatkowe kroki.

Ocena bezpieczeństwa Google

Aplikacje żądające dostępu do ograniczonych zakresów danych użytkowników Google muszą przejść ocenę bezpieczeństwa za pośrednictwem Ocena Bezpieczeństwa Aplikacji w Chmurze (CASA) program. Google zalicza Twoją aplikację do Poziomu 2 lub Poziomu 3.

Poziom 2, Skanowanie własne
Zweryfikowane w laboratorium, najczęściej. Opcja bezpłatna lub płatna za pośrednictwem zewnętrznego oceniającego.
Poziom 3, zeskanowano w laboratorium
Weryfikacja laboratoryjna, płatna. Musi zostać wykonana przez zewnętrznego rzeczoznawcę.
Coroczna ponowna ocena

Aplikacje uzyskujące dostęp do ograniczonych zakresów muszą przejść ocenę bezpieczeństwa co 12 miesięcy aby zachować dostęp. Jeśli wprowadzisz nowy ograniczony zakres, który nie był wcześniej zatwierdzony, aplikacja może wymagać ponownej oceny.

Zespół ds. recenzji Google skontaktuje się z Tobą e-mailowo. Zachowaj swoją Właściciel projektu oraz Redaktor projektu informacje aktualne w Konsoli Cloud, aby odpowiednie zespoły otrzymywały te powiadomienia.

Opcja białej listy

Jako alternatywę dla standardowego przeglądu bezpieczeństwa, możesz umieścić swoją aplikację na białej liście. Pozwala to ominąć zwykłe procedury, ale dotyczy tylko sytuacji, gdy aplikacja spełnia bardzo specyficzne kryteria:

  • Większość klientów korzysta z Google Workspace: Większość klientów powinna mieć adresy e-mail w formacie @firma.com.
  • Biała lista zainicjowana przez administratora: administratorzy Twoich użytkowników końcowych zezwalają na dostęp za pomocą ich Konsoli administracyjnej, używając Twojego Identyfikatora klienta Google.
  • Ograniczone osobiste użycie Gmaila: powinno uwierzytelnić się mniej niż 100 kont Gmail (@gmail.com).
  • Niezweryfikowane projekty mają limit 100 użytkowników w całym okresie istnienia. Konta w obszarze roboczym nie są wliczane do tego limitu, ale osobiste konta Gmail zawsze są.
  • Bezpłatni użytkownicy wersji próbnej muszą używać swojego adresu e-mail Workspace i umieścić aplikację na białej liście.

Biała lista jest obejściem problemu i może nie pasować do wszystkich zastosowań. Dokładnie oceń kryteria przed wybraniem tej ścieżki.

Zastosowania Gmail API, CRM ATS Outreach iPaaS - Unipile
Przypadki użycia

Gmail API dla CRM, ATS, Outreach & iPaaS

Zautomatyzuj wysyłanie e-maili, synchronizuj rozmowy i scentralizuj komunikację z klientami na wszystkich platformach SaaS B2B.

Systemy CRM

Rejestruj i wysyłaj e-maile bez opuszczania swojego CRM

Zautomatyzuj komunikację e-mailową, śledź interakcje i zwiększ zaangażowanie klientów. Rejestruj e-maile klientów, wysyłaj spersonalizowane wiadomości i scentralizuj wszystkie rozmowy w swojej strategii sprzedażowej.

Synchronizacja dwukierunkowa między Gmailem a rekordami kontaktów
Automatyczne logowanie wysłanych i otrzymanych wiadomości e-mail na umowę
Szablony i pola scalania do spersonalizowanej komunikacji
API poczty e-mail dla CRM
CRM Pipeline
Gmail zsynchronizowany
Możliwości
NexaTech
$32 000
2
Orbix
$18 500
Synthex
$24 200
Quark
$9,800
Gmail Gmail
LinkedIn
Zadania
Ja → Michel Opra
Cześć Michel, Proszę znaleźć załączony kontrakt. Z poważaniem.
Michał Opra
Dzień dobry Sarah, Dziękuję. W załączeniu przesyłam podpisany kontrakt. Miłego dnia.
ATS i Rekrutacja

Wysyłaj wiadomości e-mail do kandydatów z jednego, zunifikowanego skrzynki odbiorczej

Usprawnij komunikację z kandydatami, planuj rozmowy kwalifikacyjne i wysyłaj oferty pracy bezpośrednio z platformy rekrutacyjnej. Każda odpowiedź jest automatycznie dołączana do odpowiedniego profilu kandydata.

Masowe działania outreach pozyskiwanie kandydatów z zachowaniem śledzenia
Planowanie rozmów kwalifikacyjnych elektroniczne biuletyny ze zintegrowanym kalendarzem
Wątkowane rozmowy na kandydata, na stanowisko
API poczty e-mail dla ATS
Potok Kandydatów
3 wysłane dzisiaj
Źródło
Alicja K.
Ben M.
Kontakt
Clara V.
Diego S.
Wywiad
Emma R.
Zatrudniony
Feliks O.
Gmail Zaproszenie na rozmowę kwalifikacyjną, stanowisko Starszy Inżynier WYSŁANE
Cześć {{candidate.firstName}}, chcielibyśmy zaprosić Cię na 45-minutową rozmowę w przyszłym tygodniu...
Narzędzia Outreach & Sprzedaż

Moc wieloetapowych sekwencji e-maili na dużą skalę

Twórz wielokanałowe sekwencje z Gmail jako głównym silnikiem poczty e-mail. Wysyłaj spersonalizowane wiadomości, śledź otwarcia i odpowiedzi oraz uruchamiaj kolejne działania w zależności od zachowania potencjalnego klienta.

Kadencje wielostopniowe z Gmail, LinkedIn i WhatsApp
Śledzenie otwarć i odpowiedzi aby zmierzyć, co działa
Autopauza po odpowiedzi aby rozmowy były ludzkie
Interfejs API poczty e-mail dla zasięgu
Sekwencja, Założyciele SaaS Q2
Aktywny
1
Dzień 1, email wprowadzający
Wysłano do 124 potencjalnych klientów, 42 otwarcia
Gmail
2
Dzień 3, połącz się na LinkedIn
82 wysłane żądania, 31 zaakceptowanych
LinkedIn
3
Dzień 5, e-mail z przypomnieniem
Wysyłam teraz, 18 w kolejce
Gmail
124
Wysłany
34%
Wskaźnik otwarcia
12
Odpowiedzi
iPaaS i Przepływ pracy

Wykonywanie akcji Gmail w dowolnym przepływie pracy

Wbuduj możliwości wysyłania wiadomości z Gmaila w narzędziach do automatyzacji. Pozwól użytkownikom końcowym na połączenie ich kont Gmail i inicjowanie wysyłania e-maili jako część wieloetapowych przepływów pracy, bez konieczności samodzielnego tworzenia przepływu OAuth.

OAuth dla użytkownika końcowego obsłużone przez Unipile, brak pracy deweloperskiej
Wyzwalacze Webhook na nowe zdarzenia e-mail
Skala do tysięcy połączonych kont Gmail
Interfejs API poczty e-mail dla iPaaS
Kreator przepływów pracy
Bieganie
Gmail
Gmail
Unipile
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Wyzwalacz, Otrzymano nową wiadomość e-mail
Automatyczne kierowanie do działań następczych w LinkedIn
Na żywo
Kluczowe funkcje Gmail API Wyślij e-mail - Unipile
Główne punkty końcowe

Kluczowe funkcje API Gmail do wysyłania wiadomości e-mail

Pobieraj e-maile, twórz i wysyłaj nowe wiadomości, zarządzaj etykietami i otrzymuj powiadomienia webhook w czasie rzeczywistym. Cztery podstawowe funkcje obejmujące każdy przepływ pracy poczty e-mail w Twojej aplikacji.

GET

Lista wszystkich wiadomości e-mail

unipile-api
zwijać się --żądanie POBIERZ --url https://api.unipile \ .com/api/v1/poczta \ --nagłówek 'akceptuj: json'

Pobierz i wyświetl e-maile z konta Gmail użytkownika. Filtruj według folderu, daty, nadawcy lub statusu przeczytania, aby uzyskać zaawansowane wyszukiwanie i zarządzanie.

Lista funkcji poczty e-mail
POST

Wyślij nową wiadomość

unipile-api
zwijać się --żądanie POST --url https://api.unipile \ .com/api/v1/poczta \ --nagłówek 'typ-zawartości: formularz'

Programowo komponuj i wysyłaj wiadomości e-mail bezpośrednio z aplikacji. Obsługa formatu HTML, zwykłego tekstu, załączników, DW, UDW i odpowiedzi w wątkach.

Funkcja wysyłania wiadomości e-mail
GET

Lista i Pobierz Etykiety

unipile-api
zwijać się --żądanie POBIERZ --url https://api.unipile \ .com/api/v1/foldery \ --nagłówek 'akceptuj: json'

Zarządzaj etykietami i folderami Gmail, wyświetlając lub pobierając szczegółowe informacje o poszczególnych etykietach. Organizuj i kategoryzuj wiadomości e-mail, aby usprawnić przepływ pracy.

Lista i pobierz etykietę
POST

Śledzenie Webhook

unipile-api
zwijać się --żądanie POST --url https://api.unipile \ .com/api/v1/webhooks \ --nagłówek 'akceptuj: json'

Skonfiguruj webhooki, aby otrzymywać powiadomienia w czasie rzeczywistym o aktywności związanej z pocztą e-mail. Wyzwalaj natychmiastowe akcje dla nowych wiadomości, odsłon, odpowiedzi lub zwrotów.

Powiadomienie Webhook
Omówienie punktów końcowych interfejsu API Gmail - Unipile
Gmail Endpointy Gmail API

Wszystko, co możesz zrobić z interfejsem Gmail API

Pełny przegląd punktów końcowych Gmail dostępnych za pośrednictwem Unipile, od połączenia konta po śledzenie webhooków.

Połączenie z kontem
2 punkty końcowe
Uwierzytelnianie hostowane, uwierzytelnianie poczty e-mail w białej etykiecie
POST
Użyj własnego ekranu zgody OAuth aplikacji
POST
Wyślij i odbierz
5 punkty końcowe
Wyślij e-mail, z załącznikami, DW, UDW
POST
Odpowiedz na e-mail, zachowując kontekst wątku
POST
Wyświetl wszystkie e-maile, z filtrami i paginacją
GET
Pobierz konkretny email po identyfikatorze
GET
Pobierz załączniki z wiadomości e-mail
GET
Organizacja i etykiety
5 punkty końcowe
Wykaz folderów i etykiet
GET
Pobierz szczegóły folderu lub etykiety
GET
Przenieś wiadomość e-mail do innego folderu
PATCH
Aktualizuj e-mail, oznacz jako przeczytany, nieprzeczytany, oznaczony gwiazdką
PATCH
Usuń e-mail na stałe lub do kosza
USUŃ
Webhooki i śledzenie
3 wydarzenia
Nowe zdarzenie: otrzymano e-mail
POST
Zdarzenie wysłania wiadomości e-mail, śledzenie odpowiedzi
POST
Śledzenie zdarzeń otwarcia i kliknięcia
POST

Jak wysłać e-mail za pomocą Gmail API

Przykłady wysyłania zwykłego tekstu, HTML i wiadomości e-mail z załącznikami za pośrednictwem Gmail API w językach Python i Node.js. Gotowe do kopiowania i wklejania, z uwzględnieniem uwierzytelniania OAuth 2.0.

1 Wyślij e-mail w formacie zwykłego tekstu (Python)

Użyj oficjalnej google-api-python-client oraz Google-Uwierzytelnianie bibliotek. Funkcja konstruuje wiadomość MIME, koduje ją do formatu base64url i wysyła do punktu końcowego Gmail API służącego do wysyłania wiadomości.

Python Kopia
import base64
z email.mime.text import MIMEText
z google.oauth2.credentials import Poświadczenia
z googleapiclient.discovery import budować

def wyślij_e-mail(do, temat, treść, credentials_dict):
    creds = Poświadczenia(**credentials_dict)
    usługa = budować('gmail', 'v1', poświadczenia=poświadczenia)

    wiadomość = MIMETextwiadomość['do'] = do
    wiadomość['temat'] = przedmiot

    raw = baza64.urlsafe_b64encode(wiadomość.as_bytes()).dekoduj()

    wynik = usługa.użytkownicy().wiadomości().wysyłać(
        userId='ja',
        body={'surowy': surowy}
    ).wykonaj()

    print(f"Wiadomość wysłana. ID: {result['id']}")
    return wynik

# Użycie
wyślij_e-mail(
    do='recipient@example.com',Temat='Cześć z Gmail API',
    treść='Ten e-mail został wysłany za pośrednictwem interfejsu API Gmail do wysyłania wiadomości e-mail.',
    credentials_dict={
        'token': 'TWÓJ_TOKEN_DOSTĘPU',
        'token odświeżający': 'TWÓJ_TOKEN_ODŚWIEŻANIA',
        'id_klienta': 'TWÓJ_IDENTYFIKATOR_KLIENTA',
        'client_secret': 'TWÓJ_SEKRETNY_KLIENT',
        'token_uri': 'https://oauth2.googleapis.com/token'
    }
)

2 Wyślij prosty e-mail tekstowy (Node.js)

Użyj googleapis pakiet npm. Wiadomość jest skonstruowana jako surowy ciąg znaków RFC 2822, zakodowana w base64url i wysłana za pośrednictwem Gmail API.

Node.js Kopia
const { google } = require('googleapis');

async function wyślijEmail(autoryzacja, do, temat, treść) {
  const gmail = google.gmail({ wersja: 'v1', auth });

  const wiadomość = [
    `Do: ${to}`,
    Temat: ${temat},
    '',
    treść
  ].połącz('\n');

  const wiadomoscZenkodowana = Bufor.z(wiadomość) .toString('base64')
    .wymienić(/\+/g, '-')
    .wymienić(/\//g, '_')
    .wymienić(/=+$/, '');

  const wynik = czekać gmail.users.messages.wysyłać{
    identyfikatorUzytkownika: 'ja',
    requestBody: { raw: encodedMessage }
  });

  console.log(Wiadomość wysłana. ID: ${result.data.id});
  return wynik.dane;
}

// Konfiguracja OAuth2
const oauth2Klient = nowy google.auth.OAuth2(
  'TWÓJ_IDENTYFIKATOR_KLIENTA',
  'TWÓJ_SEKRETNY_KLIENT',
  'TWÓJ_URI_PRZEKIEROWANIA'
);

oauth2Client.ustawPoświadczenia{
  token_ dostępu: 'TWÓJ_TOKEN_DOSTĘPU',
  refresh_token: 'TWÓJ_TOKEN_ODŚWIEŻANIA'
});

wyślijEmail(oauth2Klient, 'recipient@example.com', 'Cześć', 'Wysłano przez Gmail API wysyłanie wiadomości e-mail!');

3 Wyślij e-mail w formacie HTML (Python)

Użycie MIMEMultipart('alternatywny') z oboma tekst/zwykły awaryjne i a tekst/html klienty Gmail będą renderować wersję HTML, pozostałe klienty powrócą do tekstu zwykłego.

Python Kopia
z email.mime.multipart import MIMEMultipart
z email.mime.text import MIMEText
import base64

def wyslij_email_html(usługa, do, temat, treść_html):
    wiadomość = MIMEMultipart('alternatywny')
    wiadomość['do'] = do
    wiadomość['temat'= temat

    # Tekst zwykły - wersja zapasowa
    część_tekstu MIMEText('Proszę wyświetlić tę wiadomość e-mail w kliencie poczty obsługującym format HTML.', 'zwykły')
    # wersja HTML
    html_część = MIMEText(treść_html, 'html')

    wiadomość.dołączyćwiadomość.dołączyćraw = base64.urlsafe_b64encode(wiadomość.as_bytes()).dekoduj()

    return serwis.użytkownicy().wiadomości().wysyłać(
        userId='ja',
        body={'surowy': surowy}
    ).wykonaj()

# Użycie
html_content = """

  
    

Cześć!

Ten e-mail został wysłany z Gmail API wysyłanie wiadomości e-mail.

"""
wyslij_email_htmlusługa, 'to@example.com', 'HTML Email przez Gmail API', html_content)

4 Wyślij e-mail z załącznikami (Python)

Dołącz dowolny typ pliku, odczytując jego bajty, zgadując typ MIME i dołączając go do MIMEMultipart Maksymalny rozmiar załącznika to 25 MB na wiadomość.

Python Kopia
import base64
import mimetypes
z email.mime.multipart import MIMEMultipart
z email.mime.text import MIMEText
z email.mime.base import MIMEBase
z e-mail import enkodery

def wyslij_maila_z_zalacznikiemwiadomość = MIMEMultipart()
    wiadomość['do'] = do
    wiadomość['temat'] = temat
    wiadomość.dołączyć(MIMETextciało, 'zwykły'))

    # Wykryj typ MIME i dołącz plik
    typ_zawartości, kodowanie = mimetypes.zgadnij_typ(ścieżka_pliku)
    typ_główny, typ_podrzędny = typ_zawartości.podzielić('/', 1)

    z otwórz(ścieżka_pliku, 'rb') jako f:
        załącznik = MIMEBase(typ_główny, typ_podrzędny)
        załącznik.ustaw_ładunekf.czytaj()
        enkodery.zakoduj_base64załącznik.dodaj nagłówek(
            'Content-Disposition',
            f'attachment; filename="{nazwa_pliku_z_pełnej_ścieżki}""
        )
        wiadomość.dołączyćsurowy = base64.urlsafe_b64encode(wiadomość.as_bytes()).dekoduj()

    return serwis.użytkownicy().wiadomości().wysyłać(
        userId='ja',
        body={'surowy': surowy}
    ).wykonaj()
Pomiń złożoność OAuth
Jedno API do Gmail, Outlook i IMAP

API Email Unipile pozwala wysyłać e-maile z kont Gmail, Outlook i IMAP za pomocą jednego ujednoliconego punktu końcowego — nie jest wymagana specyficzna konfiguracja OAuth dla poszczególnych dostawców. Połącz konta w minuty, a nie dni.

Zacznij budować za darmo
Gmail Perspektywy IMAP Gmail, Outlook, IMAP
Porównanie Gmail API i SMTP - Unipile
Porównanie

Gmail API vs SMTP, Którego powinieneś użyć?

Zarówno Gmail API, jak i Gmail SMTP pozwalają na programowe wysyłanie wiadomości e-mail, ale służą bardzo różnym celom. Oto bezpośrednie porównanie, które pomoże Ci dokonać wyboru.

Cecha Gmail API Gmail SMTP
Uwierzytelnianie OAuth 2.0 Hasło aplikacji lub OAuth
Dzienne ograniczenie wysyłania 2,000 Przestrzeń robocza, 500 darmowy 500/dzień darmowy Gmail
Załączniki Do 25 MB Do 25 MB
E-maile HTML Tak Tak
Śledzenie wątków Etykiety i wątki Nie
Przeczytaj paragony Tak Nie
Dostęp programowy Pełne, wyszukiwanie, etykiety, wersje robocze, webhooki Wyślij tylko
Złożoność konfiguracji Wysoki OAuth + Konsola Google Cloud Niski Hasło aplikacji tylko
Najlepszy dla Aplikacje SaaS, CRM, integracja ATS Proste skrypty, użytek osobisty
Porównanie funkcji
Uwierzytelnianie
Gmail API OAuth 2.0
Gmail SMTP Hasło aplikacji lub OAuth
Dzienne ograniczenie wysyłania
Gmail API 2000 Miejsc pracy, 500 za darmo
Gmail SMTP 500/dzień darmowego Gmail
Załączniki
Gmail API Do 25 MB
Gmail SMTP Do 25 MB
E-maile HTML
Gmail API Tak
Gmail SMTP Tak
Śledzenie wątków
Gmail API Etykiety i wątki
Gmail SMTP Nie
Przeczytaj paragony
Gmail API Tak
Gmail SMTP Nie
Dostęp programowy
Gmail API Pełne, wyszukiwanie, etykiety, wersje robocze, webhooki
Gmail SMTP Wyślij tylko
Złożoność konfiguracji
Gmail API Wysoki OAuth + Konsola Google Cloud
Gmail SMTP Niski Hasło aplikacji tylko
Najlepszy dla
Gmail API Aplikacje SaaS, CRM, integracja ATS
Gmail SMTP Proste skrypty, użytek osobisty
Dla aplikacji SaaS i narzędzi dla deweloperów, które potrzebują pełnej integracji skrzynki pocztowej, a nie tylko wysyłania, Gmail API wysyłanie e-maili to jasny wybór. Jeśli musisz obsługiwać wielu dostawców poczty e-mail (Gmail, Outlook, IMAP) z jednej bazy kodu, rozważ Zunifikowane API e-mailowe firmy Unipile, abstrakcjonuje złożoność OAuth dla wszystkich trzech dostawców za jednym punktem końcowym.
Limity

Limity i kwoty Gmail API

Zrozumienie limitów wykorzystania Gmail API jest kluczowe przed przejściem do produkcji. Przekroczenie tych limitów zwraca z 429 limitUdostępnianiaPrzekroczony błąd - zawsze implementuj wykładnicze wycofywanie.

2,000
Wiadomości / dzień
Konta Google Workspace
500
Wiadomości / dzień
Bezpłatne konta Gmail (@gmail.com)
10,000
Odbiorcy / dzień
We wszystkich wysłanych wiadomościach
25 MB
Maksymalny rozmiar wiadomości
W tym wszystkie załączniki
250
Jednostki limitu / sekunda
Za projekt, za użytkownika

Obsługa błędów związane z limitami żądań z wykładniczym opóźnieniem

Gdy interfejs API Gmail zwraca 429 status, poczekaj przed ponowną próbą. Użyj wykładniczego wycofywania, aby uniknąć przeciążania API i wyzwalania dłuższych blokad.

Python Kopia
import czas
z googleapiclient.errors import Błąd HTTP

def wyślij_z_ponowieniem(usługa, identyfikator_użytkownika, wiadomość, maks_ponowienia=3):
    dla próba w zakres(maks_ponowienia):
        próbuj:
            return serwis.użytkownicy().wiadomości().wysyłać(
                userId=user_id,
                body=wiadomosc
            ).wykonaj()
        oprócz Błąd HTTP jako błąd:
            jeśli błąd.odp.status == 429:  # Limit żądania
                czas_oczekiwania = (2 próba) * 1  # Wykładnicze wycofywanie: 1s, 2s, 4s
                print(f"Osiągnięto limit żądań. Poczekaj {wait_time} s przed ponowieniem próby {attempt + 1}/{max_retries}..."czas.sen(czas_oczekiwania)
            inaczej:
                wzrastać  # Ponownie podnieś błędy nieobjęte limitem żądań natychmiast
    wzrastać Wyjątek(f"Nie udało się wysłać wiadomości przez Gmail API po {max_retries} ponowieniach")
Rozwiązywanie problemów

Najczęstsze błędy Gmail API i jak je naprawić

Większość błędów wysyłania e-maili przez Gmail API można podzielić na trzy kategorie: błędy uwierzytelniania (401), problemy z uprawnieniami (403) i błędy niepoprawnego żądania (400). Oto tabela referencyjna z przyczynami i rozwiązaniami.

Kod HTTP Komunikat o błędzie Przyczyna Rozwiązanie
401 Nieautoryzowany Token dostępu wygasł
Użyj swojego token_odświeżający aby uzyskać nowy token dostępu poprzez oauth2.googleapis.com/token
403 Zakazane Niewystarczające zakresy OAuth
Dodaj https://www.googleapis.com/auth/gmail.send zakres i ponowne autoryzuj użytkownika
403 Przekroczono limit żądań Dzienny limit został przekroczony
Wdróż wykładnicze wycofywanie się - poczekaj 1s, 2s, 4s pomiędzy ponownymi próbami. Zobacz sekcję limitów żądań powyżej.
400 nieprawidłowe_poświadczenie Token odświeżania został unieważniony lub wygasł
Użytkownik musi ponownie uwierzytelnić i autoryzować Twoją aplikację. Uruchom nowy przepływ zgody OAuth.
400 Błąd żądania Niepoprawna wiadomość MIME
Zweryfikuj, czy wiadomość jest zakodowana za pomocą base64.urlsafe_b64encode() - nie standardowy base64
403 niewystarczające uprawnienia Brak delegacji konta usługi
Włącz delegowanie na poziomie domeny w Google Workspace Admin i nadaj uprawnienia zakresów Gmail API dla konta usługi

Szukasz zunifikowanego rozwiązania? Przewodnik po Unipile Email API obsługuje Gmail, Outlook, IMAP i inne z jednej integracji - jeden punkt końcowy, jeden przepływ uwierzytelniania, trzech dostawców.

Przeczytaj Przewodnik po interfejsie API wiadomości e-mail
Poza Gmail, Microsoft i IMAP Email APIs - Unipile
Poza Gmailem

Połącz Outlook i IMAP z tym samym API

Unipile wykracza poza Gmail. Połącz Microsoft 365, Outlook.com i dowolną skrzynkę pocztową IMAP za pomocą jednego, ujednoliconego API, z obsługą OAuth dla Microsoft i elastycznym uwierzytelnianiem opartym na danych uwierzytelniających dla IMAP.

Microsoft Outlook
OAuth 2.0

Microsoft Graph API

Potwierdzony
Uprawnienia API Udzielono
Mail.Read
Mail.Send
dostęp offline

Połącz konta Microsoft z Unipile za pomocą OAuth. Zarejestruj swoją aplikację w Usługi Azure Active Directory, Skonfiguruj Unipile z identyfikatorem aplikacji AAD i zacznij wysyłać wiadomości e-mail za pośrednictwem Outlook.com, Microsoft 365 i Exchange Online.

Outlook.com, Microsoft 365 i Exchange Online obsługiwane
Hosted Auth więc Twoi użytkownicy łączą konta bez opuszczania Twojej aplikacji
Pełne wsparcie w konfiguracji AAD z naszego zespołu podczas rejestracji
Microsoft API
IMAP
Uwierzytelnianie poświadczeń

INTERFEJS API IMAP

imap.example.com, 993
SSL
Konfiguracja połączenia
Gospodarz: imap.provider.com
port 993
użytkownik: michel@company.com
Konto połączone, synchronizacja aktywna

Dla każdej skrzynki pocztowej zgodnej z IMAP, skonfiguruj ustawienia serwera i wybierz odpowiednią metodę uwierzytelniania w Unipile. Wprowadź hosta, port i dane uwierzytelniające, aby nawiązać bezpieczne połączenie, nie wymaga przepływu OAuth.

Każdy dostawca IMAP obsługiwane, iCloud, Yahoo, Proton Bridge, serwery niestandardowe
Hasła aplikacji i mostek OAuth wspierane tam, gdzie to możliwe
Bezpieczne przechowywanie danych uwierzytelniających z pełnym szyfrowaniem danych w spoczynku
INTERFEJS API IMAP
Jedno API, każdy dostawca poczty
Obsługuj Gmaila, Outlooka i IMAP-a jednocześnie bez konieczności utrzymywania trzech oddzielnych integracji.
Odkryj zunifikowane API poczty e-mail
Gmail API Wyślij e-mail — często zadawane pytania — Unipile
FAQ

Gmail API wysyłanie wiadomości e-mail, Często zadawane pytania

Odpowiedzi na najczęściej zadawane pytania dotyczące wysyłania e-maili programowo za pomocą interfejsu Gmail API.

01 Jak wysłać e-mail za pomocą Gmail API?
Włącz interfejs API Gmail w Google Cloud Console, utwórz dane uwierzytelniające OAuth 2.0 z gmail.wyślij zakres, skonstruuj komunikat MIME, zakoduj go w formacie base64url, a następnie POST do uzytkownicy.wiadomosci.wyslij punkt końcowy. Zobacz Przykład Pythona i powyższe przykłady kodu Node.js dla kompletnej implementacji, gotowej do skopiowania i wklejenia.
02 Czy Gmail API jest darmowy w użyciu?
Tak, API Gmail nie generuje bezpośrednich kosztów. Darmowe konta Gmail mogą wysyłać do 500 e-maili dziennie; konta Google Workspace otrzymują 2000 dziennie. Dodatkowe limity mogą obowiązywać w zależności od konfiguracji projektu Google Cloud i liczby wywołań API na sekundę.
03 Jaka jest różnica między API Gmail a SMTP?
API Gmail umożliwia pełny programistyczny dostęp do skrzynki pocztowej (wątki, etykiety, wersje robocze, webhooki) z zabezpieczeniami OAuth 2.0 i wyższymi limitami dziennymi. SMTP obsługuje jedynie wysyłanie. W przypadku aplikacji SaaS wymagających pełnej integracji z pocztą, API Gmail jest właściwym wyborem; w przypadku prostych skryptów osobistych, SMTP może wystarczyć.
04 Czy mogę wysyłać wiadomości e-mail z załącznikami za pomocą Gmail API?
Tak. Utwórz wieloczęściową wiadomość MIME z MIMEMultipart, dołącz pliki, używając MIMEBase, zakoduj całą wiadomość w base64url i wyślij za pomocą punktu końcowego Gmail API wysyłania wiadomości e-mail. Maksymalny rozmiar załącznika to 25 MB na wiadomość. Zobacz przykład kodu załączników w sekcji powyżej.
05 Jak wysłać e-mail w imieniu innego użytkownika za pomocą Gmail API?
W przypadku delegowania w całej domenie skonfiguruj konto usługi w Google Cloud Console z uprawnieniami API Gmail, a następnie przekaż userId='target@domain.com' do users().messages().send(). Aby uzyskać informacje o delegowaniu uprawnień dla poszczególnych użytkowników, zobacz nasz kompletny instrukcja wysyłania e-maili w imieniu użytkownika.
06 Jakie są limity użycia Gmail API?
Darmowy Gmail: 500 wiadomości dziennie. Google Workspace: 2000 wiadomości dziennie. Oba plany dzielą limit 10 000 odbiorców dziennie i limit rozmiaru 25 MB na wiadomość. Zaimplementuj wykładnicze ponawianie w celu obsługi 429 limitUdostępnianiaPrzekroczony obsługuje błędy w sposób elegancki, pełny przykład kodu znajduje się w sekcji limitów żądań powyżej.
07 Czy API Gmail obsługuje wiadomości e-mail w formacie HTML?
Tak. Użycie MIMEMultipart('alternatywny') z oboma tekst/zwykły awaryjne i a tekst/html Część. Zakoduj całą wiadomość MIME w formacie base64url przed wysłaniem przez punkt końcowy wysyłania wiadomości e-mail Gmail API. Klienty Gmail renderują wersję HTML; inne klienty automatycznie wracają do zwykłego tekstu.
08 Jak obsługiwać błędy uwierzytelniania Gmail API?
401 Nieautoryzowany, twój token dostępowy wygasł: użyj token_odświeżający aby uzyskać nowy przez oauth2.googleapis.com/token. 403 Zabroniono, brak gmail.wyślij zakres: ponowne uwierzytelnienie z poprawnymi zakresami. 400 nieważny_udzielony, odświeżający token unieważniony: użytkownik musi ponownie uwierzytelnić Twoją aplikację od zera.
Potrzebujesz prostszej ścieżki do integracji poczty e-mail?
Pomiń specyficzne dla dostawcy OAuth, połącz Gmail, Outlook i IMAP za pomocą jednego API.
Porozmawiaj z ekspertem

Możesz także polubić

API synchronizacji kalendarza dla SaaS: Integracja z Google i Outlookiem w czasie rzeczywistym

API synchronizacji kalendarza dla SaaS: Integracja z Google i Outlookiem w czasie rzeczywistym

W przypadku CRM, ATS, platform zasięgowych i oprogramowania opartego na sztucznej inteligencji, niezawodny interfejs API kalendarza nie jest już miłym dodatkiem. Jest to obecnie niezbędny element, który napędza produktywność, przepływy pracy rezerwacji, działania następcze, zautomatyzowane sekwencje i koordynację zespołu. Jednak wdrożenie synchronizacji kalendarza jest jednym...

czytaj dalej
Kompletny przewodnik programisty po integracji API kalendarza

Kompletny przewodnik programisty po integracji API kalendarza

Nowoczesne oprogramowanie działa w oparciu o połączenia między ludźmi, systemami i samym czasem. W samym sercu tej łączności znajduje się interfejs API kalendarza, niezbędny komponent umożliwiający aplikacjom płynne odczytywanie, tworzenie i synchronizowanie wydarzeń kalendarza. Niezależnie od tego, czy budujesz CRM, platformę rekrutacyjną, czy...

czytaj dalej
API pocztowe: Kompletny przewodnik dla deweloperów (2026)

API pocztowe: Kompletny przewodnik dla deweloperów (2026)

Krajobraz dostawców API e-mail Trzech dostawców obsługuje około 95% profesjonalnych usług e-mail na świecie: Gmail (i Google Workspace), Microsoft Outlook / Microsoft 365 oraz uniwersalne protokoły IMAP / SMTP dla wszystkiego innego. Zrozumienie, co oferuje każdy z nich i czym się różnią, to pierwszy...

czytaj dalej
pl_PLPL