Quản lý luồng

API Gmail sử dụng tài nguyên Thread để nhóm các thư trả lời email với thư gốc của chúng thành một cuộc trò chuyện hoặc chuỗi tin nhắn duy nhất. Nhờ đó, bạn có thể truy xuất tất cả tin nhắn trong một cuộc trò chuyện theo thứ tự, giúp bạn dễ dàng có ngữ cảnh cho một tin nhắn hoặc tinh chỉnh kết quả tìm kiếm.

Giống như tin nhắn, luồng cũng có thể được gắn nhãn. Tuy nhiên, không giống như tin nhắn, bạn không thể tạo luồng mà chỉ có thể xoá. Tuy nhiên, bạn có thể chèn tin nhắn vào một chuỗi tin nhắn.

Nội dung

Truy xuất luồng

Chuỗi tin nhắn cung cấp một cách đơn giản để truy xuất tin nhắn theo thứ tự trong một cuộc trò chuyện. Bằng cách liệt kê một nhóm chuỗi tin nhắn, bạn có thể chọn nhóm các tin nhắn theo cuộc trò chuyện và cung cấp thêm ngữ cảnh. Bạn có thể truy xuất danh sách luồng bằng phương thức threads.list hoặc truy xuất một luồng cụ thể bằng threads.get. Bạn cũng có thể lọc luồng bằng cách sử dụng các tham số truy vấn giống như đối với tài nguyên Message. Nếu bất kỳ tin nhắn nào trong một chuỗi tin nhắn khớp với truy vấn, thì chuỗi tin nhắn đó sẽ được trả về trong kết quả.

Mã mẫu bên dưới minh hoạ cách sử dụng cả hai phương thức trong một mẫu hiển thị các chuỗi tin nhắn trò chuyện nhất trong hộp thư đến của bạn. Phương thức threads.list tìm nạp tất cả mã nhận dạng chuỗi thư, sau đó threads.get sẽ lấy tất cả thư trong mỗi chuỗi thư. Đối với những chuỗi tin nhắn có từ 3 tin nhắn trả lời trở lên, chúng ta sẽ trích xuất dòng Subject và hiển thị các dòng không trống cùng với số lượng tin nhắn trong chuỗi tin nhắn. Bạn cũng sẽ thấy mã mẫu này trong video DevByte tương ứng.

Python

gmail/snippet/thread/threads.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def show_chatty_threads():
  """Display threads with long conversations(>= 3 messages)
  Return: None

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create gmail api client
    service = build("gmail", "v1", credentials=creds)

    # pylint: disable=maybe-no-member
    # pylint: disable:R1710
    threads = (
        service.users().threads().list(userId="me").execute().get("threads", [])
    )
    for thread in threads:
      tdata = (
          service.users().threads().get(userId="me", id=thread["id"]).execute()
      )
      nmsgs = len(tdata["messages"])

      # skip if <3 msgs in thread
      if nmsgs > 2:
        msg = tdata["messages"][0]["payload"]
        subject = ""
        for header in msg["headers"]:
          if header["name"] == "Subject":
            subject = header["value"]
            break
        if subject:  # skip if no Subject line
          print(f"- {subject}, {nmsgs}")
    return threads

  except HttpError as error:
    print(f"An error occurred: {error}")


if __name__ == "__main__":
  show_chatty_threads()

Thêm thư nháp và thư vào chuỗi thư

Nếu bạn đang gửi hoặc di chuyển thư là thư trả lời một email khác hoặc một phần của cuộc trò chuyện, thì ứng dụng của bạn phải thêm thư đó vào chuỗi liên quan. Điều này giúp người dùng Gmail đang tham gia cuộc trò chuyện dễ dàng giữ cho thư luôn phù hợp với ngữ cảnh.

Bạn có thể thêm thư nháp vào một chuỗi tin nhắn trong quá trình tạo, cập nhật hoặc gửi thư nháp. Bạn cũng có thể thêm tin nhắn vào một chuỗi tin nhắn trong quá trình chèn hoặc gửi tin nhắn.

Để thuộc về một chuỗi thư, thư hoặc thư nháp phải đáp ứng các tiêu chí sau:

  1. Bạn phải chỉ định threadId được yêu cầu trên Message hoặc Draft.Message mà bạn cung cấp cùng với yêu cầu.
  2. Bạn phải đặt tiêu đề References và In-Reply-To tuân thủ tiêu chuẩn RFC 2822.
  3. Các tiêu đề Subject phải khớp.

Hãy xem ví dụ về tạo bản nháp hoặc gửi thông báo. Trong cả hai trường hợp, bạn chỉ cần thêm khoá threadId được ghép nối với mã nhận dạng luồng vào siêu dữ liệu của tin nhắn, đối tượng message.