Một ví dụ về việc sử dụng nâng cao Gmail đang triển khai API của nó. Trong bài viết này, tôi sẽ chia sẻ chuyên môn của nhóm nhà phát triển của chúng tôi về cách thiết lập Gmail API trong PHP
Xem các API email tốt nhất
API so với SMTP
Đầu tiên, chúng ta cần so sánh việc sử dụng API và SMTP để gửi email Gmail. Dịch vụ của Google cấp quyền truy cập vào thư bằng cách sử dụng giao thức email. Cái sau ở đây chịu trách nhiệm gửi email vì nó là giao thức email gửi đi.
MTA của Google thiết lập kết nối TCP với máy chủ SMTP và gửi email. Sau khi ủy quyền, máy chủ sẽ gửi email đến máy chủ SMTP của người nhận, máy chủ này sẽ chuyển hướng nó đến máy chủ IMAP4 hoặc POP3.
Nói chung, các API khác nhau mang lại cơ hội hợp lý hóa cho các ứng dụng, khung và mã giao tiếp với nhau. Bạn có thể tích hợp Gmail API để thiết lập kết nối giữa ứng dụng của bạn và Gmail để gửi email. Hơn nữa, HTTP có thể đủ để gửi email bằng Gmail API.
Về quyền truy cập, SMTP cung cấp quyền truy cập đầy đủ vào tài khoản bằng thông tin đăng nhập và mật khẩu xác thực SMTP của khách hàng. API Gmail sử dụng Xác thực mở [OAuth 2. 0] , cho phép bạn chỉ yêu cầu lượng truy cập bạn cần.
Điều này đặc biệt quan trọng vì khi làm việc với thư, bạn phải tính đến các hạn chế hiện có về số lượng thư được gửi, số lượng chuyển tiếp có thể, số lượng người nhận tối đa và các trình chặn khác. API Gmail có giới hạn một tỷ đơn vị hạn ngạch mỗi ngày.
Ghi chú. hãy nhớ rằng kích thước thư Gmail tối đa là 50MB không quá .
Mặt khác, ứng dụng API của bên thứ ba có thể yêu cầu quyền truy cập chỉ để gửi email [không đọc] hoặc chỉ đọc [nhưng không gửi]; .
Sử dụng gì cho PHP?
Không có gì ngạc nhiên, cả hai tùy chọn đều hợp pháp cho PHP
SMTP là một giải pháp phổ biến và dễ cấu hình để gửi email. Bạn không cần kỹ năng lập trình chuyên sâu để xử lý mọi thứ. Ngoài ra, bạn có thể hưởng lợi từ việc sử dụng Gmail mặc định, đặt dịch vụ gửi thư tùy chỉnh hoặc thậm chí sử dụng máy chủ SMTP thử nghiệm để kiểm tra email. Tuy nhiên, SMTP có thể có vấn đề về tốc độ và bảo mật
Ngược lại, Gmail API là một công cụ nhanh hơn. Nó cũng là một lựa chọn tuyệt vời để tự động hóa các quy trình và cung cấp nhiều chức năng cho người dùng. API có thêm một lớp bảo mật, điều này rất quan trọng nếu bạn đang xử lý việc gửi dữ liệu bí mật qua email
Tại sao bạn nên chọn PHP và Gmail API
Trong khi nhiều nhà phát triển chia sẻ điểm chống lại việc sử dụng PHP do tính chất mã lộn xộn của nó, thì ngôn ngữ này vẫn là một giải pháp hợp lệ
Các doanh nghiệp tiếp tục sử dụng ứng dụng web/máy tính để bàn và trang web được xây dựng trong khung công tác PHP. Ngôn ngữ này vẫn chưa chết và có nhiều chức năng đa dạng, bao gồm các tùy chọn gửi email.
Tại sao API Gmail và PHP? .
- Bạn có thể tự động gửi và nhận email HTML
- Cung cấp ID email từ lịch sử hoặc yêu cầu tìm kiếm, bạn có thể tải xuống nội dung của nó bằng cách sử dụng tin nhắn. lấy thao tác.
- Bạn có thể sao lưu toàn bộ tài khoản của mình từ đầu đến cuối. API cho phép bạn lướt qua các tin nhắn trong tài khoản của mình bằng cách sử dụng tin nhắn. danh sách phương pháp.
- Bạn có thể đồng bộ hóa hộp thư với ứng dụng của mình và thậm chí tìm hiểu về cài đặt lọc tùy chỉnh cho một loại thư cụ thể
- Bạn có thể thêm và xóa các phím tắt được áp dụng cho tin nhắn và chủ đề
- Chạy các truy vấn cụ thể, chẳng hạn như lọc, gắn nhãn hoặc xóa email
5 bước gửi email bằng PHP và Gmail API
Hãy cùng xem tổng quan các bước để làm cho ứng dụng PHP của bạn gửi email bằng Gmail API
Thiết lập dự án
- Truy cập Google Developers Console.
- Chọn “Chọn một dự án” và tạo một dự án mới. Đặt tên cho nó và nhấn nút “Tạo”
- Trên thanh bên trái, chọn “Thư viện” và chuyển đến trang Thư viện API. Tìm API Gmail và nhấp vào nó. Bật API cho dự án đã chọn
- Khi API được bật, bạn sẽ được đưa đến bảng điều khiển Thông tin xác thực. Ở đó, chọn “ID ứng dụng khách OAuth” từ danh sách thả xuống Tạo thông tin xác thực
- Sau đó, bạn sẽ thấy nút “Định cấu hình sự đồng ý”. Bằng cách nhấp vào, bạn sẽ đến trang nơi bạn có thể chỉ cần nhập tên ứng dụng của mình và chỉ định các miền được ủy quyền. Vui lòng điền vào các trường khác nếu bạn muốn
- Nhấp vào “Lưu” và chọn loại ứng dụng của bạn [Ứng dụng web, Android, Ứng dụng Chrome, iOS hoặc loại khác]. Sau đó, đặt tên cho ID ứng dụng khách OAuth của bạn. Ngoài ra, hãy nhập các nguồn JavaScript và chuyển hướng tên miền để sử dụng với các yêu cầu từ trình duyệt hoặc máy chủ web. Nhấn “Tạo” để hoàn thành
Bạn đã thiết lập dự án và bây giờ, đã đến lúc chọn hướng dẫn và thư viện API
Hướng dẫn & thư viện API
Bạn nên chọn hướng dẫn bắt đầu nhanh dựa trên khung ứng dụng
Sử dụng Bắt đầu nhanh chính thức của Google. Tại đây, ngoại trừ PHP, bạn có thể tìm thấy hướng dẫn về Java, Python và các khung phổ biến khác cũng như hướng dẫn về API iOS và Android.
Trước tiên, bạn sẽ cần phần Điều kiện tiên quyết. Trong trường hợp của PHP, hãy đảm bảo phiên bản PHP của bạn khớp với phiên bản đã cho và cài đặt Thư viện ứng dụng khách của Google dành cho PHP.
Ghi chú. tiện ích mở rộng JSON và Công cụ quản lý phụ thuộc trình soạn thảo cũng được yêu cầu
Ví dụ về API cài đặt PHP qua Composer
composer require google/apiclient:"^2.0"
Các biến thể khác cho mọi ngôn ngữ lập trình chính là .
Truy cập vào Gmail
Tại thời điểm này, bạn cần cấp quyền truy cập vào tài khoản Gmail của mình từ ứng dụng PHP. Để làm điều này, bạn cần tạo một tệp trong thư mục làm việc của mình
Directory: gmail/quickstart/ Code sample Run with: php quickstart.php
Sau đó, bạn sẽ được nhắc đăng nhập vào tài khoản Google của mình hoặc chọn một tài khoản để ủy quyền. Mẫu mã cho PHP có sẵn trong thư mục GitHub này.
Sau khi ủy quyền, API Gmail của bạn được kết nối. Đã đến lúc bạn tạo email đầu tiên của mình
Tạo một email
Ứng dụng PHP của bạn có thể sử dụng bản nháp. phương thức tạo để tạo một thông báo, bao gồm.
- Tạo tin nhắn MIME
- Chuyển đổi tin nhắn thành chuỗi mã hóa base64url
- Tạo bản nháp
Trong thực tế, quy trình cho PHP trông như thế này
/**
* @param $sender string sender email address
* @param $to string recipient email address
* @param $subject string email subject
* @param $messageText string email text
* @return Google_Service_Gmail_Message
*/
function createMessage[$sender, $to, $subject, $messageText] {
$message = new Google_Service_Gmail_Message[];
$rawMessageString = "From: \r\n";
$rawMessageString .= "To: \r\n";
$rawMessageString .= 'Subject: =?utf-8?B?' . base64_encode[$subject] . "?=\r\n";
$rawMessageString .= "MIME-Version: 1.0\r\n";
$rawMessageString .= "Content-Type: text/html; charset=utf-8\r\n";
$rawMessageString .= 'Content-Transfer-Encoding: quoted-printable' . "\r\n\r\n";
$rawMessageString .= "{$messageText}\r\n";
$rawMessage = strtr[base64_encode[$rawMessageString], array['+' => '-', '/' => '_']];
$message->setRaw[$rawMessage];
return $message;
}
/**
* @param $service Google_Service_Gmail an authorized Gmail API service instance.
* @param $user string User's email address
* @param $message Google_Service_Gmail_Message
* @return Google_Service_Gmail_Draft
*/
function createDraft[$service, $user, $message] {
$draft = new Google_Service_Gmail_Draft[];
$draft->setMessage[$message];
try {
$draft = $service->users_drafts->create[$user, $draft];
print 'Draft ID: ' . $draft->getId[];
} catch [Exception $e] {
print 'An error occurred: ' . $e->getMessage[];
}
return $draft;
}gửi email
Những gì bạn đã soạn giờ đây có thể được gửi tới người nhận bằng lệnh tin nhắn. gửi hoặc bản nháp. gửi
Kịch bản lệnh hoàn chỉnh cho PHP có hình dạng sau
/**
* @param $service Google_Service_Gmail an authorized Gmail API service instance.
* @param $userId string User's email address
* @param $message Google_Service_Gmail_Message
* @return null|Google_Service_Gmail_Message
*/
function sendMessage[$service, $userId, $message] {
try {
$message = $service->users_messages->send[$userId, $message];
print 'Message with ID: ' . $message->getId[] . ' sent.';
return $message;
} catch [Exception $e] {
print 'An error occurred: ' . $e->getMessage[];
}
return null;
}Gói [lại
API Gmail và ứng dụng PHP của bạn có thể trở thành bạn tốt khi gửi email. Sử dụng kết hợp này, bạn sẽ có thể thêm một chút bảo mật và tốc độ gửi email. Bên cạnh đó, mọi trợ giúp cần thiết từ Google đều có sẵn và bất kỳ ý thích nào cũng có thể thành hiện thực