Sendgrid nhiều tệp đính kèm Python
Trong phần bắt đầu nhanh này, bạn sẽ tìm hiểu cách gửi email đầu tiên của mình bằng cách sử dụng API gửi thư Twilio SendGrid và Python Show điều kiện tiên quyếtĐảm bảo thực hiện các điều kiện tiên quyết sau để hoàn thành hướng dẫn này. Bạn có thể bỏ qua nếu bạn đã hoàn thành các tác vụ này
Bỏ qua các điều kiện tiên quyết Đăng ký tài khoản SendGridKhi bạn đăng ký tài khoản SendGrid miễn phí, bạn sẽ có thể gửi mãi mãi 100 email mỗi ngày. Để có thêm tùy chọn tài khoản, hãy xem trang định giá của chúng tôi Bật xác thực hai yếu tốTwilio SendGrid yêu cầu khách hàng kích hoạt Xác thực hai yếu tố (2FA). Bạn có thể bật 2FA bằng SMS hoặc bằng ứng dụng Authy. Xem phần 2FA trong tài liệu xác thực của chúng tôi để biết hướng dẫn Tạo và lưu trữ khóa API SendGridKhông giống như tên người dùng và mật khẩu — thông tin đăng nhập cho phép truy cập vào tài khoản đầy đủ của bạn — khóa API được phép thực hiện một phạm vi hành động hạn chế. Nếu khóa API của bạn bị xâm phạm, bạn cũng có thể xoay vòng nó (xóa và tạo khóa khác) mà không thay đổi thông tin đăng nhập tài khoản khác của mình Truy cập tài liệu về Khóa API của chúng tôi để biết hướng dẫn về cách tạo khóa API và lưu trữ khóa API trong biến môi trường. Để hoàn thành hướng dẫn này, bạn có thể tạo khóa API Truy cập bị hạn chế bằng Gửi thư > Chỉ có quyền truy cập đầy đủ, thao tác này sẽ cho phép bạn gửi email và lên lịch gửi email sau. Bạn có thể chỉnh sửa các quyền được gán cho khóa API sau để hoạt động với các dịch vụ bổ sung Sau khi khóa API của bạn được gán cho một biến môi trường — bắt đầu nhanh này sử dụng 8 — bạn có thể chuyển sang bước tiếp theo
Xác minh danh tính người gửi của bạnĐể đảm bảo khách hàng của chúng tôi duy trì danh tiếng người gửi tốt nhất có thể và duy trì hành vi gửi hợp pháp, chúng tôi yêu cầu khách hàng xác minh Danh tính người gửi của họ bằng cách hoàn thành Xác thực miền. Danh tính người gửi đại diện cho địa chỉ email 'Từ' của bạn—địa chỉ mà người nhận của bạn xem là người gửi email của bạn Để bắt đầu nhanh chóng, bạn có thể bỏ qua Xác thực miền và bắt đầu bằng cách hoàn thành Xác minh một người gửi. Xác minh người gửi đơn chỉ được khuyến nghị để thử nghiệm. Một số nhà cung cấp dịch vụ email có chính sách DMARC hạn chế gửi email bằng miền của họ. Để có trải nghiệm tốt nhất, vui lòng hoàn tất Xác thực miền. Xác thực tên miền cũng được yêu cầu để nâng cấp từ tài khoản miễn phí con trănTrước khi cài đặt Python, bạn có thể xem trên máy của mình đã có phiên bản chưa Thư viện trợ giúp Twilio SendGrid Python hỗ trợ Python 2. 7, 3. 5, 3. 6, 3. 7 và 3. 8 Kiểm tra phiên bản PythonKiểm tra phiên bản Python của bạn bằng cách mở thiết bị đầu cuối (còn được gọi là dòng lệnh hoặc bảng điều khiển) và nhập lệnh sau
Nếu bạn đã cài đặt Python, thiết bị đầu cuối sẽ in một cái gì đó giống như đầu ra sau
Mặc dù thư viện trợ giúp SendGrid hỗ trợ Python trở lại phiên bản 2. 7, chúng tôi khuyên bạn nên sử dụng 3. x hiện tại Python 2 đã đạt đến trạng thái cuối vòng đời Có thể có nhiều phiên bản Python trên máy tính của bạn. Một số hệ điều hành đi kèm với phiên bản Python đã được cài đặt sẵn. Nếu bạn chạy 9 và nhận được 0 sau khi cài đặt Python 3, hãy thử chạy 1 để xem 3 nào. phiên bản x của Python mà bạn đã cài đặt. Hướng dẫn này sẽ sử dụng lệnh 2, giả sử bạn đang làm việc với Python 3. Nếu bạn chưa thiết lập Python 3 trong môi trường ảo, bạn có thể cần chạy lệnh 3 để thay thếĐể biết thêm về cách chạy nhiều phiên bản Python, hãy xem "Môi trường ảo và gói" trong tài liệu Python Cài đặt PythonNếu bạn chưa cài đặt phiên bản Python, hãy truy cập trang web Python để tải xuống và cài đặt phiên bản phù hợp với hệ điều hành của bạn Bắt đầu dự ánSử dụng thư viện trợ giúp Twilio SendGrid là cách nhanh nhất để gửi email đầu tiên của bạn Bắt đầu bằng cách tạo một thư mục dự án cho ứng dụng này. Bạn có thể đặt tên cho dự án bất cứ điều gì bạn thích. Chúng tôi sử dụng 4 trong các ví dụ sau 0Tiếp theo, điều hướng vào thư mục sg_quickstart nơi bạn sẽ hoàn thành phần còn lại của hướng dẫn 1Khởi tạo dự án của bạnTrình quản lý gói pip được bao gồm khi bạn cài đặt Python. Bạn có thể sử dụng pip để cài đặt thư viện trợ giúp Twilio SendGrid và lưu nó dưới dạng phần phụ thuộc của dự án. Nếu bạn muốn xác minh rằng pip đã được cài đặt, bạn có thể nhập thông tin sau vào thiết bị đầu cuối 2Thiết bị đầu cuối sẽ in một cái gì đó giống như đầu ra sau 3Nếu bạn chưa cài đặt phiên bản pip, bạn có thể tải xuống và cài đặt nó bằng hướng dẫn cài đặt pip trên python. tổ chức Cài đặt thư viện trợ giúpĐể cài đặt thư viện trợ giúp Twilio SendGrid, hãy nhập lệnh sau vào thiết bị đầu cuối 4Thiết bị đầu cuối sẽ in một cái gì đó như 5Cách gửi email APIBây giờ bạn đã sẵn sàng để viết một số mã. Đầu tiên, tạo một tệp trong thư mục dự án của bạn. Bạn có thể sử dụng 5Hoàn thành khối mãKhối Python sau chứa tất cả mã cần thiết để gửi thư thành công với API gửi thư SendGrid. Bạn có thể sao chép mã này, sửa đổi các biến 6 và 7 và chạy mã nếu muốn. Chúng tôi sẽ chia nhỏ từng đoạn mã này trong các phần sau 9Xây dựng lệnh gọi API của bạnLệnh gọi API của bạn phải có các thành phần sau
Trong tệp 5 của bạn, hãy nhập thư viện trình trợ giúp SendGrid. Thư viện sẽ xử lý cài đặt Máy chủ, 8, cho bạn 0Tiếp theo, sử dụng khóa API bạn đã thiết lập trước đó. Hãy nhớ rằng, khóa API được lưu trữ trong một biến môi trường, vì vậy bạn có thể sử dụng phương pháp 03 để truy cập nó. Điều này có nghĩa là chúng ta cũng cần nhập thư viện os của Python 1Gán khóa cho một biến có tên là 04 bằng cách sử dụng phương thức 05 của thư viện trợ giúp. Thư viện trợ giúp sẽ chuyển khóa của bạn tới API v3 trong tiêu đề Ủy quyền bằng cách sử dụng xác thực mã thông báo Bearer 2Bây giờ bạn đã sẵn sàng thiết lập 6, 7, 08 và nội dung thư 09. Các giá trị này được chuyển đến API trong đối tượng "cá nhân hóa" khi sử dụng API Gửi thư v3. Bạn có thể gán từng giá trị này cho các biến và thư viện SendGrid sẽ xử lý việc tạo đối tượng cá nhân hóa cho bạnĐầu tiên, nhập các lớp 10, 11, 12 và 13 của thư viện 3Với các trình trợ giúp được nhập, xác định và gán giá trị cho các biến 6, 7, 08 và 09. Chỉ định một địa chỉ email như 18 sẽ hoạt động. Tuy nhiên, các hàm tạo được nhập ở bước trước cho phép bạn truyền dữ liệu cho chúng để đảm bảo thông báo cuối cùng của bạn được định dạng đúng. Đảm bảo chỉ định 7 cho địa chỉ có hộp thư đến mà bạn có thể truy cậpLưu ý rằng trình trợ giúp 20 có hai đối số. loại nội dung và chính nội dung. Bạn có hai tùy chọn cho loại nội dung. 21 hoặc 22. Tham số thứ hai sẽ lấy văn bản thuần túy hoặc nội dung HTML mà bạn muốn gửi 4Để xây dựng thư đúng cách, hãy chuyển từng biến trước đó vào hàm tạo Thư của thư viện SendGrid. Bạn có thể gán giá trị này cho một biến có tên là 23. Sau đó, bạn có thể sử dụng phương thức 24 của hàm tạo Thư để nhận biểu diễn sẵn sàng JSON của đối tượng Thư 5Cuối cùng, bạn cần gửi yêu cầu tới SendGrid Mail Send API để gửi thư của bạn Thư viện trợ giúp sử dụng thư viện python-http-client của SendGrid để tạo URL yêu cầu bằng cách xâu chuỗi các phần của đường dẫn mong muốn của bạn. Đường dẫn đến điểm cuối SendGrid v3 Mail Send là 25. Thư viện trợ giúp đặt ứng dụng khách cho bạn, vì vậy phần 26 được xử lý bằng cách nhập 27. Các phần tiếp theo của đường dẫn là 28 và 29. Bạn có thể xâu chuỗi các từ 23 và 31 vào 32 để tạo phần còn lại của URLVới URL được tạo, python-http-client sau đó cho phép bạn xâu chuỗi loại yêu cầu HTTP mà bạn muốn thực hiện bằng một phương thức khớp với tên của động từ HTTP phù hợp với điểm cuối mong muốn của bạn. Để gửi tin nhắn, bạn nên thực hiện yêu cầu HTTP 9, vì vậy bạn có thể sử dụng 34. Phương thức 34 nhận một 36, mà bạn nên đặt thành phiên bản JSON của tin nhắn (hãy nhớ rằng phiên bản sẵn sàng cho JSON này được lưu trữ trong biến 37). Bạn có thể gán cuộc gọi đầy đủ này cho một biến có tên là 38 và in mã trạng thái phản hồi và các tiêu đề 6Với tất cả mã này, bạn có thể chạy tệp 5 của mình bằng Python để gửi email 7Nếu bạn nhận được mã trạng thái 40 được in trên bảng điều khiển, tin nhắn của bạn đã được gửi thành công. Kiểm tra hộp thư đến của địa chỉ 41 và bạn sẽ thấy tin nhắn demo của mìnhNếu bạn không thấy email, bạn có thể cần kiểm tra thư mục thư rác của mình Xử lý sự cốNếu nhận được thông báo lỗi, bạn có thể tham khảo tài liệu về thông báo phản hồi của chúng tôi để biết manh mối về những gì có thể đã sai Thông báo phản hồi APITất cả các phản hồi được trả về ở định dạng JSON. Chúng tôi chỉ định điều này bằng cách gửi tiêu đề Loại nội dung. API Web v3 cung cấp lựa chọn mã phản hồi, tiêu đề kiểu nội dung và tùy chọn phân trang để giúp bạn diễn giải các phản hồi đối với các yêu cầu API của mình Nhận hỗ trợ giới thiệu bổ sung. Tiết kiệm thời gian, nâng cao chất lượng gửi của bạn và cảm thấy tự tin rằng bạn đã sẵn sàng để đạt được thành công lâu dài với Dịch vụ triển khai SendGrid Bước tiếp theoĐây mới chỉ là khởi đầu của những gì bạn có thể làm với các API của chúng tôi. Để tìm hiểu thêm, hãy kiểm tra các tài nguyên bên dưới
đánh giá trang này 1 2 3 4 5 Cần giúp đỡ?tất cả chúng ta đôi khi làm. Nhận trợ giúp ngay bây giờ từ Nhóm hỗ trợ Twilio SendGrid Chạy vào một rào cản mã hóa? |