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

đ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

  1. Đăng ký tài khoản SendGrid
  2. Bật xác thực hai yếu tố
  3. Tạo và lưu trữ Khóa API SendGrid bằng Gửi thư > Quyền truy cập đầy đủ
  4. Hoàn thành xác thực tên miền
  5. Cài đặt Python

Bỏ qua các điều kiện tiên quyết

Đăng ký tài khoản SendGrid

Khi 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 SendGrid

Khô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

python --version
8 — bạn có thể chuyển sang bước tiếp theo

export SENDGRID_API_KEY=

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ăn

Trướ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 Python

Kiể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

python --version

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

Python 3.8.5

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

python --version
9 và nhận được
Python 3.8.5
0 sau khi cài đặt Python 3, hãy thử chạy
Python 3.8.5
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
Python 3.8.5
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
Python 3.8.5
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 Python

Nế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ự án

Sử 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

Python 3.8.5
4 trong các ví dụ sau

export SENDGRID_API_KEY=
0

Tiế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

export SENDGRID_API_KEY=
1

Khởi tạo dự án của bạn

Trì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

export SENDGRID_API_KEY=
2

Thiết bị đầu cuối sẽ in một cái gì đó giống như đầu ra sau

export SENDGRID_API_KEY=
3

Nế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

export SENDGRID_API_KEY=
4

Thiết bị đầu cuối sẽ in một cái gì đó như

export SENDGRID_API_KEY=
5

Cách gửi email API

Bâ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

Python 3.8.5
5

Hoà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

Python 3.8.5
6 và
Python 3.8.5
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

export SENDGRID_API_KEY=
9

Xây dựng lệnh gọi API của bạn

Lệnh gọi API của bạn phải có các thành phần sau

  • Máy chủ lưu trữ [máy chủ cho các yêu cầu API Web v3 luôn là
    Python 3.8.5
    
    8]
  • Khóa API được chuyển trong Tiêu đề ủy quyền
  • Yêu cầu [khi gửi dữ liệu tới tài nguyên qua
    Python 3.8.5
    
    9 hoặc
    export SENDGRID_API_KEY=
    
    00, bạn phải gửi nội dung yêu cầu của mình ở định dạng JSON]

Trong tệp

Python 3.8.5
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ủ,
Python 3.8.5
8, cho bạn

python --version
0

Tiế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

export SENDGRID_API_KEY=
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

python --version
1

Gán khóa cho một biến có tên là

export SENDGRID_API_KEY=
04 bằng cách sử dụng phương thức
export SENDGRID_API_KEY=
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

python --version
2

Bây giờ bạn đã sẵn sàng thiết lập

Python 3.8.5
6,
Python 3.8.5
7,
export SENDGRID_API_KEY=
08 và nội dung thư
export SENDGRID_API_KEY=
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

export SENDGRID_API_KEY=
10,
export SENDGRID_API_KEY=
11,
export SENDGRID_API_KEY=
12 và
export SENDGRID_API_KEY=
13 của thư viện

python --version
3

Với các trình trợ giúp được nhập, xác định và gán giá trị cho các biến

Python 3.8.5
6,
Python 3.8.5
7,
export SENDGRID_API_KEY=
08 và
export SENDGRID_API_KEY=
09. Chỉ định một địa chỉ email như
export SENDGRID_API_KEY=
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
Python 3.8.5
7 cho địa chỉ có hộp thư đến mà bạn có thể truy cập

Lưu ý rằng trình trợ giúp

export SENDGRID_API_KEY=
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.
export SENDGRID_API_KEY=
21 hoặc
export SENDGRID_API_KEY=
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

python --version
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à

export SENDGRID_API_KEY=
23. Sau đó, bạn có thể sử dụng phương thức
export SENDGRID_API_KEY=
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ư

python --version
5

Cuố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à

export SENDGRID_API_KEY=
25. Thư viện trợ giúp đặt ứng dụng khách cho bạn, vì vậy phần
export SENDGRID_API_KEY=
26 được xử lý bằng cách nhập
export SENDGRID_API_KEY=
27. Các phần tiếp theo của đường dẫn là
export SENDGRID_API_KEY=
28 và
export SENDGRID_API_KEY=
29. Bạn có thể xâu chuỗi các từ
export SENDGRID_API_KEY=
23 và
export SENDGRID_API_KEY=
31 vào
export SENDGRID_API_KEY=
32 để tạo phần còn lại của URL

Vớ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

Python 3.8.5
9, vì vậy bạn có thể sử dụng
export SENDGRID_API_KEY=
34. Phương thức
export SENDGRID_API_KEY=
34 nhận một
export SENDGRID_API_KEY=
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
export SENDGRID_API_KEY=
37]. Bạn có thể gán cuộc gọi đầy đủ này cho một biến có tên là
export SENDGRID_API_KEY=
38 và in mã trạng thái phản hồi và các tiêu đề

python --version
6

Với tất cả mã này, bạn có thể chạy tệp

Python 3.8.5
5 của mình bằng Python để gửi email

python --version
7

Nếu bạn nhận được mã trạng thái

export SENDGRID_API_KEY=
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ỉ
export SENDGRID_API_KEY=
41 và bạn sẽ thấy tin nhắn demo của mình

Nế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 API

Tấ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

  • Tham chiếu API
  • Gửi email với các mẫu giao dịch động
  • Bắt đầu với Webhook sự kiện
  • Nguồn cấp dữ liệu hoạt động email
  • Xác thực người gửi
  • Thư viện trợ giúp Twilio SendGrid cho Python

đá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?

Chủ Đề