थ्रेड मैनेज करना

इस दस्तावेज़ में, Gmail API का इस्तेमाल करके, थ्रेड में मौजूद मैसेज वापस पाने और थ्रेड में मैसेज जोड़ने का तरीका बताया गया है.

Gmail API, threads संसाधन का इस्तेमाल करके, ईमेल के जवाबों को उनके ओरिजनल मैसेज के साथ एक ही बातचीत या थ्रेड में ग्रुप करता है. इससे, बातचीत में मौजूद सभी मैसेज क्रम से वापस पाए जा सकते हैं. इससे किसी मैसेज का कॉन्टेक्स्ट समझना या खोज के नतीजों को बेहतर बनाना आसान हो जाता है.

messages संसाधन की तरह, थ्रेड पर भी लेबल लागू किए जा सकते हैं. हालांकि, मैसेज के उलट, थ्रेड बनाए नहीं जा सकते. इन्हें सिर्फ़ मिटाया जा सकता है. हालांकि, मैसेज को किसी थ्रेड में जोड़ा जा सकता है.

थ्रेड वापस पाना

थ्रेड की मदद से, बातचीत में मौजूद मैसेज क्रम से वापस पाए जा सकते हैं. थ्रेड की सूची बनाकर, मैसेज को बातचीत के हिसाब से ग्रुप किया जा सकता है और ज़्यादा कॉन्टेक्स्ट दिया जा सकता है. threads.list तरीके का इस्तेमाल करके, थ्रेड की सूची वापस पाई जा सकती है. इसके अलावा, threads.get तरीके का इस्तेमाल करके, कोई खास थ्रेड वापस पाया जा सकता है.

यहां दिए गए कोड सैंपल में, threads.get और threads.list तरीकों का इस्तेमाल करने का तरीका दिखाया गया है. इस सैंपल में, आपके इनबॉक्स में सबसे ज़्यादा बातचीत वाले थ्रेड वापस पाए जाते हैं. threads.list तरीका, सभी थ्रेड आईडी फ़ेच करता है. इसके बाद, threads.get हर थ्रेड में मौजूद सभी मैसेज को वापस लाता है. तीन या उससे ज़्यादा जवाब वाले मैसेज के लिए, हम Subject लाइन को एक्सट्रैक्ट करते हैं और खाली न होने वाली लाइनों के साथ-साथ, थ्रेड में मौजूद मैसेज की संख्या दिखाते हैं.

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

थ्रेड को फ़िल्टर करने के लिए, वही क्वेरी पैरामीटर इस्तेमाल किए जा सकते हैं जो messages संसाधन के लिए इस्तेमाल किए जाते हैं. अगर किसी थ्रेड में मौजूद कोई मैसेज, क्वेरी से मेल खाता है, तो वह थ्रेड नतीजों में दिखता है.

थ्रेड में ड्राफ़्ट और मैसेज जोड़ना

अगर ऐसे मैसेज भेजे या माइग्रेट किए जा रहे हैं जो किसी दूसरे ईमेल का जवाब हैं या किसी बातचीत का हिस्सा हैं, तो आपके ऐप्लिकेशन को उस मैसेज को संबंधित थ्रेड में जोड़ना चाहिए. इससे, बातचीत में शामिल Gmail इस्तेमाल करने वाले लोगों को मैसेज का कॉन्टेक्स्ट समझने में आसानी होती है.

ड्राफ़्ट को किसी थ्रेड में जोड़ा जा सकता है. ऐसा मैसेज बनाते, अपडेट करते या भेजते समय किया जा सकता है. इसके लिए, drafts संसाधन का इस्तेमाल किया जाता है.

मैसेज जोड़ते या भेजते समय, किसी मैसेज को थ्रेड में जोड़ा जा सकता है. इसके लिए, messages संसाधन का इस्तेमाल करें.

किसी ड्राफ़्ट या मैसेज को थ्रेड में शामिल करने के लिए, इन शर्तों को पूरा करना ज़रूरी है:

1. अनुरोध में दिए गए drafts.message या messages संसाधन में, अनुरोध किया गया threadId शामिल होना चाहिए.

2. References और In-Reply-To हेडर, RFC 2822 स्टैंडर्ड के मुताबिक सेट होने चाहिए.

3. Subject हेडर मेल खाने चाहिए.

threadId का इस्तेमाल करने के तरीके के बारे में कोड सैंपल देखने के लिए, ड्राफ़्ट बनाना या मैसेज भेजना लेख पढ़ें. दोनों ही मामलों में, आपको अपने अनुरोध के messages संसाधन में, टारगेट threadId शामिल करना होगा.

मिलते-जुलते विषय

• ईमेल मैसेज बनाना और भेजना
• पुष्टि करने और अनुमति देने से जुड़ी समस्याओं को हल करना