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 के थ्रेड शामिल करें.

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

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

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

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

जेएसओएन के काेड में दिखाना
{
  "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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.