Interfejs Gmail API używa zasobów Thread
do grupowania odpowiedzi e-mail z pierwotną wiadomością w 1 wątek lub w jednym wątku. Dzięki temu możesz pobrać wszystkie wiadomości w wątku w określonej kolejności, co ułatwia znalezienie kontekstu wiadomości i zawężenie wyników wyszukiwania.
Wątki mogą mieć etykiety, podobnie jak wiadomości. Wątków nie można jednak tworzyć, a jedynie usuwać. Wiadomości można jednak wstawiać do wątku.
Spis treści
Pobieram wątki
Wątki zapewniają prosty sposób pobierania wiadomości w wątku w określonej kolejności.
Wyświetlając listę wątków, możesz pogrupować wiadomości według wątku i podać dodatkowy kontekst. Listę wątków możesz pobrać przy użyciu metody threads.list
lub określony wątek za pomocą threads.get
. Możesz też filtrować wątki, korzystając z tych samych parametrów zapytania co w przypadku zasobu Message
. Jeśli jakakolwiek wiadomość w wątku pasuje do zapytania, jest on zwracany w wyniku.
Przykładowy kod poniżej pokazuje, jak użyć obu metod w przykładzie, który wyświetla w skrzynce odbiorczej najwięcej rozmów z największą liczbą wątków. 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 tych, które mają co najmniej 3 odpowiedzi, wyodrębniamy wiersz Subject
i wyświetlamy wszystkie niepuste odpowiedzi oraz liczbę wiadomości w wątku. Przykładowy kod znajdziesz w odpowiednim filmie dotyczącym DevByte.
Python
dodawanie wersji roboczych i wiadomości do wątków,
Jeśli wysyłasz lub przenosisz wiadomości będące odpowiedzią na inny e-mail lub część wątku, aplikacja powinna dodać tę wiadomość do powiązanego wątku. Dzięki temu użytkownicy Gmaila, którzy biorą udział w wątku, mogą łatwiej zachować kontekst wiadomości.
Wersja robocza można dodać do wątku podczas tworzenia, aktualizowania lub wysyłania wersji roboczej wiadomości. Możesz też dodać wiadomość do wątku podczas wstawiania lub wysyłania wiadomości.
Aby wiadomość lub wersja robocza została uwzględniona w wątku, musi spełniać te kryteria:
threadId
musi być określony wMessage
lubDraft.Message
w przesłanym żądaniu.- Nagłówki
References
iIn-Reply-To
muszą być ustawione zgodnie ze standardem RFC 2822. - Nagłówki
Subject
muszą być takie same.
Zobacz przykłady tworzenia wersji roboczej i wysyłania wiadomości. W obu przypadkach wystarczy dodać klucz threadId
z identyfikatorem wątku do metadanych wiadomości – obiektu message
.