Wysłanie e-maila przez Gmail API w 5 linijkach
npm install unipile-node-sdkUNIPILE_DSN oraz UNIPILE_TOKEN do twojego .env plik.client.email.send()account_id, do, podmiotoraz ciało. Zrobione.identyfikator_śledzenia potwierdzenie dostarczenia przez API Gmail.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_...' }
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.
# 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()
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.
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.
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.
Personalizacja
Dostosuj zawartość wiadomości e-mail dynamicznie, w oparciu o dane użytkownika lub stan aplikacji, aby zapewnić prawdziwie spersonalizowane komunikaty.
Skalowalność
Efektywnie zarządzaj masową wysyłką e-maili, idealną dla aplikacji wymagających komunikacji na dużą skalę.
Konfiguracja interfejsu API Gmaila do wysyłania wiadomości e-mail
Dokumentacja Google OAuthGoogle 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.
Dostęp do Google Developers Console
Zaloguj się do Google Developers Console Aby rozpocząć konfigurację projektu, potrzebne będzie konto Google z uprawnieniami administratora.
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 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_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.
Włącz bibliotekę Gmail API
Idź do API i usługi > Biblioteka, szukaj Gmail API, i kliknij WŁĄCZ.
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.
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.
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.
Dodaj autoryzowane domeny
- Dodaj domenę swojej aplikacji produkcyjnej (nie domenę deweloperską ani stagingową).
- Dodaj unipile.com jako druga autoryzowana domena.
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.
Dodaj wymagane zakresy
Kliknij DODAJ LUB USUŃ ZAKRESY i dodaj następujące elementy (odśwież stronę, jeśli się nie pojawią):
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.
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.
- 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.
- 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.
- 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).
- 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.
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.
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.
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.
Gmail API dla CRM, ATS, Outreach & iPaaS
Zautomatyzuj wysyłanie e-maili, synchronizuj rozmowy i scentralizuj komunikację z klientami na wszystkich platformach SaaS B2B.
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.
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.
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.
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.
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.
Lista wszystkich wiadomości e-mail
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-mailWyślij nową wiadomość
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-mailLista i Pobierz Etykiety
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ęŚledzenie Webhook
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 WebhookWszystko, 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.
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.
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.
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.
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ść.
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()
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.
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 |
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.
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.
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")
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-mailPołą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 Graph API
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.
INTERFEJS API IMAP
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.
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.
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.
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.
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.
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.
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.
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.
Możesz także polubić
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...
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...
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...


