Zarządzanie wątkami

Z tego dokumentu dowiesz się, jak pobierać wiadomości w wątkach i dodawać wiadomości do wątków za pomocą interfejsu Gmail API.

Interfejs Gmail API używa zasobu threads do grupowania odpowiedzi na e-maile z oryginalną wiadomością w jedną rozmowę lub wątek. Dzięki temu możesz pobrać wszystkie wiadomości w rozmowie w odpowiedniej kolejności, co ułatwia uzyskanie kontekstu wiadomości lub doprecyzowanie wyników wyszukiwania.

Podobnie jak w przypadku zasobu messages, do wątków można też stosować etykiety. W przeciwieństwie jednak do wiadomości wątków nie można tworzyć – można je tylko usuwać. Wiadomości można jednak wstawiać do wątku.

Pobieranie wątków

Wątki umożliwiają pobieranie wiadomości w rozmowie w odpowiedniej kolejności. Wyświetlając listę wątków, możesz grupować wiadomości według rozmowy i podawać dodatkowy kontekst. Listę wątków możesz pobrać za pomocą metody threads.list lub pobrać konkretny wątek za pomocą metody threads.get.

Poniższy przykładowy kod pokazuje, jak używać metod threads.get i threads.list w przykładzie, który pobiera najbardziej aktywne wątki w Twojej skrzynce odbiorczej. Metoda threads.list pobiera wszystkie identyfikatory wątków, a następnie threads.get pobiera wszystkie wiadomości w każdym wątku. W przypadku wiadomości z co najmniej 3 odpowiedziami wyodrębniamy wiersz Subject i wyświetlamy niepuste wiersze oraz liczbę wiadomości w wątku.

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()

Wątki możesz też filtrować za pomocą tych samych parametrów zapytania, które są używane w przypadku messages zasobu. Jeśli jakakolwiek wiadomość w wątku pasuje do zapytania, wątek jest zwracany w wyniku.

Dodawanie wersji roboczych i wiadomości do wątków

Jeśli wysyłasz lub przenosisz wiadomości, które są odpowiedzią na innego e-maila lub częścią rozmowy, Twoja aplikacja powinna dodać tę wiadomość do powiązanego wątku. Ułatwia to użytkownikom Gmaila, którzy uczestniczą w rozmowie, zachowanie kontekstu wiadomości.

Wersję roboczą można dodać do wątku w ramach tworzenia, aktualizowania lub wysyłania wiadomości za pomocą zasobu drafts.

Możesz też dodać wiadomość do wątku w ramach wstawiania lub wysyłania wiadomości za pomocą zasobu messages.

Aby wersja robocza lub wiadomość mogła być częścią wątku, musi spełniać te kryteria:

  1. Żądany threadId musi być określony w ramach zasobu drafts.message lub messages dostarczanego w żądaniu.

  2. Nagłówki References i In-Reply-To muszą być ustawione zgodnie ze standardem RFC 2822.

  3. Nagłówki Subject muszą być takie same.

Przykłady kodu pokazujące, jak używać threadId, znajdziesz w sekcjach Tworzenie wersji roboczych i Wysyłanie wiadomości. W obu przypadkach musisz uwzględnić docelowy threadId w zasobie messages w żądaniu.