Tài liệu này giải thích cách gọi phương thức messages.list của Gmail API.
Phương thức này trả về một mảng các đối tượng messages của Gmail chứa id và threadId của thư. Để truy xuất thông tin chi tiết đầy đủ về thông báo, hãy sử dụng phương thức messages.get.
Các đối tượng messages được trả về sẽ xuất hiện theo thứ tự thời gian đảo ngược (mới nhất xếp trước).
Điều kiện tiên quyết
Python
Một dự án trên đám mây của Google Cloud đã bật API Gmail. Để xem các bước, hãy hoàn tất hướng dẫn nhanh về API Gmail bằng Python.
Liệt kê thông báo
Phương thức messages.list hỗ trợ một số tham số truy vấn để lọc các thông báo:
maxResults: Số lượng thông báo tối đa cần trả về (mặc định là 100, tối đa là 500).pageToken: Mã thông báo để truy xuất một trang kết quả cụ thể.q: Chuỗi truy vấn để lọc thông báo, chẳng hạn nhưfrom:someuser@example.com is:unread.labelIds: Chỉ trả về những thư có nhãn trùng khớp với tất cả mã nhận dạng nhãn đã chỉ định.includeSpamTrash: Kết quả bao gồm thư từSPAMvàTRASH.
Mã mẫu
Python
Mẫu mã sau đây cho thấy cách liệt kê thư cho người dùng Gmail đã xác thực. Mã này xử lý việc phân trang để truy xuất tất cả các thông báo khớp với truy vấn.
Phương thức messages.list trả về một nội dung phản hồi chứa những nội dung sau:
messages[]: Một mảng gồm các tài nguyênMessage.nextPageToken: Đối với các yêu cầu có nhiều trang kết quả, mã thông báo này có thể được dùng với các lệnh gọi tiếp theo để liệt kê thêm tin nhắn.resultSizeEstimate: Tổng số kết quả ước tính.
Để tìm nạp nội dung và siêu dữ liệu đầy đủ của thông báo, hãy sử dụng trường message.id để gọi phương thức messages.get.