Method: users.threads.list

इससे उपयोगकर्ता के मेलबॉक्स में मौजूद थ्रेड की सूची मिलती है.

एचटीटीपी अनुरोध

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
userId

string

उपयोगकर्ता का ईमेल पता. me खास वैल्यू का इस्तेमाल, पुष्टि किए गए उपयोगकर्ता के बारे में बताने के लिए किया जा सकता है.

क्वेरी पैरामीटर

पैरामीटर
maxResults

integer (uint32 format)

ज़्यादा से ज़्यादा कितनी थ्रेड दिखानी हैं. इस फ़ील्ड की डिफ़ॉल्ट वैल्यू 100 होती है. इस फ़ील्ड के लिए ज़्यादा से ज़्यादा 500 वैल्यू सबमिट की जा सकती हैं.
pageToken

string

यह पेज टोकन, सूची में मौजूद नतीजों का कोई खास पेज वापस पाने के लिए होता है.
q

string

सिर्फ़ उन थ्रेड को दिखाओ जो दी गई क्वेरी से मेल खाती हैं. यह Gmail के खोज बॉक्स की तरह ही क्वेरी फ़ॉर्मैट के साथ काम करता है. उदाहरण के लिए, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread". gmail.metadata स्कोप का इस्तेमाल करके एपीआई को ऐक्सेस करते समय, इस पैरामीटर का इस्तेमाल नहीं किया जा सकता.
labelIds[]

string

सिर्फ़ उन थ्रेड को दिखाएं जिनमें ऐसे लेबल हों जिनके आईडी, बताए गए सभी लेबल आईडी से मेल खाते हों.
includeSpamTrash

boolean

नतीजों में SPAM और TRASH से थ्रेड शामिल करें.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
फ़ील्ड
threads[]

object (Thread)

थ्रेड की सूची. ध्यान दें कि हर थ्रेड संसाधन में messages की सूची शामिल नहीं होती. किसी थ्रेड के लिए messages की सूची को threads.get तरीके का इस्तेमाल करके फ़ेच किया जा सकता है.
nextPageToken

string

यह पेज टोकन, सूची में मौजूद नतीजों का अगला पेज पाने के लिए होता है.
resultSizeEstimate

integer (uint32 format)

नतीजों की अनुमानित कुल संख्या.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.